☰
全部接口 / 火车票余票-换乘方案查询 / APIID:2182 QQ群
接口调用地址
线路类型一 [普通集群负载-IP接口]
说明：直接访问 https://api.apihz.cn/getapi.php 获取当前最优IP接口地址。由普通负载集群服务器组成，通过IP接口地址调用，如果单个服务器过载可自行切换IP接口地址尝试其他负载服务器。IP并非永久固定且容易遭受攻击，平台可能不定期更换。
线路类型二 [普通集群负载-域名接口]
https://cn.apihz.cn/api/12306/apihc.php
测速 复制
说明：域名接口会自动分发请求到普通集群服务器均衡负载，该域名TTL值为60秒，表示你的请求会每60秒实现自动轮换负载服务器，但也可能因你的网络服务商存在DNS缓存造成短时间内无法自动切换负载。如果某个负载服务器出现故障，也可能会造成个别地区存在一定时间的故障期。
线路类型三 [VIP集群负载-VIP线路接口]
https://vip.apihz.cn/api/12306/apihc.php
测速 复制
说明：VIP专线在普通集群组的基础上额外增加独享大带宽集群组，每次请求自动均衡负载，自动故障切换，抗攻击，全球智能CDN加速。超高稳定性！最低30¥/月，彩钻以上会员专属，登录后购买。注：VIP线路是指调用接口的线路更有保障以及每分钟拥有更高的调用频次等，并非收费接口包月使用。
请求示例
[GET]请求示例：(请登录后使用自己的KEY独享频次)
复制参数 复制全部
https://cn.apihz.cn/api/12306/apihc.php?id=88888888&key=88888888&add=绵阳&end=上海&y=2026&m=3&d=30&page=1
[POST]请求示例：(请根据开发语言自行POST，参考【GET/POST教程】，或下载【超级客户端】调试。)
请求参数说明
注意：请求编码为UTF8，否则带中文请求可能失败。一般参数不能带+号，会被自动替换为空格。参数内容较大的必须用POST，不能GET。
提示：如发现接口有BUG，可加服务QQ群及时向我们反馈。
提示：请求参数里的开发者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
查询页码page否查询页码，默认第1页，例：page=1
动态秘钥dkey否开发者开启动态秘钥验证后需传此参数，主要针对直接在客户端调用接口的场景。请在官网后台菜单【个人资料】里配置。例：dkey=0cd2a494831736587c33f30d1e544371
用户IPuip否接口调用者IP，用于后台统计IP地域分布，ISP运营商，时段IP数统计等，如不传该参数则默认为接口请求端IP，该参数主要用于使用后端服务器/中间件请求接口的方式使用。例：uip=123.123.123.123。该参数彩钻/炫钻/焱钻会员专享。
返回参数说明
名称参数说明
状态码code200成功，400错误。普通用户采用接口本地线路调用，成功率无保障。彩钻和炫钻，焱钻用户采用本地+代理双模式调用，成功率较高。查询成功后的信息有60秒缓存期。
提示信息msg提示信息
通道模式td通道模式
页码page查询页码
中转站数据集zdz要经过的中转站列表
换乘方案数据集datas换乘方案数据集
全程时间datas.lishi总历时格式化时间
全程时间2datas.null总历时整数型，分钟
热门车次datas.heat是否为热门车次，N=不是
同站换乘datas.hcst是否同站换乘，0=同站换乘，1=一般为同城其他站换乘
同车换乘datas.hcst2是否同车换乘，N=非同车换乘
方案评分datas.score该方案评分，基本无参考价值
车段数datas.count该换乘方案需要换乘的车段数，例如两个车段就是换乘1次
起点站车次编号datas.addorder起点站车次编号
起点站车站代码datas.addcode起点站车站代码
起点站名称datas.addname起点站名称
起点站发车日期datas.adddate起点站发车日期
起点站发车时间datas.addtime起点站发车时间
到达中转站日期datas.zzdate到达中转站日期
中转站代码datas.zzcode中转站代码
中转站点名称datas.zzname中转站点名称
中转下一程车次编号datas.zzorder中转第二程车次编号
中转站等候时间datas.zzwait中转站等候时间格式化
中转站等候时间2datas.zzwait2中转站等候时间整数型，分钟
到达终点站日期datas.enddate到达终点站日期
到达终点站时间datas.endtime到达终点站时间
终点站代码datas.endcode终点站代码
终点站名称datas.endname终点站名称
换乘车段数据集datas.list换乘车段数据集，一般为两段数据。
对公车次编号datas.list.code对公车次编号
列车编号datas.list.order列车编号
出发站名称datas.list.addname出发站名称，乘车站。
出发站代码datas.list.addcode出发站代码
出发站上车时间datas.list.addtime出发站上车时间
下车站名称datas.list.endname下车站名称
下车站代码datas.list.endcode下车站代码
下车站到站时间datas.list.endtime下车站到站时间
到达日期差datas.list.day到达日期差，0=当日到，1=次日到
身份证检票datas.list.scard身份证检票，1=支持
总历时datas.list.lishi总历时，N时N分
列车等级datas.list.seat列车等级
商务座余票datas.list.swz。数字=具体票数，有=有票票数未知或票量充足，无=无票，横杠=该车没有此席位。下同。
一等座余票datas.list.ydz一等座余票
二等座余票datas.list.edz二等座余票
无座余票datas.list.wz无座余票
特等座余票datas.list.tdz特等座余票
软卧余票datas.list.rw软卧余票
硬卧余票datas.list.yw硬卧余票
软座余票datas.list.rz软座余票
硬座余票datas.list.yz硬座余票
商务软座datas.list.srrb商务软座/高级软卧余票
其他特殊座位余票datas.list.qt其他特殊座位余票
优等座datas.list.yb一等包座或优等座余票
返回数据示例
示例：{"code":400,"msg":"通讯秘钥错误。"}
示例：
{
    "code": 200,
    "td": "本地模式",
    "page": 1,
    "zdz": [
        "ZZF#郑州",
        "LLF#洛阳龙门",
        "EAY#西安北",
        "ZAF#郑州东",
        "ICW#成都东"],
    "datas": [{
        "lishi": "11小时29分钟",
        "lishi2": 689,
        "heat": "N",
        "hcst": "0",
        "hcst2": "Y",
        "score": 335,
        "count": 2,
        "addorder": "77000G329408",
        "addcode": "MYW",
        "addname": "绵阳",
        "adddate": "2026-03-30",
        "addtime": "09:33",
        "zzdate": "2026-03-30",
        "zzcode": "ZAF",
        "zzname": "郑州东",
        "zzorder": "77000G329408",
        "zzwait": "12分钟",
        "zzwait2": 12,
        "enddate": "2026-03-30",
        "endtime": "21:02",
        "endcode": "AOH",
        "endname": "上海虹桥",
        "list": [{
            "code": "G3294",
            "order": "77000G329408",
            "addname": "绵阳",
            "addcode": "MYW",
            "addtime": "09:33",
            "endname": "郑州东",
            "endcode": "ZAF",
            "endtime": "14:49",
            "day": "0",
            "scard": "1",
            "lishi": "05:16",
            "seat": "3",
            "swz": "无",
            "ydz": "无",
            "edz": "2",
            "wz": "无",
            "tdz": "--",
            "rw": "--",
            "yw": "--",
            "rz": "--",
            "yz": "--",
            "srrb": "--",
            "qt": "--",
            "yb": "--"
        }, {
            "code": "G3294",
            "order": "77000G329408",
            "addname": "郑州东",
            "addcode": "ZAF",
            "addtime": "09:33",
            "endname": "上海虹桥",
            "endcode": "AOH",
            "endtime": "21:02",
            "day": "0",
            "scard": "1",
            "lishi": "06:01",
            "seat": "3",
            "swz": "无",
            "ydz": "无",
            "edz": "12",
            "wz": "无",
            "tdz": "--",
            "rw": "--",
            "yw": "--",
            "rz": "--",
            "yz": "--",
            "srrb": "--",
            "qt": "--",
            "yb": "--"
        }]
    }, {
        "lishi": "12小时31分钟",
        "lishi2": 751,
        "heat": "N",
        "hcst": "0",
        "hcst2": "Y",
        "score": 234,
        "count": 2,
        "addorder": "770000D97800",
        "addcode": "MYW",
        "addname": "绵阳",
        "adddate": "2026-03-30",
        "addtime": "20:27",
        "zzdate": "2026-03-30",
        "zzcode": "EAY",
        "zzname": "西安北",
        "zzorder": "770000D97800",
        "zzwait": "6分钟",
        "zzwait2": 6,
        "enddate": "2026-03-31",
        "endtime": "08:58",
        "endcode": "AOH",
        "endname": "上海虹桥",
        "list": [{
            "code": "D978",
            "order": "770000D97800",
            "addname": "绵阳",
            "addcode": "MYW",
            "addtime": "20:27",
            "endname": "西安北",
            "endcode": "EAY",
            "endtime": "23:23",
            "day": "0",
            "scard": "1",
            "lishi": "02:56",
            "seat": "3",
            "swz": "--",
            "ydz": "--",
            "edz": "无",
            "wz": "无",
            "tdz": "--",
            "rw": "20",
            "yw": "--",
            "rz": "--",
            "yz": "--",
            "srrb": "--",
            "qt": "--",
            "yb": "--"
        }, {
            "code": "D978",
            "order": "770000D97800",
            "addname": "西安北",
            "addcode": "EAY",
            "addtime": "20:27",
            "endname": "上海虹桥",
            "endcode": "AOH",
            "endtime": "08:58",
            "day": "1",
            "scard": "1",
            "lishi": "09:29",
            "seat": "3",
            "swz": "--",
            "ydz": "--",
            "edz": "无",
            "wz": "无",
            "tdz": "--",
            "rw": "有",
            "yw": "--",
            "rz": "--",
            "yz": "--",
            "srrb": "--",
            "qt": "--",
            "yb": "--"
        }]
    }, {
        "lishi": "9小时36分钟",
        "lishi2": 576,
        "heat": "N",
        "hcst": "0",
        "hcst2": "N",
        "score": 348,
        "count": 2,
        "addorder": "77000G19760P",
        "addcode": "MYW",
        "addname": "绵阳",
        "adddate": "2026-03-30",
        "addtime": "11:46",
        "zzdate": "2026-03-30",
        "zzcode": "EAY",
        "zzname": "西安北",
        "zzorder": "4f00000G9600",
        "zzwait": "32分钟",
        "zzwait2": 32,
        "enddate": "2026-03-30",
        "endtime": "21:22",
        "endcode": "AOH",
        "endname": "上海虹桥",
        "list": [{
            "code": "G1976",
            "order": "77000G19760P",
            "addname": "绵阳",
            "addcode": "MYW",
            "addtime": "11:46",
            "endname": "西安北",
            "endcode": "EAY",
            "endtime": "15:00",
            "day": "0",
            "scard": "1",
            "lishi": "03:14",
            "seat": "3",
            "swz": "1",
            "ydz": "6",
            "edz": "有",
            "wz": "无",
            "tdz": "--",
            "rw": "--",
            "yw": "--",
            "rz": "--",
            "yz": "--",
            "srrb": "--",
            "qt": "--",
            "yb": "--"
        }, {
            "code": "G96",
            "order": "4f00000G9600",
            "addname": "西安北",
            "addcode": "EAY",
            "addtime": "11:46",
            "endname": "上海虹桥",
            "endcode": "AOH",
            "endtime": "21:22",
            "day": "0",
            "scard": "1",
            "lishi": "05:50",
            "seat": "3",
            "swz": "9",
            "ydz": "有",
            "edz": "有",
            "wz": "有",
            "tdz": "--",
            "rw": "--",
            "yw": "--",
            "rz": "--",
            "yz": "--",
            "srrb": "--",
            "qt": "--",
            "yb": "--"
        }]
    }, {
        "lishi": "10小时22分钟",
        "lishi2": 622,
        "heat": "N",
        "hcst": "0",
        "hcst2": "N",
        "score": 343,
        "count": 2,
        "addorder": "76000G12820J",
        "addcode": "MYW",
        "addname": "绵阳",
        "adddate": "2026-03-30",
        "addtime": "08:21",
        "zzdate": "2026-03-30",
        "zzcode": "ZAF",
        "zzname": "郑州东",
        "zzorder": "3800000G8200",
        "zzwait": "1小时4分钟",
        "zzwait2": 64,
        "enddate": "2026-03-30",
        "endtime": "18:43",
        "endcode": "AOH",
        "endname": "上海虹桥",
        "list": [{
            "code": "G1282",
            "order": "76000G12820J",
            "addname": "绵阳",
            "addcode": "MYW",
            "addtime": "08:21",
            "endname": "郑州东",
            "endcode": "ZAF",
            "endtime": "13:36",
            "day": "0",
            "scard": "1",
            "lishi": "05:15",
            "seat": "3",
            "swz": "无",
            "ydz": "无",
            "edz": "6",
            "wz": "无",
            "tdz": "--",
            "rw": "--",
            "yw": "--",
            "rz": "--",
            "yz": "--",
            "srrb": "--",
            "qt": "--",
            "yb": "--"
        }, {
            "code": "G82",
            "order": "3800000G8200",
            "addname": "郑州东",
            "addcode": "ZAF",
            "addtime": "08:21",
            "endname": "上海虹桥",
            "endcode": "AOH",
            "endtime": "18:43",
            "day": "0",
            "scard": "1",
            "lishi": "04:03",
            "seat": "3",
            "swz": "6",
            "ydz": "有",
            "edz": "有",
            "wz": "有",
            "tdz": "--",
            "rw": "--",
            "yw": "--",
            "rz": "--",
            "yz": "--",
            "srrb": "--",
            "qt": "--",
            "yb": "--"
        }]
    }, {
        "lishi": "10小时43分钟",
        "lishi2": 643,
        "heat": "N",
        "hcst": "0",
        "hcst2": "N",
        "score": 339,
        "count": 2,
        "addorder": "76000G32860B",
        "addcode": "MYW",
        "addname": "绵阳",
        "adddate": "2026-03-30",
        "addtime": "08:32",
        "zzdate": "2026-03-30",
        "zzcode": "EAY",
        "zzname": "西安北",
        "zzorder": "4a000G219300",
        "zzwait": "36分钟",
        "zzwait2": 36,
        "enddate": "2026-03-30",
        "endtime": "19:15",
        "endcode": "AOH",
        "endname": "上海虹桥",
        "list": [{
            "code": "G3286",
            "order": "76000G32860B",
            "addname": "绵阳",
            "addcode": "MYW",
            "addtime": "08:32",
            "endname": "西安北",
            "endcode": "EAY",
            "endtime": "11:34",
            "day": "0",
            "scard": "1",
            "lishi": "03:02",
            "seat": "3",
            "swz": "无",
            "ydz": "无",
            "edz": "有",
            "wz": "无",
            "tdz": "--",
            "rw": "--",
            "yw": "--",
            "rz": "--",
            "yz": "--",
            "srrb": "--",
            "qt": "--",
            "yb": "--"
        }, {
            "code": "G2196",
            "order": "4a000G219300",
            "addname": "西安北",
            "addcode": "EAY",
            "addtime": "08:32",
            "endname": "上海虹桥",
            "endcode": "AOH",
            "endtime": "19:15",
            "day": "0",
            "scard": "1",
            "lishi": "07:05",
            "seat": "3",
            "swz": "12",
            "ydz": "有",
            "edz": "有",
            "wz": "有",
            "tdz": "--",
            "rw": "--",
            "yw": "--",
            "rz": "--",
            "yz": "--",
            "srrb": "--",
            "qt": "--",
            "yb": "--"
        }]
    }]
}
更新记录

            

        

    


    

        

            
 接口信息

            

                

                    
                    
