接口调用地址
线路类型一 [普通集群负载-IP接口]
说明：直接访问 https://api.apihz.cn/getapi.php 获取当前最优IP接口地址。由普通负载集群服务器组成，通过IP接口地址调用，如果单个服务器过载可自行切换IP接口地址尝试其他负载服务器。IP并非永久固定且容易遭受攻击，平台可能不定期更换。
线路类型二 [普通集群负载-域名接口]
说明：域名接口会自动分发请求到普通集群服务器均衡负载，该域名TTL值为60秒，表示你的请求会每60秒实现自动轮换负载服务器，但也可能因你的网络服务商存在DNS缓存造成短时间内无法自动切换负载。如果某个负载服务器出现故障，也可能会造成个别地区存在一定时间的故障期。
线路类型三 [VIP集群负载-VIP线路接口]
说明：VIP专线在普通集群组的基础上额外增加独享大带宽集群组，每次请求自动均衡负载，自动故障切换，抗攻击，全球智能CDN加速。超高稳定性！最低30¥/月，彩钻以上会员专属，登录后购买。注：VIP线路是指调用接口的线路更有保障以及每分钟拥有更高的调用频次等，并非收费接口包月使用。
请求示例
[GET]请求示例：(请登录后使用自己的KEY独享频次)
复制参数
复制全部
[POST]请求示例：(请根据开发语言自行POST，参考【GET/POST教程】，或下载【超级客户端】调试。)
请求参数说明
注意：请求编码为UTF8，否则带中文请求可能失败。一般参数不能带+号，会被自动替换为空格。参数内容较大的必须用POST，不能GET。
提示：如发现接口有BUG，可加服务QQ群及时向我们反馈。
提示：请求参数里的开发者ID与KEY，登录后台菜单【个人资料】里查看。
提示：如发现接口有BUG，可加服务QQ群及时向我们反馈。
提示：请求参数里的开发者ID与KEY，登录后台菜单【个人资料】里查看。
| 名称 | 参数 | 必填 | 说明 |
|---|---|---|---|
| 开发者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 |
| 动态秘钥 | dkey | 否 | 开发者开启动态秘钥验证后需传此参数，主要针对直接在客户端调用接口的场景。请在官网后台菜单【个人资料】里配置。例：dkey=0cd2a494831736587c33f30d1e544371 |
| 用户IP | uip | 否 | 接口调用者IP，用于后台统计IP地域分布，ISP运营商，时段IP数统计等，如不传该参数则默认为接口请求端IP，该参数主要用于使用后端服务器/中间件请求接口的方式使用。例：uip=123.123.123.123。该参数彩钻/炫钻/焱钻会员专享。 |
返回参数说明
| 名称 | 参数 | 说明 |
|---|---|---|
| 状态码 | 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 | 未知字段 |
返回数据示例
示例：{"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
}]
}
更新记录
