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

复制

测速 

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

复制

测速 

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

复制

测速 

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

复制

测速 

接口线路类型三[超高稳定-最低24¥/月]
[彩钻接口] :[专属集群+普通集群+备用集群,自动负载均衡,自动故障切换,抗攻击,全球智能CDN加速。超高稳定性!CC防火墙宽松。登录后购买。]

复制

测速 

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

复制全部

复制参数 

[POST]请求示例(请根据开发语言自行POST)

请求参数说明
注意:请求编码为UTF8,否则带中文请求可能失败。一般参数不能带+号,会被自动替换为空格。
提示:如发现接口有BUG,可加服务QQ群500700444,及时向我们反馈。
名称 参数 必填 说明
开发者IDid用户中心的数字ID,例:id=10000000
开发者KEYkey用户中心通讯秘钥,例:key=15he5h15ty854j5sr152hs2
出发站点add出发地或出发车站名称,例:add=绵阳
目的站点end目的地或目的车站名称,例:end=上海
出发日期-年y出发日期-年,例:y=2025
出发日期-月m出发日期-月,例:m=6
出发日期-日d出发日期-日,例: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
用户IPV4uip接口调用者IPV4,用于后台统计IP地域分布,ISP运营商,时段IP数统计等,如不传该参数则默认为接口请求端IP,该参数主要用于使用后端服务器/中间件请求接口的方式使用。例:uip=123.123.123.123
返回参数说明
名称 参数 说明
状态码code200成功,400错误。普通用户采用接口本地线路调用,成功率无保障。彩钻和炫钻用户采用本地+代理双模式调用,成功率超高。查询成功后的信息有60秒缓存期。
提示信息msg提示信息
车组编号train_number车组编号
车次编号train_order车次编号
出发站点索引depart_index出发站点索引
目的站点索引arrive_index目的站点索引
出发站点名称depart_name出发站点名称
目的站点名称arrive_name目的站点名称
出发站点归属市depart_city出发站点归属市
目的站点归属市arrive_city目的站点归属市
出发站点代码depart_code出发站点代码
目的站点代码arrive_code目的站点代码
出发时间depart_time出发时间
目的时间arrive_time目的时间
总计耗时duration总计耗时
座位参数seatcode座位参数
出发日期date出发日期
票量数据集seats票量数据集
座位等级seats.type座位等级
座位余票seats.stock座位余票,-1代表有票,票量充足。0代表无票。大于0代表余票数量,票量紧张。
返回数据示例
示例:{"code":400,"msg":"通讯秘钥错误。"}
示例:
[{
    "train_number": "G3286",
    "train_order": "76000G328609",
    "depart_index": "04",
    "arrive_index": "24",
    "depart_name": "绵阳",
    "arrive_name": "上海虹桥",
    "depart_city": "绵阳",
    "arrive_city": "上海",
    "depart_code": "MYW",
    "arrive_code": "AOH",
    "depart_time": "08:32",
    "arrive_time": "19:42",
    "duration": "11:10",
    "seatcode": "9MO",
    "date": "2025-06-30",
    "seats": [{
        "type": "商务座(特等座)",
        "stock": 3
    }, {
        "type": "一等座",
        "stock": 7
    }, {
        "type": "二等座(二等包座)",
        "stock": -1
    }, {
        "type": "高级软卧",
        "stock": 0
    }, {
        "type": "软卧(动卧一等卧)",
        "stock": 0
    }, {
        "type": "硬卧(二等卧)",
        "stock": 0
    }, {
        "type": "软座",
        "stock": 0
    }, {
        "type": "硬座",
        "stock": 0
    }, {
        "type": "无座",
        "stock": 0
    }, {
        "type": "优选一等座",
        "stock": 0
    }]
}, {
    "train_number": "G3290",
    "train_order": "77000G32900D",
    "depart_index": "06",
    "arrive_index": "29",
    "depart_name": "绵阳",
    "arrive_name": "上海虹桥",
    "depart_city": "绵阳",
    "arrive_city": "上海",
    "depart_code": "MYW",
    "arrive_code": "AOH",
    "depart_time": "11:21",
    "arrive_time": "22:47",
    "duration": "11:26",
    "seatcode": "9MO",
    "date": "2025-06-30",
    "seats": [{
        "type": "商务座(特等座)",
        "stock": 0
    }, {
        "type": "一等座",
        "stock": -1
    }, {
        "type": "二等座(二等包座)",
        "stock": -1
    }, {
        "type": "高级软卧",
        "stock": 0
    }, {
        "type": "软卧(动卧一等卧)",
        "stock": 0
    }, {
        "type": "硬卧(二等卧)",
        "stock": 0
    }, {
        "type": "软座",
        "stock": 0
    }, {
        "type": "硬座",
        "stock": 0
    }, {
        "type": "无座",
        "stock": 0
    }, {
        "type": "优选一等座",
        "stock": 0
    }]
}, {
    "train_number": "G1976",
    "train_order": "77000G19760N",
    "depart_index": "05",
    "arrive_index": "25",
    "depart_name": "绵阳",
    "arrive_name": "上海虹桥",
    "depart_city": "绵阳",
    "arrive_city": "上海",
    "depart_code": "MYW",
    "arrive_code": "AOH",
    "depart_time": "11:46",
    "arrive_time": "22:32",
    "duration": "10:46",
    "seatcode": "9MO",
    "date": "2025-06-30",
    "seats": [{
        "type": "商务座(特等座)",
        "stock": 2
    }, {
        "type": "一等座",
        "stock": 13
    }, {
        "type": "二等座(二等包座)",
        "stock": -1
    }, {
        "type": "高级软卧",
        "stock": 0
    }, {
        "type": "软卧(动卧一等卧)",
        "stock": 0
    }, {
        "type": "硬卧(二等卧)",
        "stock": 0
    }, {
        "type": "软座",
        "stock": 0
    }, {
        "type": "硬座",
        "stock": 0
    }, {
        "type": "无座",
        "stock": 0
    }, {
        "type": "优选一等座",
        "stock": 0
    }]
}, {
    "train_number": "K284",
    "train_order": "760000K2840I",
    "depart_index": "03",
    "arrive_index": "25",
    "depart_name": "绵阳",
    "arrive_name": "上海",
    "depart_city": "绵阳",
    "arrive_city": "上海",
    "depart_code": "MYW",
    "arrive_code": "SHH",
    "depart_time": "20:28",
    "arrive_time": "06:53",
    "duration": "34:25",
    "seatcode": "1431",
    "date": "2025-06-30",
    "seats": [{
        "type": "商务座(特等座)",
        "stock": 0
    }, {
        "type": "一等座",
        "stock": 0
    }, {
        "type": "二等座(二等包座)",
        "stock": 0
    }, {
        "type": "高级软卧",
        "stock": 0
    }, {
        "type": "软卧(动卧一等卧)",
        "stock": 0
    }, {
        "type": "硬卧(二等卧)",
        "stock": 0
    }, {
        "type": "软座",
        "stock": 0
    }, {
        "type": "硬座",
        "stock": 0
    }, {
        "type": "无座",
        "stock": 0
    }, {
        "type": "优选一等座",
        "stock": 0
    }]
}, {
    "train_number": "K352",
    "train_order": "760000K3520V",
    "depart_index": "03",
    "arrive_index": "25",
    "depart_name": "绵阳",
    "arrive_name": "上海松江",
    "depart_city": "绵阳",
    "arrive_city": "上海",
    "depart_code": "MYW",
    "arrive_code": "IMH",
    "depart_time": "21:23",
    "arrive_time": "07:45",
    "duration": "34:22",
    "seatcode": "3411",
    "date": "2025-06-30",
    "seats": [{
        "type": "商务座(特等座)",
        "stock": 0
    }, {
        "type": "一等座",
        "stock": 0
    }, {
        "type": "二等座(二等包座)",
        "stock": 0
    }, {
        "type": "高级软卧",
        "stock": 0
    }, {
        "type": "软卧(动卧一等卧)",
        "stock": 0
    }, {
        "type": "硬卧(二等卧)",
        "stock": 0
    }, {
        "type": "软座",
        "stock": 0
    }, {
        "type": "硬座",
        "stock": 19
    }, {
        "type": "无座",
        "stock": 0
    }, {
        "type": "优选一等座",
        "stock": 0
    }]
}]
更新记录
2025-06-19 00:35:39 - 新增接口。

 12306-火车票余票信息查询-2025-06-20 05:35:00

