接口简介：
查询指定日期，出发地到目的地火车票余票等信息。普通用户采用接口本地线路调用，成功率无保障。彩钻和炫钻用户采用本地+代理双模式调用，成功率超高。调用该接口后可根据该接口返回的信息继续调用查询票价接口和车次全程站点及停留时间查询接口。
请求地址：
https://cn.apihz.cn/api/12306/api.php
请求方式：
POST或GET。
请求参数：
【名称】【参数】【必填】【说明】
【用户ID】【id】【是】【用户中心的数字ID，例：id=10000000】
【用户KEY】【key】【是】【用户中心通讯秘钥，例：key=15he5h15ty854j5sr152hs2】
【出发站点】【add】【是】【出发地或出发车站名称，例：add=绵阳】
【目的站点】【end】【是】【目的地或目的车站名称，例：end=上海】
【出发日期-年】【y】【是】【出发日期-年，例：y=2025】
【出发日期-月】【m】【是】【出发日期-月，例：m=6】
【出发日期-日】【d】【是】【出发日期-日，例：d=30】
【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_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代表余票数量，票量紧张。】
GET请求示例：
https://cn.apihz.cn/api/12306/api.php?id=88888888&key=88888888&add=绵阳&end=上海&y=2025&m=6&d=30&ck=
注意：示例里的ID与KEY为公共ID与KEY，共享每分钟调用频次限制，接口本身免费，请使用自己的ID与KEY，独享每分钟调用频次。每日调用无上限。
POST请求示例：
请根据开发语言自行POST。
返回数据示例：
示例：{"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
}]
}]
参考资料(版权)：
https://www.apihz.cn/api/12306api.html
