train-ticket-query

star 15

火车票查询:查询车次时刻表、站站余票及票价信息。适用于出行规划、车票信息展示、列车站点查询等场景。

qq5855144 By qq5855144 schedule Updated 5/30/2026

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

三个接口简介

  1. 车次查询/train/line):根据车次号查询列车全程站点时刻表,包括各站到达/发车时间、停靠时长、运行里程及各席位价格。
  2. 余票查询/train/ticket):根据出发站、到达站和日期,查询当日所有车次的余票数量及发到时间。
  3. 站站查询/train/station2s):查询两站之间的所有车次列表,含运行时长、里程及票价,支持按高铁筛选。

生成期用法(Agent 直接调用)

三个接口均使用相同的认证方式,详细参数、响应结构及完整代码见对应 references 文件。

通用认证模式(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 文件:

Install via CLI
npx skills add https://github.com/qq5855144/GitHubM --skill train-ticket-query
Repository Details
star Stars 15
call_split Forks 3
navigation Branch main
article Path SKILL.md
More from Creator