查询指定日期,出发地到目的地火车票余票等信息。普通用户采用接口本地线路调用,成功率无保障。彩钻和炫钻用户采用本地+代理双模式调用,成功率超高。调用该接口后可根据该接口返回的信息继续调用查询票价接口和车次全程站点及停留时间查询接口。

调用限制
单价/次 免费[无上限]
瞬时并发[单IP] 20
单日[所有用户之和] 999999999
1分钟并发[所有用户之和] 2000
1小时并发[所有用户之和] 999999999
频次限制[注册用户] 10次/分钟|每日无上限
频次限制[钻石会员] 最高+1500次/分钟|每日无上限
频次限制[定制频次] 联系我们定制
调用方法
请求方式 GET/POST
返回格式 JSON
编码格式 UTF-8
调用信息
浏览量 212
今日调用 384
昨日调用 539
总调用 5882
今日排名 63
总排名 205
自检信息

自检日志

自检启用状态 已启用
自检节点 上海
自检线路 彩钻接口线路
自检时间 2025-07-04 19:38:04
自检耗时 390 毫秒
自检状态 正常
历史自检成功数 5358 次
历史自检失败数 1 次
历史自检成功率 99.98 %
今日自检成功数 294 次
今日自检失败数 0 次
今日自检成功率 100.00 %