接口简介:
火车车次经停站点查询,调用该接口必须先调用火车票余票信息查询接口,根据余票查询接口返回的数据来查询车次经停站点。可作为余票查询的补充查询。
请求地址:
https://cn.apihz.cn/api/12306/api3.php
请求方式:
POST或GET。
请求参数:
【名称】【参数】【必填】【说明】
【用户ID】【id】【是】【用户中心的数字ID,例:id=10000000】
【用户KEY】【key】【是】【用户中心通讯秘钥,例:key=15he5h15ty854j5sr152hs2】
【车次编号】【train_order】【是】【车次编号,查询余票接口返回的车次唯一编号。例:train_order=76000G328609】
【cookie】【ck】【否】【不传该参数则使用平台提供的cookie,如果多次查询失败可能是平台cookie失效,可传自己的cookie,参照图片教程:https://down.erguanmingmin.com/api/img/12306ck.png,浏览器访问12306官网,打开调试模式,然后任意查询火车票,找到该链接https://kyfw.12306.cn/otn/leftTicket/queryU,取cookie里面的JSESSIONID值,只需传等号后面的字符串即可。ck=0EC5DA0C04CB6793F9C293EBF28B485B】
返回参数:
【名称】【参数】【说明】
【状态码】【code】【200成功,400错误。普通用户采用接口本地线路调用,成功率无保障。彩钻和炫钻用户采用本地+代理双模式调用,成功率超高。查询成功后的信息有60秒缓存期。】
【提示信息】【msg】【提示信息】
【车次编号】【train_order】【车次唯一编号】
【数据集】【data】【数据集】
【车次号】【data.station_train_code】【车次号,第一站字段】
【速度类型】【data.train_class_name】【列车速度类型,第一站字段】
【始发站名称】【data.start_station_name】【始发站名称,第一站字段】
【终点站名称】【data.end_station_name】【终点站名称,第一站字段】
【未知字段】【data.service_type】【可能是空调车字段,第一站字段】
【站点序号】【data.station_no】【站点序号】
【当前站名】【data.station_name】【当前站名】
【到达时间】【data.arrive_time】【到达时间】
【发车时间】【data.start_time】【发车时间】
【停靠时长】【data.stopover_time】【停靠时长】
【是否国内站】【data.isChina】【是否国内站】
【国家代码】【data.country_code】【国家代码】
【国家名称】【data.country_name】【国家名称】
【未知字段】【data.isEnabled】【未知字段】
GET请求示例:
https://cn.apihz.cn/api/12306/api3.php?id=88888888&key=88888888&y=2025&m=6&d=30&train_order=76000G328609&ck=
注意:示例里的ID与KEY为公共ID与KEY,共享每分钟调用频次限制,接口本身免费,请使用自己的ID与KEY,独享每分钟调用频次。每日调用无上限。
POST请求示例:
请根据开发语言自行POST。
返回数据示例:
示例:{"code":400,"msg":"通讯秘钥错误。"}
示例:
{
"code": 200,
"train_order": "76000G328609",
"datas": [{
"station_name": "成都东",
"train_class_name": "高速",
"isChina": "1",
"service_type": "2",
"end_station_name": "上海虹桥",
"stopover_time": "----",
"country_code": "",
"isEnabled": false,
"country_name": "",
"arrive_time": "----",
"start_station_name": "成都东",
"station_train_code": "G3286",
"start_time": "07:41",
"station_no": "01"
}, {
"arrive_time": "07:52",
"station_name": "新都东",
"isChina": "1",
"start_time": "07:54",
"stopover_time": "2分钟",
"station_no": "02",
"country_code": "",
"country_name": "",
"isEnabled": false
}, {
"arrive_time": "08:11",
"station_name": "德阳",
"isChina": "1",
"start_time": "08:13",
"stopover_time": "2分钟",
"station_no": "03",
"country_code": "",
"country_name": "",
"isEnabled": false
}, {
"arrive_time": "08:30",
"station_name": "绵阳",
"isChina": "1",
"start_time": "08:32",
"stopover_time": "2分钟",
"station_no": "04",
"country_code": "",
"country_name": "",
"isEnabled": false
}, {
"arrive_time": "09:22",
"station_name": "广元",
"isChina": "1",
"start_time": "09:28",
"stopover_time": "6分钟",
"station_no": "05",
"country_code": "",
"country_name": "",
"isEnabled": false
}, {
"arrive_time": "10:14",
"station_name": "汉中",
"isChina": "1",
"start_time": "10:16",
"stopover_time": "2分钟",
"station_no": "06",
"country_code": "",
"country_name": "",
"isEnabled": false
}, {
"arrive_time": "11:11",
"station_name": "鄠邑",
"isChina": "1",
"start_time": "11:13",
"stopover_time": "2分钟",
"station_no": "07",
"country_code": "",
"country_name": "",
"isEnabled": false
}, {
"arrive_time": "11:34",
"station_name": "西安北",
"isChina": "1",
"start_time": "11:40",
"stopover_time": "6分钟",
"station_no": "08",
"country_code": "",
"country_name": "",
"isEnabled": false
}, {
"arrive_time": "12:08",
"station_name": "华山北",
"isChina": "1",
"start_time": "12:11",
"stopover_time": "3分钟",
"station_no": "09",
"country_code": "",
"country_name": "",
"isEnabled": false
}, {
"arrive_time": "13:04",
"station_name": "洛阳龙门",
"isChina": "1",
"start_time": "13:06",
"stopover_time": "2分钟",
"station_no": "10",
"country_code": "",
"country_name": "",
"isEnabled": false
}, {
"arrive_time": "13:44",
"station_name": "郑州东",
"isChina": "1",
"start_time": "13:55",
"stopover_time": "11分钟",
"station_no": "11",
"country_code": "",
"country_name": "",
"isEnabled": false
}, {
"arrive_time": "14:45",
"station_name": "商丘",
"isChina": "1",
"start_time": "14:53",
"stopover_time": "8分钟",
"station_no": "12",
"country_code": "",
"country_name": "",
"isEnabled": false
}, {
"arrive_time": "15:11",
"station_name": "砀山南",
"isChina": "1",
"start_time": "15:13",
"stopover_time": "2分钟",
"station_no": "13",
"country_code": "",
"country_name": "",
"isEnabled": false
}, {
"arrive_time": "15:31",
"station_name": "萧县北",
"isChina": "1",
"start_time": "15:33",
"stopover_time": "2分钟",
"station_no": "14",
"country_code": "",
"country_name": "",
"isEnabled": false
}, {
"arrive_time": "15:50",
"station_name": "徐州东",
"isChina": "1",
"start_time": "15:53",
"stopover_time": "3分钟",
"station_no": "15",
"country_code": "",
"country_name": "",
"isEnabled": false
}, {
"arrive_time": "16:26",
"station_name": "宿迁",
"isChina": "1",
"start_time": "16:28",
"stopover_time": "2分钟",
"station_no": "16",
"country_code": "",
"country_name": "",
"isEnabled": false
}, {
"arrive_time": "16:56",
"station_name": "淮安东",
"isChina": "1",
"start_time": "16:58",
"stopover_time": "2分钟",
"station_no": "17",
"country_code": "",
"country_name": "",
"isEnabled": false
}, {
"arrive_time": "17:19",
"station_name": "建湖",
"isChina": "1",
"start_time": "17:21",
"stopover_time": "2分钟",
"station_no": "18",
"country_code": "",
"country_name": "",
"isEnabled": false
}, {
"arrive_time": "17:36",
"station_name": "盐城",
"isChina": "1",
"start_time": "17:38",
"stopover_time": "2分钟",
"station_no": "19",
"country_code": "",
"country_name": "",
"isEnabled": false
}, {
"arrive_time": "18:04",
"station_name": "海安",
"isChina": "1",
"start_time": "18:06",
"stopover_time": "2分钟",
"station_no": "20",
"country_code": "",
"country_name": "",
"isEnabled": false
}, {
"arrive_time": "18:35",
"station_name": "张家港",
"isChina": "1",
"start_time": "18:37",
"stopover_time": "2分钟",
"station_no": "21",
"country_code": "",
"country_name": "",
"isEnabled": false
}, {
"arrive_time": "18:47",
"station_name": "常熟",
"isChina": "1",
"start_time": "18:49",
"stopover_time": "2分钟",
"station_no": "22",
"country_code": "",
"country_name": "",
"isEnabled": false
}, {
"arrive_time": "19:07",
"station_name": "太仓",
"isChina": "1",
"start_time": "19:09",
"stopover_time": "2分钟",
"station_no": "23",
"country_code": "",
"country_name": "",
"isEnabled": false
}, {
"arrive_time": "19:42",
"station_name": "上海虹桥",
"isChina": "1",
"start_time": "19:42",
"stopover_time": "----",
"station_no": "24",
"country_code": "",
"country_name": "",
"isEnabled": false
}]
}
参考资料(版权):
https://www.apihz.cn/api/12306api3.html