飞猪 - 开放平台

请求地址：

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://gw.api.taobao.com/router/rest	https://eco.taobao.com/router/rest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
target_app_key	String	否	被调用的目标AppKey，仅当被调用的API为第三方ISV提供时有效。
sign_method	String	是	签名的摘要算法，可选值为：hmac，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。
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。
partner_id	String	否	合作伙伴身份标识。
simplify	Boolean	否	是否采用精简JSON返回格式，仅当format=json时有效，默认值为：false。

名称	类型	是否必须	示例值	更多限制	描述
agentOrderId	String	必须	22333333		商家订单Id
alitripOrderId	String	必须	33333334444		飞猪订单Id

名称	类型	示例值	描述
retDesc	String	成功	业务状态结果描述（是必填）
statusDesc	String	出票成功	订单状态描述?票数
agentOrderId	String	13334099888	商家订单Id（是必填）
fetchTicketSpot	String	成都人民广场	取票地址信息
shipNumber	String	川A 88899	航班号信息
success	Boolean	true	业务结果（是必填）
ticketWicket	String	检票口	检票口
smsContent	String	出票成功，恭喜您购票，请于2018-11-30日21:30:00准时乘车	短信内容,商家如有特殊定制，则需要严格按照参数返回json格式数据。{"driverContactPhone":"18611330989","identificationCode","988838389","ticketInstructions":"套票使用说明"} driverContactPhone:司机联系电话 identificationCode:乘车验证码 ticketInstructions:门票使用说明（仅供门票+车票类型商品使用，非必填，默认为“凭身份证入园”）
agentIssueTime	String	2018-11-29 21:00:00	业务成功时间（是必填）
alitripOrderId	String	3892200000033	飞猪订单id（是必填）
passengerList	Passenger []		乘客信息（list必填）
└ passengerName String 罗大佑乘客姓名（是必填） ticketList Ticket [] 票信息（是必填，有填写） └ ticketPwd String 223345 取票密码（选填） └ ticketNo String 388888 票号 └ ticketSeatNo String 48 坐席号 └ eTicketNo String 3333099 电子票号 └ ticketType String 1 票种类别1-旅游巴士汽车票;2-门票;3-酒店;4-其他（选填） └ ticketSubType String 12 子票种类型11-去程;12-往返;21普通门票；31酒店（选填） └ ticketId String 334k 票Id,必须填写用于后续区分唯一标识的票（必填） └ ticketStatus String 票状态票状态：1-出票中2-已出票3-无票4-退票中5-已退票6-退票失败（选填） └ ticketRefundSurcharge Number 200 退票手续费，如果票状态是已退票，需要进行填写 └ ticketExpireTime String 过期时间 2019-12-20 09:30:00 └ ticketPrice Number 330 票价 └ ticketTitle String 船票等票标题（选填） └ ticketDesc String 请准时到达指定地点票描述（选填） └ passengerCertificateNo String 212100198902171763 乘客证件号（是必填） └ passengerCertificateType String 1 乘客证件类型（是必填） └ passengerId String 28499930 乘客id（是必填） └ passengerType String 乘客类型 0-普通乘客1-儿童票（是必填）
retCode	String	0	业务结果编码（是必填）
status	String	3	订单状态，参考订单状态编码（是必填）
bookFaildCode	String	1102	订单状态为关闭状态时，返回错误码。1102:班次停运，1104:余票不足，1114：查询不到班次，1401：班次信息有误，不能下单
bookFaildMsg	String	班次停运	参考code说明中的文案

JAVA
.NET
PHP
CURL
Python
C/C++
NodeJS

QimenCloudClient client = new DefaultQimenCloudClient(url, appkey, secret);
AlitripBusOrderQueryRequest req = new AlitripBusOrderQueryRequest();
req.setAgentOrderId("22333333");
req.setAlitripOrderId("33333334444");
AlitripBusOrderQueryResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AlitripBusOrderQueryRequest req = new AlitripBusOrderQueryRequest();
req.AgentOrderId = "22333333";
req.AlitripOrderId = "33333334444";
AlitripBusOrderQueryResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AlitripBusOrderQueryRequest;
$req->setAgentOrderId("22333333");
$req->setAlitripOrderId("33333334444");
$resp = $c->execute($req);

curl -X POST 'http://gw.api.taobao.com/router/rest' \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
-d 'app_key=12129701' \
-d 'format=json' \
-d 'method=qimen.alitrip.bus.order.query' \
-d 'partner_id=apidoc' \
-d 'sign=A2C7D0E2033ECF288F8A25D0C37BBB43' \
-d 'sign_method=hmac' \
-d 'timestamp=2024-04-27+00%3A30%3A38' \
-d 'v=2.0' \
-d 'agentOrderId=22333333' \
-d 'alitripOrderId=33333334444'

# -*- coding: utf-8 -*-
import top.api

req=top.api.QimenAlitripBusOrderQueryRequest(url,port)
req.set_app_info(top.appinfo(appkey,secret))

req.agentOrderId="22333333"
req.alitripOrderId="33333334444"
try:
	resp= req.getResponse()
	print(resp)
