文档中心 > API类目 > 交易API

qimen.alitrip.rail.trade.book (占座接口)

国际火车票商家占座接口

公共参数

请求地址：

环境	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输入参数签名结果，签名算法介绍请点击这里。

请求参数

名称	类型	是否必须	示例值	更多限制	描述
booking_code	String []	必须		最大列表长度：999	占座码
seat_reserved	Boolean	必须	false		是否定座
contact	Contact	必须			联系人信息
└ first_name String 可选 bing 名 └ last_name String 可选 chen 姓 └ email String 必须 xx@sina.com 邮箱 └ phone String 必须 13011111111 电话需要+86 └ name String 可选朱轩中文名
passenger_list	Passenger []	必须		最大列表长度：999	乘客信息
└ birth_date String 必须 2011-08-12 出生日期yyyy-MM-dd └ email String 可选 test@sina.com 邮箱 └ first_name String 必须 bing 名 └ last_name String 必须 chen 姓 └ gender String 必须 FEMALE 性别FEMALE/MALE └ passport String 必须 EX20211 护照号 └ phone String 可选 13000001111 手机号需要+86
tp_order_id	Number	必须	123455		平台订单号
attributes	String	可选	aa		扩展字段

响应参数

名称	类型	示例值	描述
result	ResultSet		响应结果
module BookRS module └ asyncKey String keyxxx 异步key └ isAsync Boolean false 是否异步 └ agentOrderId String 123442 代理商订单号(同步接口必须返回,异步接口如果没有返回异步key的话必须返回,有key的话可不返回也可不返回) ticket_list Ticket [] 票信息 └ ticket_id String ticektId ticektId └ from_station_name String 柏林出发站名 └ from_station_code String xxt 出发站code └ to_station_name String 米兰到达站名 └ to_station_code String xxa 到达站code └ ticket_price Number 100 票价:(单位分) └ payment_price String 2000 总支付价:(单位分) └ ticket_price String 2000 票面总价:(单位分) └ err_msg String 系统异常错误信息 └ err_code String sys-error 错误码 └ success Boolean true 是否成功

请求示例

{"booking_code":[""],"seat_reserved":false,"tp_order_id":123455,"contact":{"phone":"13011111111","name":"朱轩","last_name":"chen","first_name":"bing","email":"xx@sina.com"},"attributes":"aa","passenger_list":[{"gender":"FEMALE","passport":"EX20211","phone":"13000001111","birth_date":"2011-08-12","last_name":"chen","first_name":"bing","email":"test@sina.com"}]}

响应示例

{
    "result":{
        "module":{
            "asyncKey":"keyxxx",
            "isAsync":false,
            "agentOrderId":"123442",
            "ticket_list":[
                {
                        "ticket_id":"ticektId",
                        "from_station_name":"柏林",
                        "from_station_code":"xxt",
                        "to_station_name":"米兰",
                        "to_station_code":"xxa",
                        "ticket_price":100
                }
            ],
            "payment_price":"2000",
            "ticket_price":"2000"
        },
        "err_msg":"系统异常",
        "err_code":"sys-error",
        "success":true
    }
}

验签示例

{"result":{"success":"false","err_msg":"Illegal request","err_code":"sign-check-failure"}}

错误码解释

错误码	错误描述	解决方案

API工具

错误码查询工具 SDK下载

FAQ

有用( 0 ) 我要提问

返回
顶部

淘宝开放平台

交易API

qimen.alitrip.rail.trade.book (占座接口)

公共参数

请求参数

响应参数

请求示例

响应示例

验签示例

错误码解释

API工具

FAQ