淘宝开放平台

请求地址：

环境	HTTP请求地址
正式环境	http://qimen.api.taobao.com/router/qm
测试环境	http://qimen.api.taobao.com/router/qmtest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
session	String	否	用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请点击这里。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选。
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟。
format	String	否	响应格式。默认为xml格式，可选值：xml，json。
v	String	是	API协议版本，可选值：2.0。
customerId	String	是	WMS颁发给用户的ID
sign_method	String	是	签名的摘要算法，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。

名称	类型	是否必须	示例值	描述
from_division_id	Number	可选	123456789	出发城市id
from_division_name	String	可选	法兰克福市	出发城市名称
from_station_code	String	可选	FLANK	出发车站编码
from_station_name	String	可选	法兰克福站	出发车站名称
to_division_id	Number	可选	123456	到达城市id
to_division_name	String	可选	加州	到达城市名称
to_station_code	String	可选	JZ	到达车站编码
to_station_name	String	可选	加州车站	到达车站名称
dep_date	String	可选	2019-11-11	出发日期
dep_time	String	可选	01:01	发车时间
adult	Number	可选	4	成人数量
child	Number	可选	2	儿童数量
old	Number	可选	3	老人数量
young	Number	可选	3	青年数量
async_key	String	可选	qwertyuio	异步轮询key
duration	Number	可选	4	持续时长，单位小时
count	Number	可选	5	单次查询返回数量，默认5，最大100

名称	类型	示例值	描述
result	RailSolutionRS		仓位信息
└ success Boolean true 是否成功 └ err_code String 001 错误码 └ err_msg String 系统错误错误描述 └ async_key String b4779ce2f0aeb2e44be8076a4de12633 异步轮询key └ has_more String true 是否还有未拉取数据 railSolutions RailSolutionDTO [] 搜索结果 sections RailSectionDTO [] Offer/Service的列车 trains RailTrainDTO [] 列车信息 └ arrival String 2019-11-22 12:00 到达时间 └ departure String 2019-11-22 02:00 发车时间 └ to_station_name String 法兰克福站出发车站名称 └ to_station_code String CLK 到达车站编码 └ from_station_name String 加州火车票出发车站名称 └ from_station_code String NSD 出发车站编码 └ type String 高等坐席车型 └ number String N101 车次编号 services RailServiceDTO [] 仓位信息 └ booking_type String 成人票全价购票类型 └ booking_code String qwe 购票码 └ unit_price Number 10000 单价 └ price Number 40000 总价（分） └ stock Number 3 余票 └ offer_name String 全价票票种名 └ offer_code String quanj 票种code └ service_name String 经济舱仓位名 └ service_code String jingji 仓位code └ carrier_code String CDALX 铁路公司code └ carrier_name String 捷克铁路铁路公司名称 └ fee_price Number 3000 出票费分 └ transfer_times Number 2 中转次数 └ duration Number 27 时长分钟 └ arrival String 2019-11-22 10:00 到达时间 └ departure String 2019-11-22 02:00 出发时间 └ to_station_name String 法兰克福站到达站名称 └ to_station_code String flank 到达站编码 └ from_station_name String 加州火车站出发站名称 └ from_station_code String calafni 出发站code

{"from_station_name":"法兰克福站","async_key":"qwertyuio","from_division_id":123456789,"young":3,"old":3,"dep_time":"01:01","count":5,"to_division_id":123456,"from_division_name":"法兰克福市","from_station_code":"FLANK","dep_date":"2019-11-11","duration":4,"to_station_code":"JZ","to_station_name":"加州车站","to_division_name":"加州","adult":4,"child":2}

{
    "result":{
        "success":true,
        "err_code":"001",
        "err_msg":"系统错误",
        "async_key":"b4779ce2f0aeb2e44be8076a4de12633",
        "has_more":"true",
        "railSolutions":[
            {
                    "sections":[
                        {
                                "trains":[
                                    {
                                            "arrival":"2019-11-22 12:00",
                                            "departure":"2019-11-22 02:00",
                                            "to_station_name":"法兰克福站",
                                            "to_station_code":"CLK",
                                            "from_station_name":"加州火车票",
                                            "from_station_code":"NSD",
                                            "type":"高等坐席",
                                            "number":"N101"
                                    }
                                ],
                                "services":[
                                    {
                                            "booking_type":"成人票全价",
                                            "booking_code":"qwe",
                                            "unit_price":10000,
                                            "price":40000,
                                            "stock":3,
                                            "offer_name":"全价票",
                                            "offer_code":"quanj",
                                            "service_name":"经济舱",
                                            "service_code":"jingji"
                                    }
                                ],
                                "carrier_code":"CDALX",
                                "carrier_name":"捷克铁路"
                        }
                    ],
                    "fee_price":3000,
                    "transfer_times":2,
                    "duration":27,
                    "arrival":"2019-11-22 10:00",
                    "departure":"2019-11-22 02:00",
                    "to_station_name":"法兰克福站",
                    "to_station_code":"flank",
                    "from_station_name":"加州火车站",
                    "from_station_code":"calafni"
            }
        ]
    }
}

{"result":{"success":"不等于true","err_msg":"Illegal request","err_code":"sign-check-failure"}}

错误码	错误描述	解决方案

错误码查询工具 SDK下载

国际火车票API

qimen.alitrip.rail.ir.search (国际火车票搜索接口)

公共参数

请求参数

响应参数

请求示例

响应示例

验签示例

错误码解释

API工具

FAQ