except Exception,e:
	print(e)

pTopRequest pRequest = alloc_top_request();
pTopResponse pResponse = NULL;
pTaobaoClient pClient = alloc_taobao_client(url, appkey, appsecret);
set_api_name(pRequest,"qimen.alitrip.bus.order.query");
add_param(pRequest,"agentOrderId","22333333");
add_param(pRequest,"alitripOrderId","33333334444");
pResponse = top_execute(pClient,pRequest,NULL);
printf("ret code:%d\n",pResponse->code);
if(pResponse->code == 0){
	pTopResponseIterator ite = init_response_iterator(pResponse);
	pResultItem pResultItem = alloc_result_item();
	while(parseNext(ite, pResultItem) == 0){
		printf("%s:%s\n",pResultItem->key,pResultItem->value);
	}
	destroy_response_iterator(ite);
	destroy_result_item(pResultItem);
}
destroy_top_request(pRequest);
destroy_top_response(pResponse);
destroy_taobao_client(pClient);

TopClient = require('./topClient').TopClient;
var client = new TopClient({
	'appkey': 'appkey',
	'appsecret': 'secret',
	'REST_URL': 'http://gw.api.taobao.com/router/rest'
});

client.execute('qimen.alitrip.bus.order.query', {
	'agentOrderId':'22333333',
	'alitripOrderId':'33333334444'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<retDesc>成功</retDesc>
<statusDesc>出票成功</statusDesc>
<agentOrderId>13334099888</agentOrderId>
<fetchTicketSpot>成都人民广场</fetchTicketSpot>
<shipNumber>川A 88899</shipNumber>
<success>true</success>
<ticketWicket>检票口</ticketWicket>
<smsContent>出票成功，恭喜您购票，请于2018-11-30日21:30:00准时乘车</smsContent>
<agentIssueTime>2018-11-29 21:00:00</agentIssueTime>
<alitripOrderId>3892200000033</alitripOrderId>
<passengerList>
    <passenger>
        <passengerName>罗大佑</passengerName>
        <ticketList>
            <ticket>
                <ticketPwd>223345</ticketPwd>
                <ticketNo>388888</ticketNo>
                <ticketSeatNo>48</ticketSeatNo>
                <eTicketNo>3333099</eTicketNo>
                <ticketType>1</ticketType>
                <ticketSubType>12</ticketSubType>
                <ticketId>334k</ticketId>
                <ticketStatus>票状态</ticketStatus>
                <ticketRefundSurcharge>200</ticketRefundSurcharge>
                <ticketExpireTime>过期时间</ticketExpireTime>
                <ticketPrice>330</ticketPrice>
                <ticketTitle>船票等</ticketTitle>
                <ticketDesc>请准时到达指定地点</ticketDesc>
            </ticket>
        </ticketList>
        <passengerCertificateNo>212100198902171763</passengerCertificateNo>
        <passengerCertificateType>1</passengerCertificateType>
        <passengerId>28499930</passengerId>
        <passengerType>乘客类型</passengerType>
    </passenger>
</passengerList>
<retCode>0</retCode>
<status>3</status>
<bookFaildCode>1102</bookFaildCode>
<bookFaildMsg>班次停运</bookFaildMsg>

{
    "retDesc":"成功",
    "statusDesc":"出票成功",
    "agentOrderId":"13334099888",
    "fetchTicketSpot":"成都人民广场",
    "shipNumber":"川A 88899",
    "success":true,
    "ticketWicket":"检票口",
    "smsContent":"出票成功，恭喜您购票，请于2018-11-30日21:30:00准时乘车",
    "agentIssueTime":"2018-11-29 21:00:00",
    "alitripOrderId":"3892200000033",
    "passengerList":{
        "passenger":[
            {
                "passengerName":"罗大佑",
                "ticketList":{
                    "ticket":[
                        {
                            "ticketPwd":"223345",
                            "ticketNo":"388888",
                            "ticketSeatNo":"48",
                            "eTicketNo":"3333099",
                            "ticketType":"1",
                            "ticketSubType":"12",
                            "ticketId":"334k",
                            "ticketStatus":"票状态",
                            "ticketRefundSurcharge":200,
                            "ticketExpireTime":"过期时间",
                            "ticketPrice":330,
                            "ticketTitle":"船票等",
                            "ticketDesc":"请准时到达指定地点"
                        }
                    ]
                },
                "passengerCertificateNo":"212100198902171763",
                "passengerCertificateType":"1",
                "passengerId":"28499930",
                "passengerType":"乘客类型"
            }
        ]
    },
    "retCode":"0",
    "status":"3",
    "bookFaildCode":"1102",
    "bookFaildMsg":"班次停运"
}

XML示例
JSON示例

<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

{
	"error_response":{
		"msg":"Remote service error",
		"code":50,
		"sub_msg":"非法参数",
		"sub_code":"isv.invalid-parameter"
	}
}

错误码	错误描述	解决方案

API测试工具错误码查询工具 SDK下载

开放平台

综合交通-商家对接

qimen.alitrip.bus.order.query (查询订单接口)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