飞猪 - 开放平台

请求地址：

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

名称	类型	是否必须	示例值	更多限制	描述
agent_id	Number	必须	8888		代理商ID
trade_order_id	Number	必须	1234		辅营的订单号

名称	类型	示例值	描述
order_vo	VirProOrderVo		orderVO
└ book_time Date 2017-07-01 00:00:00 预订时间，辅营订单创建时间 └ flight_order_id Number 123343 机票订单号 passenger_aux_vos PassengerAuxVo [] 乘机人购买辅营产品详情 aux_product_vo AuxProductVo 辅营产品规格信息 baggage_vo BaggageVo 结构化的行李说明 └ is_all_weight Boolean true 是否为全部重量 └ pc Number 1 行李数量 └ weight Number 15 行李重量，单位KG └ base_price Number 10000 基准价 └ counter_price Number 10000 柜台价 └ online_price Number 90 销售价格 └ outer_id String 2435 外部outerId └ product_name String 行李15Kg 辅营产品名称 └ product_type Number 1 deprecated, 不建议使用 └ sale_type Number 1 销售类型 1:一次销售，2:二次销售，3:不限 seat_vo SeatVo 选座规格信息 └ seat_area Number 1 座位列 1:靠过道，2:靠窗，3:并排 └ seat_row Number 1 排次 1:前排，2:中排，3:后排 └ unity_product_type Number 4 产品类型 4:付费行李，6:值机，7:餐食, 8:值机及选座 └ book_num Number 1 购买数量 flight_vo BookFlightVo 航段信息 └ arr_airport String XXX 到达机场三字码 └ dep_airport String XXX 出发机场三字码 └ dep_time Date 2017-07-01 00:00:00 出发时间 └ flight_cabin String X 仓位 └ flight_number String XX0000 航班号 └ name String my/name 乘机人姓名 └ pay_no String 12345 支付宝流水号，存在多个辅营订单对应一个支付宝流水号的情况 └ pay_price Number 1222 辅营订单金额 └ pay_time Date 2017-07-01 00:00:00 支付时间，订单为支付成功或出货成功时返回 └ order_id Number 123 辅营订单号 └ order_status Number 2 辅营订单状态，1- 待支付 2- 支付成功 3- 辅营出货成功 4- 订单取消 └ contact_phone String 13911111111 联系人电话
page_size	Number	10	pageSize

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlitripTripvpAgentOrderGetRequest req = new AlitripTripvpAgentOrderGetRequest();
req.setAgentId(8888L);
req.setTradeOrderId(1234L);
AlitripTripvpAgentOrderGetResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AlitripTripvpAgentOrderGetRequest req = new AlitripTripvpAgentOrderGetRequest();
req.AgentId = 8888L;
req.TradeOrderId = 1234L;
AlitripTripvpAgentOrderGetResponse rsp = client.Execute(req, sessionKey);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AlitripTripvpAgentOrderGetRequest;
$req->setAgentId("8888");
$req->setTradeOrderId("1234");
$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.tripvp.agent.order.get' \
-d 'partner_id=apidoc' \
-d 'session=aedcc05c-a295-4b25-b9cb-078df6418b64' \
-d 'sign=55A5F9F48436A0DE1AC1060E8B519DE1' \
-d 'sign_method=hmac' \
-d 'timestamp=2024-04-25+05%3A19%3A37' \
-d 'v=2.0' \
-d 'agent_id=8888' \
-d 'trade_order_id=1234'

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

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

req.agent_id=8888
req.trade_order_id=1234
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.tripvp.agent.order.get");
add_param(pRequest,"agent_id","8888");
add_param(pRequest,"trade_order_id","1234");
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.tripvp.agent.order.get', {
	'agent_id':'8888',
	'trade_order_id':'1234'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<alitrip_tripvp_agent_order_get_response>
    <order_vo>
        <book_time>2017-07-01 00:00:00</book_time>
        <flight_order_id>123343</flight_order_id>
        <passenger_aux_vos>
            <passenger_aux_vo>
                <aux_product_vo>
                    <baggage_vo>
                        <is_all_weight>true</is_all_weight>
                        <pc>1</pc>
                        <weight>15</weight>
                    </baggage_vo>
                    <base_price>10000</base_price>
                    <counter_price>10000</counter_price>
                    <online_price>90</online_price>
                    <outer_id>2435</outer_id>
                    <product_name>行李15Kg</product_name>
                    <product_type>1</product_type>
                    <sale_type>1</sale_type>
                    <seat_vo>
                        <seat_area>1</seat_area>
                        <seat_row>1</seat_row>
                    </seat_vo>
                    <unity_product_type>4</unity_product_type>
                </aux_product_vo>
                <book_num>1</book_num>
                <flight_vo>
                    <arr_airport>XXX</arr_airport>
                    <dep_airport>XXX</dep_airport>
                    <dep_time>2017-07-01 00:00:00</dep_time>
                    <flight_cabin>X</flight_cabin>
                    <flight_number>XX0000</flight_number>
                </flight_vo>
                <name>my/name</name>
            </passenger_aux_vo>
        </passenger_aux_vos>
        <pay_no>12345</pay_no>
        <pay_price>1222</pay_price>
        <pay_time>2017-07-01 00:00:00</pay_time>
        <order_id>123</order_id>
        <order_status>2</order_status>
        <contact_phone>13911111111</contact_phone>
    </order_vo>
    <page_size>10</page_size>
</alitrip_tripvp_agent_order_get_response>

{
    "alitrip_tripvp_agent_order_get_response":{
        "order_vo":{
            "book_time":"2017-07-01 00:00:00",
            "flight_order_id":123343,
            "passenger_aux_vos":{
                "passenger_aux_vo":[
                    {
                        "aux_product_vo":{
                            "baggage_vo":{
                                "is_all_weight":true,
                                "pc":1,
                                "weight":15
                            },
                            "base_price":10000,
                            "counter_price":10000,
                            "online_price":90,
                            "outer_id":"2435",
                            "product_name":"行李15Kg",
                            "product_type":1,
                            "sale_type":1,
                            "seat_vo":{
                                "seat_area":1,
                                "seat_row":1
                            },
                            "unity_product_type":4
                        },
                        "book_num":1,
                        "flight_vo":{
                            "arr_airport":"XXX",
                            "dep_airport":"XXX",
                            "dep_time":"2017-07-01 00:00:00",
                            "flight_cabin":"X",
                            "flight_number":"XX0000"
                        },
                        "name":"my\/name"
                    }
                ]
            },
            "pay_no":"12345",
            "pay_price":1222,
            "pay_time":"2017-07-01 00:00:00",
            "order_id":123,
            "order_status":2,
            "contact_phone":"13911111111"
        },
        "page_size":10
    }
}

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

开放平台

国际机票-代理商

alitrip.tripvp.agent.order.get (廉航辅营正向订单查询详情接口)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