淘宝开放平台 - 文档中心

请求地址：

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

名称	类型	是否必须	示例值	更多限制	描述
bookinfo_id	Number	必须	1212		预定信息id

名称	类型	示例值	描述
first_result	TopTripBookInfoResult		交易预定结果对象
module Module 交易预定详情 └ end_period Date 2017-11-15 19:17:10 时段结束时间 └ sub_tc_order_id Number 1188515074720535300 TC子订单号 └ buyer_nick String c度假测试帐号01 买家昵称 └ pay_time Date 2017-11-15 19:17:10 付款时间 └ book_num Number 1 预约次数 └ start_period Date 2017-11-15 19:17:10 时段开始时间 └ book_order_id Number 25784414 预约订单ID └ modify_time Date 2017-11-15 19:17:10 修改时间 └ book_cell_remark String demo 预约单项备注 └ apply_time Date 2017-11-15 19:17:10 买家申请时间 └ sku_id Number 4432364469563 skuId └ booked_travel_time Date 2017-11-15 19:17:10 预约出发日期 └ order_create_time Date 2017-11-15 19:17:10 下单时间 └ travel_ins_appy_id String demo 预约记录对应的保险保单数据记录ID └ item_id Number 624992324207 商品ID └ biz_type Number 1000 业务类型 └ book_info_id Number 35236941303 预约ID(主键) └ item_title String jj测试_二次预约_境内跟团_请不要拍商品标题 └ tc_order_id Number 1188515074720535300 TC主订单号 └ process_time Date 2017-11-15 19:17:10 卖家审批时间 └ book_cell_name String 套餐1 预约单项名称（子套餐名称） └ booked_travel_return_time Date 2017-11-15 19:17:10 预约返程时间 └ book_cell_id Number 26838 预约单项ID（子套餐ID） └ seller_nick String 商家测试帐号57 卖家昵称 └ book_status Number 3 申请状态 └ only_upate_book_id Boolean false 是否仅更新bookId字段 └ create_time Date 2017-11-15 19:17:10 下单时间 traveller_infos TravellerInfos [] 出行人信息 └ issued_date Date 2017-11-15 19:17:10 证件签发日期 └ last_name String demo 拼音姓 └ biz_type String demo 1：出行管理 2：二次预约 4：二次确认 8: 电子合同 16：电子凭证 32：自定义出行人 64：门票 └ book_info_id Number 35236941303 预约ID └ sub_tc_order_id String demo 子订单ID └ tc_order_id String demo 子订单ID └ credentials_type Number 0 证件类型 └ traveller_name String 预留字段无意义出行人姓名 └ buyer_remark String aa 买家备注 └ modify_time Date 2017-11-15 19:17:10 修改时间 └ person_type String demo 类型出行人（签署人）为0或空，联系人为1 └ sku String demo sku └ credentials_code String demo 证件号码 └ sub_tc_order_ids String demo 根据子订单ID列表查询 └ traveller_name_pinyin String demo 姓名的拼音，格式为：xing/ming,中间以“/”分隔 └ terminal_type String demo 用户是通过哪个终端填写 └ first_name String demo 拼音名 └ item_id String demo 商品ID └ nationality String demo 国籍 └ only_upate_book_id Boolean false 是否仅更新bookId字段 └ create_time Date 2017-11-15 19:17:10 创建时间 └ issued_country String demo 证件签发国 └ telphone String 13999999999 电话 └ traveller_json String [] 自定义出行人的时候的json格式 └ features String [] 扩展属性（json结构，其中outerIdSKU=商家编码）

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlitripTravelBookinfoQueryRequest req = new AlitripTravelBookinfoQueryRequest();
req.setBookinfoId(1212L);
AlitripTravelBookinfoQueryResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AlitripTravelBookinfoQueryRequest req = new AlitripTravelBookinfoQueryRequest();
req.BookinfoId = 1212L;
AlitripTravelBookinfoQueryResponse rsp = client.Execute(req, sessionKey);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AlitripTravelBookinfoQueryRequest;
$req->setBookinfoId("1212");
$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.travel.bookinfo.query' \
-d 'partner_id=apidoc' \
-d 'session=ab360acb-a20c-4c23-b833-4a2ca986e1b2' \
-d 'sign=DAB6B09A28070908EA634EF47F9BF363' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-10-24+13%3A38%3A35' \
-d 'v=2.0' \
-d 'bookinfo_id=1212'

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

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

