接口线路类型一[集群IP接口]
[接口地址1] :当前负载【】 接口通讯【正常

复制

测速 

[接口地址2] :当前负载【】 接口通讯【正常

复制

测速 

[接口地址3] :当前负载【】 接口通讯【正常

复制

测速 

说明:直接访问https://api.apihz.cn/getapi.php获取当前最优接口地址,IP接口省去域名解析步骤,速度较快。集群IP接口并非永久有效,且容易遭受攻击,建议定期获取当前最优IP接口地址做容错处理,或直接使用域名接口或彩钻接口。IP直链接口CC防火墙严格。
接口线路类型二[域名接口]
[接口地址] :[自动分发到集群接口服务器,但可能因网络运营商DNS缓存如果某个集群节点发生故障会造成个别地区有1天左右的故障期。CC防火墙适中。]

复制

测速 

接口线路类型三[VIP线路超高稳定-最低24¥/月]
[VIP线路] :[专属集群+普通集群+备用集群,自动负载均衡,自动故障切换,抗攻击,全球智能CDN加速。超高稳定性!CC防火墙宽松。登录后购买。注:VIP线路是指调用接口的线路更有保障以及更高的调用频次限制等,并非收费接口包月使用。]

复制

测速 

请求示例
[GET]请求示例:(以下为公共KEY,共享每分钟调用频次,请登录后使用自己的KEY独享频次)

复制全部

复制参数 

[POST]请求示例:(请根据开发语言自行POST,参考【GET/POST教程】。)