12306-火车票余票-换乘方案查询

                

                
查询指定日期，出发地到目的地换乘方案火车票余票等信息。普通用户采用接口本地线路调用，成功率无保障。彩钻和炫钻，焱钻用户采用本地+代理双模式调用，成功率较高。 [2026-07-09 20:46:37]

                

                    使用协议：接口盒子提供的所有服务不得用于任何违法行为。接口盒子提供的信息，使用者应当自行判断准确性，适用性。使用者所造成的一切后果责任，损失等，由使用者自行承担。使用者产品所需资质应由使用者自身办理，接口盒子仅提供接口技术，不对使用者产品所需资质负责。从使用接口盒子的服务起默认遵守此协议。
                

            

        


        

            
 广告

            

                                

                    
                        广告
                    
                

                                

                    
                        广告
                    
                

                                

                    
                        广告
                    
                

                                

                    
                        广告
                    
                

                                

                    
                        广告
                    
                

                                

                    
                        广告
                    
                

                                

                    
                        广告
                    
                

                                

                    
                        广告
                    
                

                            

        


        

            
 调用限制

            

                

                    
调用权限非定制接口直接使用

                    
单价/次免费[无上限]

                    
单日[所有用户之和]999999999

                    
1分钟并发[所有用户之和]5000

                    
1小时并发[所有用户之和]999999999

                    
频次限制[注册用户]10次/分钟|每日无上限

                    
频次限制[钻石会员]最高8000+次/分钟|每日无上限

                    
频次限制[定制频次]联系我们定制

                

            

        


        

            
 调用方法

            

                

                    
