train-ticket-query

## 能力概述 本 skill 基于极速数据火车票 API，提供三个核心查询能力： | 能力 | 接口 | 方法 | API ID | |------|------|------|--------| | 车次查询 | `POST https://app-bo4w33bsdqm9-api-DLEO73l7Vjwa-gateway.appmiaoda.com/train/line` | POST | `api-DLEO73l7Vjwa` | | 余票查询 | `POST https://app-bo4w33bsdqm9-api-DLEO73lBPZ2a-gateway.appmiaoda.com/train/ticket` | POST | `api-DLEO73lBPZ2a` | | 站站查询 | `POST https://app-bo4w33bsdqm9-api-V9PworyO6gEa-gateway.appmiaoda.com/train/station2s` | POST | `api-V9PworyO6gEa` | - **认证方式**：平台托管（`platform_managed`），密钥由平台注入 - **响应格式**：JSON，`status=0` 表示成功 - **适用平台**：Web、MiniProgram ### 三个接口简介 1. **车次查询**（`/train/line`）：根据车次号查询列车全程站点时刻表，包括各站到达/发车时间、停靠时长、运行里程及各席位价格。 2. **余票查询**（`/train/ticket`）：根据出发站、到达站和日期，查询当日所有车次的余票数量及发到时间。 3. **站站查询**（`/train/station2s`）：查询两站之间的所有车次列表，含运行时长、里程及票价，支持按高铁筛选。 --- ## 生成期用法（Agent 直接调用） 三个接口均使用相同的认证方式，详细参数、响应结构及完整代码见对应 references 文件。 - 车次查询：详见 [references/train-line-api.md](references/train-line-api.md) - 余票查询：详见 [references/train-ticket-api.md](references/train-ticket-api.md) - 站站查询：详见 [references/train-station2s-api.md](references/train-station2s-api.md) **通用认证模式（platform_managed）：** ```typescript const apiKey = process.env["INTEGRATIONS_API_KEY"]!; // 密钥由平台注入，不可硬编码 // 所有接口均以 POST + query params 形式调用，Body 为空 const response = await fetch("https://<api_id>@app-bo4w33bsdqm9-api-DLEO73l7Vjwa-gateway.appmiaoda.com<path>?<params>", { method: "POST", headers: { "Content-Type": "application/json;charset=UTF-8", "X-Gateway-Authorization": `Bearer ${apiKey}`, }, }); if (!response.ok) throw new Error(`HTTP error: ${response.status}`); const json = await response.json(); if (json.status !== 0) throw new Error(`API error: ${json.msg}`); ``` --- ## 生成后用法（应用内通过 Edge Function 调用） 每个接口对应一个独立的 Edge Function，前端通过 Supabase client 调用。平台密钥仅在服务端读取，不暴露至前端。 | 接口 | Edge Function 名称 | 前端调用示例 | |------|-------------------|-------------| | 车次查询 | `train-line` | `supabase.functions.invoke("train-line", { body: { trainno, date } })` | | 余票查询 | `train-ticket` | `supabase.functions.invoke("train-ticket", { body: { start, end, date } })` | | 站站查询 | `train-station2s` | `supabase.functions.invoke("train-station2s", { body: { start, end, ishigh, date } })` | 完整 Edge Function 及前端代码详见各 references 文件： - 车次查询：[references/train-line-api.md](references/train-line-api.md) - 余票查询：[references/train-ticket-api.md](references/train-ticket-api.md) - 站站查询：[references/train-station2s-api.md](references/train-station2s-api.md)