请求参数说明
注意:请求编码为UTF8,否则带中文请求可能失败。一般参数不能带+号,会被自动替换为空格。参数内容较大的必须用POST,不能GET。
提示:如发现接口有BUG,可加服务QQ群500700444,及时向我们反馈。
提示:请求参数里的开发者ID与KEY,登录后台菜单【个人资料】里查看。
名称 参数 必填 说明
开发者IDid用户中心的数字ID,例:id=10000000
开发者KEYkey用户中心通讯秘钥,例:key=15he5h15ty854j5sr152hs2
出发站点add出发地或出发车站名称,例:add=绵阳
目的站点end目的地或目的车站名称,例:end=上海
出发日期-年y不超过预售时间,一般为15天内,出发日期-年,例:y=2025
出发日期-月m不超过预售时间,一般为15天内,出发日期-月,例:m=6
出发日期-日d不超过预售时间,一般为15天内,出发日期-日,例:d=30
cookieck不传该参数则使用平台提供的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
用户IPuip接口调用者IP,用于后台统计IP地域分布,ISP运营商,时段IP数统计等,如不传该参数则默认为接口请求端IP,该参数主要用于使用后端服务器/中间件请求接口的方式使用。例:uip=123.123.123.123。该参数彩钻会员和炫钻会员专享。
返回参数说明
名称 参数 说明
状态码code200成功,400错误。普通用户采用接口本地线路调用,成功率无保障。彩钻和炫钻用户采用本地+代理双模式调用,成功率较高。查询成功后的信息有60秒缓存期。
提示信息msg提示信息
查询模式td查询模式
数据集datas数据集
车组编号datas.train_number车组编号
车次代码datas.train_order车次代码
始发站名称datas.star_name始发站名称
始发站代码datas.star_code始发站代码
终点站名称datas.end_name终点站名称
终点站代码datas.end_code终点站代码
出发站名称datas.depart_name出发站名称
出发站代码datas.depart_code出发站代码
目的站名称datas.arrive_name目的站名称
目的站代码datas.arrive_code目的站代码
出发站出发时间datas.depart_time出发站出发时间
目的站到达时间datas.arrive_time目的站到达时间
日期差datas.day_difference日期差N天
列车类型datas.train_type列车类型
乘车时长datas.alltime出发站到目的站总共乘车时长
二等座票价datas.edz二等座票价,0.00表示无该座位类型,下同。
一等座票价datas.ydz一等座票价
特等座商务座票价datas.tdz特等座商务座票价
硬座票价datas.yz硬座票价
硬卧票价datas.yw硬卧票价
软卧票价datas.rw软卧票价
返回数据示例
示例:{"code":400,"msg":"通讯秘钥错误。"}
示例:
{
    "code": 200,
    "td": "本地模式",
    "addtime": "2025-12-10",
    "datas": [{
        "train_number": "76000G32860A",
        "train_order": "G3286",
        "star_name": "成都东",
        "star_code": "ICW",
        "end_name": "上海虹桥",
        "end_code": "AOH",
        "depart_name": "绵阳",
        "depart_code": "MYW",
        "arrive_name": "上海虹桥",
        "arrive_code": "AOH",
        "depart_time": "08:32",
        "arrive_time": "19:42",
        "day_difference": "0",
        "train_type": "高速",
        "alltime": "11:10",
        "edz": "956.00",
        "ydz": "1526.50",
        "tdz": "3100.50",
        "yz": "0.00",
        "yw": "0.00",
        "rw": "0.00"
    }, {
        "train_number": "77000G32900E",
        "train_order": "G3290",
        "star_name": "沙坪坝",
        "star_code": "CYW",
        "end_name": "上海虹桥",
        "end_code": "AOH",
        "depart_name": "绵阳",
        "depart_code": "MYW",
        "arrive_name": "上海虹桥",
        "arrive_code": "AOH",
        "depart_time": "11:22",
        "arrive_time": "22:47",
        "day_difference": "0",
        "train_type": "高速",
        "alltime": "11:25",
        "edz": "956.00",
        "ydz": "1526.50",
        "tdz": "3100.50",
        "yz": "0.00",
        "yw": "0.00",
        "rw": "0.00"
    }, {
        "train_number": "77000G19760O",
        "train_order": "G1976",
        "star_name": "重庆西",
        "star_code": "CXW",
        "end_name": "上海虹桥",
        "end_code": "AOH",
        "depart_name": "绵阳",
        "depart_code": "MYW",
        "arrive_name": "上海虹桥",
        "arrive_code": "AOH",
        "depart_time": "11:46",
        "arrive_time": "22:32",
        "day_difference": "0",
        "train_type": "高速",
        "alltime": "10:46",
        "edz": "987.00",
        "ydz": "1579.50",
        "tdz": "3321.50",
        "yz": "0.00",
        "yw": "0.00",
        "rw": "0.00"
    }, {
        "train_number": "760000K2840I",
        "train_order": "K284",
        "star_name": "成都西",
        "star_code": "CMW",
        "end_name": "上海",
        "end_code": "SHH",
        "depart_name": "绵阳",
        "depart_code": "MYW",
        "arrive_name": "上海",
        "arrive_code": "SHH",
        "depart_time": "20:28",
        "arrive_time": "06:53",
        "day_difference": "2",
        "train_type": "快速",
        "alltime": "34:25",
        "edz": "0.00",
        "ydz": "0.00",
        "tdz": "0.00",
        "yz": "268.50",
        "yw": "487.50",
        "rw": "751.50"
    }, {
        "train_number": "760000K3520V",
        "train_order": "K352",
        "star_name": "成都西",
        "star_code": "CMW",
        "end_name": "上海松江",
        "end_code": "IMH",
        "depart_name": "绵阳",
        "depart_code": "MYW",
        "arrive_name": "上海松江",
        "arrive_code": "IMH",
        "depart_time": "21:23",
        "arrive_time": "07:50",
        "day_difference": "2",
        "train_type": "快速",
        "alltime": "34:27",
        "edz": "0.00",
        "ydz": "0.00",
        "tdz": "0.00",
        "yz": "263.50",
        "yw": "477.50",
        "rw": "735.50"
    }]
}
更新记录
2025-12-09 14:49:29 - 新增接口。

 12306-火车票公示票价查询-2026-03-04 23:30:01

查询指定日期火车票公示票价,公示票价可能与实际票价不同,实际票价请查询火车票余票票价接口。彩钻和炫钻用户采用本地+代理双模式调用,成功率较高。

调用限制
调用权限 非定制接口直接使用
单价/次 免费[无上限]
单日[所有用户之和] 999999999
1分钟并发[所有用户之和] 2000
1小时并发[所有用户之和] 999999999
频次限制[注册用户] 10次/分钟|每日无上限
频次限制[钻石会员] 最高8000+次/分钟|每日无上限
频次限制[定制频次] 联系我们定制
调用方法
请求方式 GET/POST
返回格式 JSON
编码格式 UTF-8
调用信息
浏览量 344
今日总计调用 24
昨日总计调用 67
历史总计调用 4620
今日排名 220
总排名 273
自检信息
自检启用状态 未开启
自检节点 /
自检线路 彩钻接口线路
自检时间 /
自检耗时 / 毫秒
自检状态 /
历史自检成功数 / 次
历史自检失败数 / 次
历史自检成功率 / %
今日自检成功数 / 次
今日自检失败数 / 次
今日自检成功率 / %