请求方式GET/POST

                    
返回格式JSON

                    
编码格式UTF-8

                

            

        


        

            
 调用信息

            

                

                    
浏览量加载中

                    
今日总计调用加载中

                    
昨日总计调用加载中

                    
历史总计调用加载中

                    
今日排名加载中

                    
总排名加载中

                

            

        


        

            
 12306-相关接口

            

                                

                    

                        状态: 启用
                        ID: 2042
                        TOPD: 87
                        免费
                    

                    
火车票余票信息查询

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

                    

                        调: 2641603
                        览: 3223
                        SU: 99.98%
                        2026-03-26
                    

                

                                

                    

                        状态: 启用
                        ID: 2096
                        TOPD: 69
                        免费
                    

                    
火车票公示票价查询

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

                    

                        调: 511926
                        览: 1100
                        SU: 未检测
                        2026-03-04
                    

                

                                

                    

                        状态: 启用
                        ID: 2044
                        TOPD: 253
                        免费
                    

                    
火车车次经停站点查询

                    
火车车次经停站点查询，调用该接口必须先调用火车票余票信息查询接口，根据余票查询接口返回的数据来查询车次经停站点。可作为余票查询的补充查询。

                    

                        调: 153412
                        览: 1940
                        SU: 未检测
                        2025-06-20
                    

                

                                

                    

                        状态: 启用
                        ID: 2043
                        TOPD: 121
                        免费
                    

                    
火车票余票票价查询

                    
火车票票价查询，调用该接口必须先调用火车票余票信息查询接口，根据余票查询接口返回的数据来查询票价。可作为余票查询的补充查询。

                    

                        调: 2395608
                        览: 3371
                        SU: 未检测
                        2025-12-09