简介
本文介绍火车相关内容的查询，包括火车票余票、火车票价格、火车时刻、火车车次、火车车站等信息。和12306同步。
集成火车相关的API，可以实现将火车相关查询功能集成到自己的系统中。下面介绍火车相关的API。
API介绍
火车查询包括两个接口：
- 火车票查询：根据出发站和到达站，查询火车票信息。
- 过站停留信息查询: 根据车次，查询车辆过站停留信息。
详细说明请参阅此处
火车票查询
请求参数
| 名称 | 类型 | 必须 | 说明 |
|---|---|---|---|
| start | String | 是 | 出发站，如：杭州东 |
| end | String | 是 | 到达站，如：上海南 |
| ishigh | String | 否 | 是否高铁，0：不是，1：是 |
| date | String | 否 | 日期，格式yyyy-MM-dd。默认为当天 |
返回样例
{
"code": 200,//返回码，详见返回码说明
"msg": "成功",//返回码对应描述
"charge": true,//计费标志
"taskNo": "040056972246718444474454",//本次请求号
"data": {
"date": "2025-07-25",//日期
"start": "杭州东",//出发站
"end": "上海南",//查询到达站
"list": [
{
"terminalstation_code": "IMH",//到达站code，可用于查询过站停留信息
"is_start": "过",//是否始发[始/过]
"costtime": "01时51分",//用时
"terminalstation": "上海松江",//到达站
"departstation_code": "XHH",//出发站code，可用于查询过站停留信息
"is_end": "过",//是否终点[过/终]
"trainno": "K528",//车次
"type": "快速",//类型
"departuretime": "01:55",//出发时间
"sequenceno": 1,//顺序
"departstation": "杭州南",//出发站
"trainno_uuid": "650000K52805",//车次uuid
"station": "广州白云",//始发站
"arrivaltime": "03:46",//到达时间
"endstation": "南京",//终点站
"yz": {
//硬座
"price": "24.0",//票价(--:无席位)
"num": "有" //余票(有:充足,无:无票,--:无席位)
},
"wz": {
//无座
"price": "24.0",
"num": "有"
},
"rw": {
//软卧
"size": {
"xp_price": 114.5,
"sp_price": 108.5
},
"price": "108.0",
"num": "1"
},
"ze": {
//二等座
"price": "--",
"num": "--"
},
"swz": {
//商务座
"price": "--",
"num": "--"
},
"yw": {
//硬卧
"size": {
"xp_price": 78.5,
"zp_price": 75.5,
"sp_price": 70.5
},
"price": "70.0",
"num": "8"
},
"zy": {
//一等座
"price": "--",
"num": "--"
}
},...
]
}
}
过站停留信息查询
请求参数
| 名称 | 类型 | 必须 | 说明 |
|---|---|---|---|
| trainnoUuid | String | 是 | 车次uuid，火车票查询接口返回 |
| departstationCode | String | 是 | 出发站Code，火车票查询接口返回 |
| terminalstationCode | String | 是 | 到达站Code，火车票查询接口返回 |
| date | String | 是 | 乘车日期，格式yyyy-MM-dd |
返回样例
{
"code": 200,//返回码，详见返回码说明
"msg": "成功",//返回码对应描述
"charge": true,//计费标志
"taskNo": "040056972246718444474454",//本次请求号
"data": {
"train_class_name": "快速",//火车类型
"start_station_name": "昆明",//始发站名称
"service_type": "有空调",//服务内容
"station_train_code": "K80",//车次代码
"end_station_name": "上海松江",//终点站名称
"list": [
{
"station_name": "昆明",//到站站点名称
"isChina": "1",//是否国内站
"start_time": "18:45",//出发时间
"isEnabled": false,//是否启用(到达站范围内)
"station_no": "01",//站序
"stopover_time": "----",//站内停留时间
"arrive_time": "----" //到站时间
},
...
]
}
}