req.bookinfo_id=1212
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.travel.bookinfo.query");
add_param(pRequest,"bookinfo_id","1212");
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.travel.bookinfo.query', {
	'bookinfo_id':'1212'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<alitrip_travel_bookinfo_query_response>
    <first_result>
        <module>
            <end_period>2017-11-15 19:17:10</end_period>
            <sub_tc_order_id>1188515074720535300</sub_tc_order_id>
            <buyer_nick>c度假测试帐号01</buyer_nick>
            <pay_time>2017-11-15 19:17:10</pay_time>
            <book_num>1</book_num>
            <start_period>2017-11-15 19:17:10</start_period>
            <book_order_id>25784414</book_order_id>
            <modify_time>2017-11-15 19:17:10</modify_time>
            <book_cell_remark>demo</book_cell_remark>
            <apply_time>2017-11-15 19:17:10</apply_time>
            <sku_id>4432364469563</sku_id>
            <booked_travel_time>2017-11-15 19:17:10</booked_travel_time>
            <order_create_time>2017-11-15 19:17:10</order_create_time>
            <travel_ins_appy_id>demo</travel_ins_appy_id>
            <item_id>624992324207</item_id>
            <biz_type>1000</biz_type>
            <book_info_id>35236941303</book_info_id>
            <item_title>jj测试_二次预约_境内跟团_请不要拍</item_title>
            <tc_order_id>1188515074720535300</tc_order_id>
            <process_time>2017-11-15 19:17:10</process_time>
            <book_cell_name>套餐1</book_cell_name>
            <booked_travel_return_time>2017-11-15 19:17:10</booked_travel_return_time>
            <book_cell_id>26838</book_cell_id>
            <seller_nick>商家测试帐号57</seller_nick>
            <book_status>3</book_status>
            <only_upate_book_id>false</only_upate_book_id>
            <create_time>2017-11-15 19:17:10</create_time>
            <traveller_infos>
                <traveller_infos>
                    <issued_date>2017-11-15 19:17:10</issued_date>
                    <last_name>demo</last_name>
                    <biz_type>demo</biz_type>
                    <book_info_id>35236941303</book_info_id>
                    <sub_tc_order_id>demo</sub_tc_order_id>
                    <tc_order_id>demo</tc_order_id>
                    <credentials_type>0</credentials_type>
                    <traveller_name>预留字段无意义</traveller_name>
                    <buyer_remark>aa</buyer_remark>
                    <modify_time>2017-11-15 19:17:10</modify_time>
                    <person_type>demo</person_type>
                    <sku>demo</sku>
                    <credentials_code>demo</credentials_code>
                    <sub_tc_order_ids>demo</sub_tc_order_ids>
                    <traveller_name_pinyin>demo</traveller_name_pinyin>
                    <terminal_type>demo</terminal_type>
                    <first_name>demo</first_name>
                    <item_id>demo</item_id>
                    <nationality>demo</nationality>
                    <only_upate_book_id>false</only_upate_book_id>
                    <create_time>2017-11-15 19:17:10</create_time>
                    <issued_country>demo</issued_country>
                    <telphone>13999999999</telphone>
                    <traveller_json>[]</traveller_json>
                </traveller_infos>
            </traveller_infos>
            <features>[]</features>
        </module>
    </first_result>
</alitrip_travel_bookinfo_query_response>

{
    "alitrip_travel_bookinfo_query_response":{
        "first_result":{
            "module":{
                "end_period":"2017-11-15 19:17:10",
                "sub_tc_order_id":1188515074720535300,
                "buyer_nick":"c度假测试帐号01",
                "pay_time":"2017-11-15 19:17:10",
                "book_num":1,
                "start_period":"2017-11-15 19:17:10",
                "book_order_id":25784414,
                "modify_time":"2017-11-15 19:17:10",
                "book_cell_remark":"demo",
                "apply_time":"2017-11-15 19:17:10",
                "sku_id":4432364469563,
                "booked_travel_time":"2017-11-15 19:17:10",
                "order_create_time":"2017-11-15 19:17:10",
                "travel_ins_appy_id":"demo",
                "item_id":624992324207,
                "biz_type":1000,
                "book_info_id":35236941303,
                "item_title":"jj测试_二次预约_境内跟团_请不要拍",
                "tc_order_id":1188515074720535300,
                "process_time":"2017-11-15 19:17:10",
                "book_cell_name":"套餐1",
                "booked_travel_return_time":"2017-11-15 19:17:10",
                "book_cell_id":26838,
                "seller_nick":"商家测试帐号57",
                "book_status":3,
                "only_upate_book_id":false,
                "create_time":"2017-11-15 19:17:10",
                "traveller_infos":{
                    "traveller_infos":[
                        {
                            "issued_date":"2017-11-15 19:17:10",
                            "last_name":"demo",
                            "biz_type":"demo",
                            "book_info_id":35236941303,
                            "sub_tc_order_id":"demo",
                            "tc_order_id":"demo",
                            "credentials_type":0,
                            "traveller_name":"预留字段无意义",
                            "buyer_remark":"aa",
                            "modify_time":"2017-11-15 19:17:10",
                            "person_type":"demo",
                            "sku":"demo",
                            "credentials_code":"demo",
                            "sub_tc_order_ids":"demo",
                            "traveller_name_pinyin":"demo",
                            "terminal_type":"demo",
                            "first_name":"demo",
                            "item_id":"demo",
                            "nationality":"demo",
                            "only_upate_book_id":false,
                            "create_time":"2017-11-15 19:17:10",
                            "issued_country":"demo",
                            "telphone":"13999999999",
                            "traveller_json":"[]"
                        }
                    ]
                },
                "features":"[]"
            }
        }
    }
}

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.travel.bookinfo.query (飞猪度假-订单二次预约查询接口)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