淘宝开放平台

请求地址：

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

名称	类型	是否必须	示例值	描述
tenant_key	String	必须	10006373010	租户身份信息
token	String	必须	JrQpsbkXry5E/ix0lQnyAKYkVvIb0mE5AAehkij6PI21zuSQ597CtBfHbR3r40PB	用户登录token
order_param	CreateOrderParam	必须		预订参数
└ breakfast_name String 可选 No breakfast 早餐名称 └ out_room_id Number 必须 123 外部outRoomId └ gid Number 必须 123 宝贝ID └ room_number Number 可选 1 预订酒店房间数 └ shid Number 必须 123123 标准静态信息库酒店id └ member_level String 可选 level 1 会员可见等级 └ hotel_id String 必须 213123 外部酒店id └ children_number Number 可选 0 儿童数量 └ rp_id Number 必须 4156 内部rpId └ person_number Number 可选 1 成人数量 └ hotel_name String 必须 Hotel California 酒店名称 └ check_in_date String 必须 2021-03-05 入住时间 └ adult_number Number 可选 1 成人数量 └ room_id Number 必须 123 房间Id └ rate_id Number 必须 213 价格id └ payment_type Number 必须 1 支付类型 └ payment_channel String 必须 AP_WECHAT 支付渠道 └ customer_phone String 必须 15609286863 入住人电话 └ check_out_date String 必须 2021-03-06 离店时间 └ customer_first_name String 可选 Han 入住人名 └ customer_email String 可选 customerEmail 入住人邮箱 └ customer_last_name String 可选 Zheng 入住人姓 └ rp_name String 可选优享价价格名称 guest_by_room_dtos GuestByRoomDto [] 可选多房间参数 └ contact_first_name String 可选 11 入住人名 └ contact_last_name String 可选 11 入住人姓 └ roomer_number Number 可选 1 当前房间的总人数 └ adult_roomer_number Number 可选 1 成人数 └ child_roomer_number Number 可选 0 儿童数 └ child_ages String [] 可选 [1,2] 儿童年龄数组 └ offer_source_channel String 可选 BMW 活动标识字段 └ offer_id String 可选 13 活动id └ coupon_instance_id Number 可选 123456 优惠券实例id └ rp_code String 可选 RA11 rpcode └ voucher_id String 可选 123456 代金券id └ data_export_agreement Boolean 可选 true 是否同意向境外提供个人信息 derby_voucher_universal_d_t_o DerbyVoucherUniversalDTO 可选权益券相关参数 └ category String 可选 ROOM_DISCOUNT 类型 └ discount_off Number 可选 50 折扣百分比 └ room_type_code String 可选 324567 房型srId └ rate_plan_code String 可选 A70ro 房型rpCode └ is_derby_voucher_room Boolean 可选 true 是否为权益商品 └ member_voucher_card_id String 可选 P2162378B296258 权益卡卡号 └ member_voucher_id String 可选 V2162378B2962719 权益券id └ area_code String 可选 1 1 └ version Number 可选 3688 版本号
order_code	String	可选	1256145615	订单编号
source_query	String	可选	sourceid=aw-cen&utm_term=mar&merchantid=ppc-ach-mar-bai-cn-zh-loc-brz&utm_campaign=ppc-ach-mar-bai-cn-zh-loc-brz&utm_medium=cpc&utm_source=Google&utm_content=cn-zh-all-all	广告追踪信息

