淘宝开放平台 - 文档中心

请求地址：

环境	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。

名称	类型	是否必须	示例值	更多限制	描述
query_order_list_req	QueryOrderListReq	必须			请求入参
└ start_time Date 必须 2022-03-22 15:23:44 查询开始时间yyyy-MM-dd HH:mm:ss └ end_time Date 必须 2022-03-22 16:23:44 查询结束时间 yyyy-MM-dd HH:mm:ss └ channel_name String 可选 feiye 接入方提供的用户名

名称	类型	示例值	描述
is_success	Boolean	true	请求是否成功
error_code_info	String	isv.SYSTEM_ERROR	错误码
error_msg	String	系统错误	错误描述
order_list	BaseOrder []		订单列表
└ seller_nick String xxx航空旗舰店卖家昵称 └ order_id Number 1234125412 订单id └ pay_time Date 2022-02-25 11:46:26 支付时间 └ total_price Number 500 订单总价 └ real_pay_price Number 500 实际支付金额 └ alipay_trade_no String 1234523523452345435 支付宝交易号（后续将废弃，请使用trade_no字段） └ order_status String 生单预定成功订单状态 └ book_time Date 2022-02-24 11:46:26 预定时间 └ out_order_no String 1234324786812 外部订单号 passenger_list Passenger [] 乘机人列表 └ birthday Date 2001-08-22 00:00:00 生日yyyy-MM-dd └ credential_type Number 0 证件类型 (0, "身份证"), (1, "护照"), (2, "学生证"), (3, "军人证"), (4, "回乡证"), (5, "台胞证"), (6, "港澳通行证"), (7, "国际海员"), (8, "外国人永久居留证"), (10, "警官证"), (11, "士兵证"), (12, "台湾通行证"), (13, "入台证"), (14, "户口簿"), (15,"出生证明"), (16,"驾照"), (17, "港澳居民居住证"), (18, "台湾居民居住证"), (9, "其他") └ mobile_phone_number String 13512344321 乘机人手机号码(无国家码部分) └ credential_no String 110101199003072770 证件号 └ mobile_country_code String 86 手机号-国家码 └ name String 李四乘机人姓名 └ type Number 0 乘客类型 ADT(0, "普通成人"), CHD(1, "儿童"), INFANT(8, "婴儿") └ session_nick String tb123456 对接此接口的系统商昵称 └ trade_no String 1234523523452345435 交易流水号 └ pay_channel String alipay(支付宝) / yeepay(易宝) 支付渠道

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlitripFlightServiceQueryorderlistRequest req = new AlitripFlightServiceQueryorderlistRequest();
AlitripFlightServiceQueryorderlistRequest.QueryOrderListReq obj1 = new AlitripFlightServiceQueryorderlistRequest.QueryOrderListReq();
obj1.setStartTime(StringUtils.parseDateTime("2022-03-22 15:23:44"));
obj1.setEndTime(StringUtils.parseDateTime("2022-03-22 16:23:44"));
obj1.setChannelName("feiye");
req.setQueryOrderListReq(obj1);
AlitripFlightServiceQueryorderlistResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AlitripFlightServiceQueryorderlistRequest req = new AlitripFlightServiceQueryorderlistRequest();
AlitripFlightServiceQueryorderlistRequest.QueryOrderListReqDomain obj1 = new AlitripFlightServiceQueryorderlistRequest.QueryOrderListReqDomain();
obj1.StartTime = DateTime.Parse(2022-03-22 15:23:44");
obj1.EndTime = DateTime.Parse(2022-03-22 16:23:44");
obj1.ChannelName = "feiye";
req.QueryOrderListReq_ = obj1;
AlitripFlightServiceQueryorderlistResponse rsp = client.Execute(req, sessionKey);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AlitripFlightServiceQueryorderlistRequest;
$query_order_list_req = new QueryOrderListReq;
$query_order_list_req->start_time="2022-03-22 15:23:44";
$query_order_list_req->end_time="2022-03-22 16:23:44";
$query_order_list_req->channel_name="feiye";
$req->setQueryOrderListReq(json_encode($query_order_list_req));
$resp = $c->execute($req, $sessionKey);

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=alitrip.flight.service.queryorderlist' \
-d 'partner_id=apidoc' \
-d 'session=ae03b408-c85e-4e7f-bf81-3ae9054077d5' \
-d 'sign=54652BF0F930F51FA4144DB1A261E805' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-12-06+20%3A45%3A12' \
-d 'v=2.0' \
-d 'query_order_list_req=null'

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

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

req.query_order_list_req="数据结构示例JSON格式"
try:
	resp= req.getResponse(sessionkey)
	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,"alitrip.flight.service.queryorderlist");
add_param(pRequest,"query_order_list_req","数据结构JSON示例");
pResponse = top_execute(pClient,pRequest,sessionKey);
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('alitrip.flight.service.queryorderlist', {
	'query_order_list_req':'数据结构JSON示例'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<alitrip_flight_service_queryorderlist_response>
    <is_success>true</is_success>
    <error_code_info>isv.SYSTEM_ERROR</error_code_info>
    <error_msg>系统错误</error_msg>
    <order_list>
        <base_order>
            <seller_nick>xxx航空旗舰店</seller_nick>
            <order_id>1234125412</order_id>
            <pay_time>2022-02-25 11:46:26</pay_time>
            <total_price>500</total_price>
            <real_pay_price>500</real_pay_price>
            <alipay_trade_no>1234523523452345435</alipay_trade_no>
            <order_status>生单预定成功</order_status>
            <book_time>2022-02-24 11:46:26</book_time>
            <out_order_no>1234324786812</out_order_no>
            <passenger_list>
                <passenger>
                    <birthday>2001-08-22 00:00:00</birthday>
                    <credential_type>0</credential_type>
                    <mobile_phone_number>13512344321</mobile_phone_number>
                    <credential_no>110101199003072770</credential_no>
                    <mobile_country_code>86</mobile_country_code>
                    <name>李四</name>
                    <type>0</type>
                </passenger>
            </passenger_list>
            <session_nick>tb123456</session_nick>
            <trade_no>1234523523452345435</trade_no>
            <pay_channel>alipay(支付宝) / yeepay(易宝)</pay_channel>
        </base_order>
    </order_list>
</alitrip_flight_service_queryorderlist_response>

{
    "alitrip_flight_service_queryorderlist_response":{
        "is_success":true,
        "error_code_info":"isv.SYSTEM_ERROR",
        "error_msg":"系统错误",
        "order_list":{
            "base_order":[
                {
                    "seller_nick":"xxx航空旗舰店",
                    "order_id":1234125412,
                    "pay_time":"2022-02-25 11:46:26",
                    "total_price":500,
                    "real_pay_price":500,
                    "alipay_trade_no":"1234523523452345435",
                    "order_status":"生单预定成功",
                    "book_time":"2022-02-24 11:46:26",
                    "out_order_no":"1234324786812",
                    "passenger_list":{
                        "passenger":[
                            {
                                "birthday":"2001-08-22 00:00:00",
                                "credential_type":0,
                                "mobile_phone_number":"13512344321",
                                "credential_no":"110101199003072770",
                                "mobile_country_code":"86",
                                "name":"李四",
                                "type":0
                            }
                        ]
                    },
                    "session_nick":"tb123456",
                    "trade_no":"1234523523452345435",
                    "pay_channel":"alipay(支付宝) \/ yeepay(易宝)"
                }
            ]
        }
    }
}

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下载

开放平台

国内机票京杭API

alitrip.flight.service.queryorderlist (查询订单列表)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