文档中心 > API类目 > 火车票API

qimen.alitrip.train.ticket.status (奇门查询票状态)

根据票流水号lsh查询票状态及票面信息。调用方通过targetAppKey指定服务商，不执行购票、退票或改签操作。

公共参数

请求地址：

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

名称	类型	是否必须	示例值	描述
requestTime	String	必须	1790038800000	请求时间戳，毫秒字符串
apiKey	String	必须	demo-api-key	服务商业务API标识，由服务商分配
data	TrainTicketStatusQueryData	必须		票状态查询请求
└ lsh String 必须 DEMO-TICKET-001 票流水号，不能为空
apiSign	String	必须	00000000000000000000000000000000	业务签名，按双方约定的签名规则生成；示例仅占位，不是真实签名

名称	类型	示例值	描述
success	Boolean	true	业务处理是否成功
resultCode	String	200	业务结果码，成功为200，失败返回非0错误码
resultMessage	String	成功	业务结果说明
data	String	[{"lsh":"DEMO-TICKET-001","ticketStatus":"进站已检"}]	商家业务数据的JSON字符串，内部可为对象或数组；调用方按目标商家协议反序列化，不要求统一内部字段。失败时可为空。

{"requestTime":"1790038800000","apiKey":"demo-api-key","data":"{\"lsh\":\"DEMO-TICKET-001\"}","apiSign":"00000000000000000000000000000000"}

{
    "success":true,
    "resultCode":"200",
    "resultMessage":"成功",
    "data":"[{\"lsh\":\"DEMO-TICKET-001\",\"ticketStatus\":\"进站已检\"}]"
}

{"success":"不等于true","resultCode":"sign-check-failure","resultMessage":"Illegal request"}

错误码	错误描述	解决方案

错误码查询工具 SDK下载

有用( 0 ) 我要提问