name: train-ticket-query description: 火车票查询:查询车次时刻表、站站余票及票价信息。适用于出行规划、车票信息展示、列车站点查询等场景。 license: MIT
能力概述
本 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
三个接口简介
- 车次查询(
/train/line):根据车次号查询列车全程站点时刻表,包括各站到达/发车时间、停靠时长、运行里程及各席位价格。 - 余票查询(
/train/ticket):根据出发站、到达站和日期,查询当日所有车次的余票数量及发到时间。 - 站站查询(
/train/station2s):查询两站之间的所有车次列表,含运行时长、里程及票价,支持按高铁筛选。
生成期用法(Agent 直接调用)
三个接口均使用相同的认证方式,详细参数、响应结构及完整代码见对应 references 文件。
- 车次查询:详见 references/train-line-api.md
- 余票查询:详见 references/train-ticket-api.md
- 站站查询:详见 references/train-station2s-api.md
通用认证模式(platform_managed):
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 文件: