接口文档
请求示例
返回示例
在线调试
请求地址示例
请求参数
根据传入位置,将参数放入 Query、Body 或 Header。
| 参数名 | 可传值说明 | 传入位置 | 是否必填 | 示例值 | 默认值 | 参数说明 |
|---|---|---|---|---|---|---|
action | screen | query | 必填 | screen | — | 接口动作:screen 车站大屏、station 站名模糊匹配、tickets 12306余票 |
station | 北京南 | query | 必填 | 北京南 | — | 车站名,action=screen 时必填;支持中文名、拼音、电报码模糊匹配 |
type | all | query | 可选 | all | depart | 大屏类型:depart 出发、arrive 到达、all 全部;action=screen 使用,默认 depart |
limit | 80 | query | 可选 | 80 | 80 | 返回条数上限 1-300,默认 80 |
only_active | 1 | query | 可选 | 1 | — | 传 1 时过滤已停止检票的车次,仅保留正在检票/候车/正点车次 |
keyword | 北京 | query | 可选 | 北京 | — | 站名关键词,action=station 时必填 |
from | 北京南 | query | 可选 | 北京南 | — | 出发站,action=tickets 时必填,支持模糊匹配 |
to | 上海 | query | 可选 | 上海 | — | 到达站,action=tickets 时必填,支持模糊匹配 |
date | 2026-11-15 | query | 可选 | 2026-11-15 | — | 乘车日期 YYYY-MM-DD,默认今天,仅支持今天起 15 天内 |
purpose | ADULT | query | 可选 | ADULT | ADULT | 票种:ADULT 成人、0X00 学生;默认 ADULT |
cookie | <12306 cookie> | query | 可选 | — | — | 可选 12306 登录 Cookie,余票接口被风控加密时可提高解析成功率 |