接口文档
请求示例
返回示例
在线调试
请求地址示例
请求参数
根据传入位置,将参数放入 Query、Body 或 Header。
| 参数名 | 可传值说明 | 传入位置 | 是否必填 | 示例值 | 默认值 | 参数说明 |
|---|---|---|---|---|---|---|
from | from | query | 必填 | 北京 | — | 必填,出发地:城市名 / 车站名 / 拼音 / 电报码 |
to | to | query | 必填 | 上海 | — | 必填,到达地:城市名 / 车站名 / 拼音 / 电报码 |
date | date | query | 可选 | 2026-11-20 | — | 可选,出发日期 YYYY-MM-DD,默认明天,仅限预售期 15 天内 |
type | type | query | 可选 | G,D | — | 可选,车次类型过滤,G/D/Z/T/K,逗号分隔 |
only_available | only_available | query | 可选 | 1 | 0 | 可选,传 1 只返回有余票车次 |
train | train | query | 可选 | G1,G3 | — | 可选,只查指定车次,逗号分隔 |
depart_from | depart_from | query | 可选 | 08:00 | — | 可选,出发时段起,HH:MM |
depart_to | depart_to | query | 可选 | 12:00 | — | 可选,出发时段止,HH:MM |
sort | sort | query | 可选 | duration | start | 可选,排序:start / arrive / duration / price |
limit | limit | query | 可选 | 20 | 200 | 可选,返回条数上限,默认 200,最大 500 |
fresh | fresh | query | 可选 | 1 | 0 | 可选,传 1 跳过 60 秒缓存 |
action | action | query | 可选 | stations | — | 可选,传 stations 查询车站字典 |
keyword | keyword | query | 可选 | 上海虹桥 | — | action=stations 时使用,车站名或拼音,留空返回城市列表 |