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

qimen.alitrip.custombus.return.query (定制巴士查询退票手续费接口)

定制巴士查询退票手续费接口

公共参数

请求地址：

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

请求参数

名称	类型	是否必须	示例值	更多限制	描述
agentOrderId	String	可选	1506644040404		商家订单Id
alitripOrderId	String	可选	400339933333		飞猪订单id

响应参数

名称	类型	示例值	描述
retCode	String	0	错误码
retDesc	String	成功	错误描述
agentOrderId	String	true	商家订单Id（是必填）
alitripOrderId	String	2000093330455	飞猪订单id（是必填）
passengerList	PassengerList []		乘客信息（list必填）
└ passengerName String 罗大佑乘客姓名 └ passengerCertificateNo String 212100198902171763 乘客证件号 └ passengerId String 12625061024999 乘客Id（票id或订单id，全数字类型） └ passengerCertificateType String 1 乘客证件类型 └ refundSurcharge Number 500 手续费 └ ticketId String 33390 票Id
success	Boolean	true	成功状态

请求示例

{"agentOrderId":"1506644040404","alitripOrderId":"400339933333"}

响应示例

{
    "retCode":"0",
    "retDesc":"成功",
    "agentOrderId":"true",
    "alitripOrderId":"2000093330455",
    "passengerList":[
        {
                "passengerName":"罗大佑",
                "passengerCertificateNo":"212100198902171763",
                "passengerId":"12625061024999",
                "passengerCertificateType":"1",
                "refundSurcharge":500,
                "ticketId":"33390"
        }
    ],
    "success":true
}

验签示例

{"retDesc":"Illegal request","success":"false","retCode":"sign-check-failure"}

错误码解释

错误码	错误描述	解决方案

API工具

错误码查询工具 SDK下载

FAQ

有用( 0 ) 我要提问

返回
顶部

开放平台

汽车票API

qimen.alitrip.custombus.return.query (定制巴士查询退票手续费接口)

公共参数

请求参数

响应参数

请求示例

响应示例

验签示例

错误码解释

API工具

FAQ