介绍
# IDFM Journey (PRIM/Navitia)
使用附带的脚本调用 PRIM/Navitia 端点，无需额外依赖。
## 前置条件 / 安全
- **必需密钥：**`IDFM_PRIM_API_KEY`（请将其视为机密信息；不要提交它）。 - **限定范围：**仅在运行该命令的 shell/会话中设置它。 - **不要覆盖 `--base-url`**，除非你完全信任该端点。 脚本会向提供的任何 base URL 发送 `apikey: <IDFM_PRIM_API_KEY>`，因此恶意 URL 可能会窃取你的密钥。
## 快速命令
可在任意位置运行（路径位于 skill 文件夹内）：
- 解析地点（最佳匹配 + 列表）： - `python3 scripts/idfm.py places "Ivry-sur-Seine" --count 5`
- 行程（自由文本 from/to；先解析地点 id）： - `python3 scripts/idfm.py journeys --from "Ivry-sur-Seine" --to "Boulainvilliers" --count 3`
- 事件 / 扰乱（按线路 id 或过滤器）： - `python3 scripts/idfm.py incidents --line-id line:IDFM:C01727` - `python3 scripts/idfm.py incidents --filter 'disruption.status=active'`
添加 `--json` 以打印原始 API 输出。
## 注意事项
- 如果地点解析有歧义，请增加 `--count` 并选择正确的 `stop_area` id。 - 有关 API 详细信息和示例，请阅读：`references/idfm-prim.md`。