名称	类型	示例值	描述
result	Response		默认描述
└ success Boolean true 成功 └ error_code String 123 错误码 content PayParamResult 预订返回 └ pay_sign String 123 签名 └ sign_type String MD5 签名方式 └ package_str String DSA156 数据包 └ nonce_str String asd12316 随机字符串 └ time_stamp String 15641561456 时间戳 └ app_id String wxs4ad8456 小程序id └ book_result Boolean true 预订结果 └ order_code String 1256145615 订单编号 └ error_msg String asdasd 错误信息

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlitripMerchantGalaxyOrderBookRequest req = new AlitripMerchantGalaxyOrderBookRequest();
req.setTenantKey("10006373010");
req.setToken("JrQpsbkXry5E/ix0lQnyAKYkVvIb0mE5AAehkij6PI21zuSQ597CtBfHbR3r40PB");
AlitripMerchantGalaxyOrderBookRequest.CreateOrderParam obj1 = new AlitripMerchantGalaxyOrderBookRequest.CreateOrderParam();
obj1.setBreakfastName("No breakfast");
obj1.setOutRoomId(123L);
obj1.setGid(123L);
obj1.setRoomNumber(1L);
obj1.setShid(123123L);
obj1.setMemberLevel("level 1");
obj1.setHotelId("213123");
obj1.setChildrenNumber(0L);
obj1.setRpId(4156L);
obj1.setPersonNumber(1L);
obj1.setHotelName("Hotel California");
obj1.setCheckInDate("2021-03-05");
obj1.setAdultNumber(1L);
obj1.setRoomId(123L);
obj1.setRateId(213L);
obj1.setPaymentType(1L);
obj1.setPaymentChannel("AP_WECHAT");
obj1.setCustomerPhone("15609286863");
obj1.setCheckOutDate("2021-03-06");
obj1.setCustomerFirstName("Han");
obj1.setCustomerEmail("customerEmail");
obj1.setCustomerLastName("Zheng");
obj1.setRpName("优享价");
List<AlitripMerchantGalaxyOrderBookRequest.GuestByRoomDto> list3 = new ArrayList<AlitripMerchantGalaxyOrderBookRequest.GuestByRoomDto>();
AlitripMerchantGalaxyOrderBookRequest.GuestByRoomDto obj4 = new AlitripMerchantGalaxyOrderBookRequest.GuestByRoomDto();
list3.add(obj4);
obj4.setContactFirstName("11");
obj4.setContactLastName("11");
obj4.setRoomerNumber(1L);
obj4.setAdultRoomerNumber(1L);
obj4.setChildRoomerNumber(0L);
obj4.setChildAges("1,2");
obj1.setGuestByRoomDtos(list3);
obj1.setOfferSourceChannel("BMW");
obj1.setOfferId("13");
obj1.setCouponInstanceId(123456L);
obj1.setRpCode("RA11");
obj1.setVoucherId("123456");
obj1.setDataExportAgreement(true);
AlitripMerchantGalaxyOrderBookRequest.DerbyVoucherUniversalDTO obj5 = new AlitripMerchantGalaxyOrderBookRequest.DerbyVoucherUniversalDTO();
obj5.setCategory("ROOM_DISCOUNT");
obj5.setDiscountOff(50L);
obj5.setRoomTypeCode("324567");
obj5.setRatePlanCode("A70ro");
obj5.setIsDerbyVoucherRoom(true);
obj5.setMemberVoucherCardId("P2162378B296258");
obj5.setMemberVoucherId("V2162378B2962719");
obj1.setDerbyVoucherUniversalDTO(obj5);
obj1.setAreaCode("1");
obj1.setVersion(3688L);
req.setOrderParam(obj1);
req.setOrderCode("1256145615");
req.setSourceQuery("sourceid=aw-cen&utm_term=mar&merchantid=ppc-ach-mar-bai-cn-zh-loc-brz&utm_campaign=ppc-ach-mar-bai-cn-zh-loc-brz&utm_medium=cpc&utm_source=Google&utm_content=cn-zh-all-all");
AlitripMerchantGalaxyOrderBookResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AlitripMerchantGalaxyOrderBookRequest req = new AlitripMerchantGalaxyOrderBookRequest();
req.TenantKey = "10006373010";
req.Token = "JrQpsbkXry5E/ix0lQnyAKYkVvIb0mE5AAehkij6PI21zuSQ597CtBfHbR3r40PB";
AlitripMerchantGalaxyOrderBookRequest.CreateOrderParamDomain obj1 = new AlitripMerchantGalaxyOrderBookRequest.CreateOrderParamDomain();
obj1.BreakfastName = "No breakfast";
obj1.OutRoomId = 123L;
obj1.Gid = 123L;
obj1.RoomNumber = 1L;
obj1.Shid = 123123L;
obj1.MemberLevel = "level 1";
obj1.HotelId = "213123";
obj1.ChildrenNumber = 0L;
obj1.RpId = 4156L;
obj1.PersonNumber = 1L;
obj1.HotelName = "Hotel California";
obj1.CheckInDate = "2021-03-05";
obj1.AdultNumber = 1L;
obj1.RoomId = 123L;
obj1.RateId = 213L;
obj1.PaymentType = 1L;
obj1.PaymentChannel = "AP_WECHAT";
obj1.CustomerPhone = "15609286863";
obj1.CheckOutDate = "2021-03-06";
obj1.CustomerFirstName = "Han";
obj1.CustomerEmail = "customerEmail";
obj1.CustomerLastName = "Zheng";
obj1.RpName = "优享价";
List<AlitripMerchantGalaxyOrderBookRequest.GuestByRoomDtoDomain> list3 = new List<AlitripMerchantGalaxyOrderBookRequest.GuestByRoomDtoDomain>();
AlitripMerchantGalaxyOrderBookRequest.GuestByRoomDtoDomain obj4 = new AlitripMerchantGalaxyOrderBookRequest.GuestByRoomDtoDomain();
list3.Add(obj4);
obj4.ContactFirstName = "11";
obj4.ContactLastName = "11";
obj4.RoomerNumber = 1L;
obj4.AdultRoomerNumber = 1L;
obj4.ChildRoomerNumber = 0L;
obj4.ChildAges = "1,2";
obj1.GuestByRoomDtos= list3;
obj1.OfferSourceChannel = "BMW";
obj1.OfferId = "13";
obj1.CouponInstanceId = 123456L;
obj1.RpCode = "RA11";
obj1.VoucherId = "123456";
obj1.DataExportAgreement = true;
AlitripMerchantGalaxyOrderBookRequest.DerbyVoucherUniversalDTODomain obj5 = new AlitripMerchantGalaxyOrderBookRequest.DerbyVoucherUniversalDTODomain();
obj5.Category = "ROOM_DISCOUNT";
obj5.DiscountOff = 50L;
obj5.RoomTypeCode = "324567";
obj5.RatePlanCode = "A70ro";
obj5.IsDerbyVoucherRoom = true;
obj5.MemberVoucherCardId = "P2162378B296258";
obj5.MemberVoucherId = "V2162378B2962719";
obj1.DerbyVoucherUniversalDTO= obj5;
obj1.AreaCode = "1";
obj1.Version = 3688L;
req.OrderParam_ = obj1;
req.OrderCode = "1256145615";
req.SourceQuery = "sourceid=aw-cen&utm_term=mar&merchantid=ppc-ach-mar-bai-cn-zh-loc-brz&utm_campaign=ppc-ach-mar-bai-cn-zh-loc-brz&utm_medium=cpc&utm_source=Google&utm_content=cn-zh-all-all";
AlitripMerchantGalaxyOrderBookResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AlitripMerchantGalaxyOrderBookRequest;
$req->setTenantKey("10006373010");
$req->setToken("JrQpsbkXry5E/ix0lQnyAKYkVvIb0mE5AAehkij6PI21zuSQ597CtBfHbR3r40PB");
$order_param = new CreateOrderParam;
$order_param->breakfast_name="No breakfast";
$order_param->out_room_id="123";
$order_param->gid="123";
$order_param->room_number="1";
$order_param->shid="123123";
$order_param->member_level="level 1";
$order_param->hotel_id="213123";
$order_param->children_number="0";
$order_param->rp_id="4156";
$order_param->person_number="1";
$order_param->hotel_name="Hotel California";
$order_param->check_in_date="2021-03-05";
$order_param->adult_number="1";
$order_param->room_id="123";
$order_param->rate_id="213";
$order_param->payment_type="1";
$order_param->payment_channel="AP_WECHAT";
$order_param->customer_phone="15609286863";
$order_param->check_out_date="2021-03-06";
$order_param->customer_first_name="Han";
$order_param->customer_email="customerEmail";
$order_param->customer_last_name="Zheng";
$order_param->rp_name="优享价";
$guest_by_room_dtos = new GuestByRoomDto;
$guest_by_room_dtos->contact_first_name="11";
$guest_by_room_dtos->contact_last_name="11";
$guest_by_room_dtos->roomer_number="1";
$guest_by_room_dtos->adult_roomer_number="1";
$guest_by_room_dtos->child_roomer_number="0";
$guest_by_room_dtos->child_ages="[1,2]";
$order_param->guest_by_room_dtos = $guest_by_room_dtos;
$order_param->offer_source_channel="BMW";
$order_param->offer_id="13";
$order_param->coupon_instance_id="123456";
$order_param->rp_code="RA11";
$order_param->voucher_id="123456";
$order_param->data_export_agreement="true";
$derby_voucher_universal_d_t_o = new DerbyVoucherUniversalDTO;
$derby_voucher_universal_d_t_o->category="ROOM_DISCOUNT";
$derby_voucher_universal_d_t_o->discount_off="50";
$derby_voucher_universal_d_t_o->room_type_code="324567";
$derby_voucher_universal_d_t_o->rate_plan_code="A70ro";
$derby_voucher_universal_d_t_o->is_derby_voucher_room="true";
$derby_voucher_universal_d_t_o->member_voucher_card_id="P2162378B296258";
$derby_voucher_universal_d_t_o->member_voucher_id="V2162378B2962719";
$order_param->derby_voucher_universal_d_t_o = $derby_voucher_universal_d_t_o;
$order_param->area_code="1";
$order_param->version="3688";
$req->setOrderParam(json_encode($order_param));
$req->setOrderCode("1256145615");
$req->setSourceQuery("sourceid=aw-cen&utm_term=mar&merchantid=ppc-ach-mar-bai-cn-zh-loc-brz&utm_campaign=ppc-ach-mar-bai-cn-zh-loc-brz&utm_medium=cpc&utm_source=Google&utm_content=cn-zh-all-all");
$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=alitrip.merchant.galaxy.order.book' \
-d 'partner_id=apidoc' \
-d 'sign=EBABCA2877F852585035787E5E9290D8' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-04-30+15%3A09%3A53' \
-d 'v=2.0' \
-d 'order_code=1256145615' \
-d 'order_param=null' \
-d 'source_query=sourceid%3Daw-cen%26utm_term%3Dmar%26merchantid%3Dppc-ach-mar-bai-cn-zh-loc-brz%26utm_campaign%3Dppc-ach-mar-bai-cn-zh-loc-brz%26utm_medium%3Dcpc%26utm_source%3DGoogle%26utm_content%3Dcn-zh-all-all' \
-d 'tenant_key=10006373010' \
-d 'token=JrQpsbkXry5E%2Fix0lQnyAKYkVvIb0mE5AAehkij6PI21zuSQ597CtBfHbR3r40PB'

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

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

req.tenant_key="10006373010"
req.token="JrQpsbkXry5E/ix0lQnyAKYkVvIb0mE5AAehkij6PI21zuSQ597CtBfHbR3r40PB"
req.order_param=""
req.order_code="1256145615"
req.source_query="sourceid=aw-cen&utm_term=mar&merchantid=ppc-ach-mar-bai-cn-zh-loc-brz&utm_campaign=ppc-ach-mar-bai-cn-zh-loc-brz&utm_medium=cpc&utm_source=Google&utm_content=cn-zh-all-all"
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,"alitrip.merchant.galaxy.order.book");
add_param(pRequest,"tenant_key","10006373010");
add_param(pRequest,"token","JrQpsbkXry5E/ix0lQnyAKYkVvIb0mE5AAehkij6PI21zuSQ597CtBfHbR3r40PB");
add_param(pRequest,"order_param","数据结构JSON示例");
add_param(pRequest,"order_code","1256145615");
add_param(pRequest,"source_query","sourceid=aw-cen&utm_term=mar&merchantid=ppc-ach-mar-bai-cn-zh-loc-brz&utm_campaign=ppc-ach-mar-bai-cn-zh-loc-brz&utm_medium=cpc&utm_source=Google&utm_content=cn-zh-all-all");
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('alitrip.merchant.galaxy.order.book', {
	'tenant_key':'10006373010',
	'token':'JrQpsbkXry5E/ix0lQnyAKYkVvIb0mE5AAehkij6PI21zuSQ597CtBfHbR3r40PB',
	'order_param':'数据结构JSON示例',
	'order_code':'1256145615',
	'source_query':'sourceid=aw-cen&utm_term=mar&merchantid=ppc-ach-mar-bai-cn-zh-loc-brz&utm_campaign=ppc-ach-mar-bai-cn-zh-loc-brz&utm_medium=cpc&utm_source=Google&utm_content=cn-zh-all-all'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<alitrip_merchant_galaxy_order_book_response>
    <result>
        <success>true</success>
        <error_code>123</error_code>
        <content>
            <pay_sign>123</pay_sign>
            <sign_type>MD5</sign_type>
            <package_str>DSA156</package_str>
            <nonce_str>asd12316</nonce_str>
            <time_stamp>15641561456</time_stamp>
            <app_id>wxs4ad8456</app_id>
            <book_result>true</book_result>
            <order_code>1256145615</order_code>
        </content>
        <error_msg>asdasd</error_msg>
    </result>
</alitrip_merchant_galaxy_order_book_response>

{
    "alitrip_merchant_galaxy_order_book_response":{
        "result":{
            "success":true,
            "error_code":"123",
            "content":{
                "pay_sign":"123",
                "sign_type":"MD5",
                "package_str":"DSA156",
                "nonce_str":"asd12316",
                "time_stamp":"15641561456",
                "app_id":"wxs4ad8456",
                "book_result":true,
                "order_code":"1256145615"
            },
            "error_msg":"asdasd"
        }
    }
}

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.merchant.galaxy.order.book (星河-订单预订接口)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