# Train Ticket Query

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

- Skill: `qq5855144/train-ticket-query` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add qq5855144/train-ticket-query`
- Raw SKILL.md: https://api.skillmd.com/api/skills/qq5855144/train-ticket-query/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- License: MIT
- Author: qq5855144 (https://skillmd.com/u/qq5855144)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/qq5855144/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)