淘宝开放平台 - 文档中心

请求地址：

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

名称	类型	是否必须	示例值	更多限制	描述
outer_hid	String	可选	32432		酒店外部ID
vendor	String	可选	taobao		wendor
start_row	Number	可选	0		分页参数
hid_list	String	可选	123123,123123		酒店Hid list
page_size	Number	可选	13		分页参数
city_code	Number	可选	122112		城市Code
shid	Number	可选	111		标准酒店ID
data_confirm	Number	可选	5		匹配状态
use_open_search	Boolean	可选	false	默认值：false	是否使用opensearch 查询卖家酒店
hotel_name	String	可选	hotel name		酒店名的模糊查询,仅支持在open search 的查询场景中

名称	类型	示例值	描述
result	ResultSet		result
first_result XHotelListInfo firstResult └ total_count Number 0 查询总数 hotel_list Hotel [] 酒店DO集合 └ hid Number 1234342 酒店hid └ remark String 备注酒店修改备注，不入库，记录日志 └ tel String 086123838 酒店电话。格式：国家代码（最长6位）#区号（最长4位）#电话（最长20位）。国家代码提示：中国大陆0086、香港00852、澳门00853、台湾00886 └ hotel_facilities String 0 酒店设施。json格式{设施英文名:true\|false,} └ type String 0 酒店类型。多个code逗号分隔 └ ext String 0 扩展信息 └ city Number 101100 城市编码 └ postal_code String 311400 邮编 └ floors String 0 楼层信息。4-6层 └ seller_nick String 0 卖家昵称 └ description String 万豪酒店酒店中文描述 └ province Number 0 省份编码 └ longitude Number 0 经度 └ data_confirm Number 0 匹配是否人工确认 └ rooms Number 0 房间数 └ currency_code_name String 0 货币类型（编码,字母编码） └ status Number 0 酒店状态。 └ en_desc String 0 英文描述 └ country String 0 domestic=0时，固定China；否则是海外国家编码值 └ hotel_policies String 0 酒店入住政策 └ latitude Number 0 纬度 └ oper_xiaoer_name String 0 操作人信息 └ comment String 0 备注 └ outer_id String 0 外部酒店ID └ down_shelf_type Number 0 下架类型 └ en_addr String 0 英文地址 └ shid Number 0 标准酒店ID └ business String 0 商圈 └ used_name String 0 曾用名 └ pics String 0 图片url链接集合，json 格式 └ room_facilities String 0 房间设施 └ name String 0 酒店名称 └ position_type String 0 坐标类型，现在支持：G : Google:B : 百度;A : 高德;M : Mapbar;L : 灵图 └ billing_process_type Number 0 标识该酒店所走的结算流程 └ district Number 0 地区编码 └ name_e String 0 酒店名称(英文) └ vendor String 0 酒店的销售渠道 └ extend String 0 扩展信息的JSON └ star String 0 酒店档次 └ booking_notice String 0 预订须知 └ domestic Number 0 是否国外 └ decorate_time String 0 装修时间 └ source Number 0 来源 └ address String 杭州市酒店地址 └ seller_id Number 0 卖家ID └ match_status Number 0 匹配状态 └ service String 0 酒店服务。json格式 └ brand String 0 品牌 └ kzzy_tag Number 0 判断该酒店是不是对应的卖家直营 └ opening_time String 0 开业时间 └ ks_room_num Number 0 可售房型数量 └ ks_heathy_room_num Number 0 可售健康房型数量 tag_json_list TagJsonUnit [] 酒店批量查询中, 特殊标签含义的一个集合,集合中有一个 hid,以及对应的 tagJson └ hid Number 121212 酒店hid └ tag_json String {"pure-direct-hotel":0,"direct-manual-order-hotel":1,"ebk-direct-hotel":0,"non-direct-hotel":1,"allow-dingding-business-travel-hotel":1,"willing-dingding-bussiness-travel-hotel":0,"calendar-room-package-hotel":1,"dijiajiajia-hotel":0,"ebk-number-of-confirm-room-hotel":1} 酒店维度特殊标签含义, json: {"pure-direct-hotel":0,"direct-manual-order-hotel":1,"ebk-direct-hotel":0,"non-direct-hotel":1,"allow-dingding-business-travel-hotel":1,"willing-dingding-bussiness-travel-hotel":0,"calendar-room-package-hotel":1,"dijiajiajia-hotel":0,"ebk-number-of-confirm-room-hotel":1} , key含义: pure-direct-hotel 表示纯直连酒店, direct-manual-order-hotel 和 ebk-direct-hotel 和 non-direct-hotel 这三个key对应value都是0 . direct-manual-order-hotel 表示人工承接失败订单的酒店标签。如果某个直连酒店打了该标签，那么直连下单失败以后，允许人工承接订单，由人工跟进 . ebk-direct-hotel 表示 ebk直连酒店标。如果某个酒店打了该标签，那么这个酒店下允许通过ebk发布直连rp . non-direct-hotel 表示卖家非直连酒店标签。如果某个酒店打了该标签，那么该酒店下单不会走直连交易。 allow-dingding-business-travel-hotel 表示允许进入阿里商旅渠道（钉钉）售卖信用住的单体酒店 willing-dingding-bussiness-travel-hotel 表示已签协议愿意加入阿里商旅渠道售卖信用住的单体酒店 . calendar-room-package-hotel 表示酒店可以参加日历房套餐活动包括创建，修改，删除活动信息（高星集团GMV项目） dijiajiajia-hotel 表示底价加价酒店权限标。只有打了该标的酒店才允许维护底价加价规则和包房rp . ebk-number-of-confirm-room-hotel 表示ebk确认订单，是否要输入外部确认号 └ error_code String 0 errorCode └ success Boolean false success └ error_msg String 0 errorMsg

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
XhotelBatchGetRequest req = new XhotelBatchGetRequest();
req.setOuterHid("32432");
req.setVendor("taobao");
req.setStartRow(0L);
req.setHidList("123123,123123");
req.setPageSize(13L);
req.setCityCode(122112L);
req.setShid(111L);
req.setDataConfirm(5L);
req.setUseOpenSearch(false);
req.setHotelName("hotel name");
XhotelBatchGetResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
XhotelBatchGetRequest req = new XhotelBatchGetRequest();
req.OuterHid = "32432";
req.Vendor = "taobao";
req.StartRow = 0L;
req.HidList = "123123,123123";
req.PageSize = 13L;
req.CityCode = 122112L;
req.Shid = 111L;
req.DataConfirm = 5L;
req.UseOpenSearch = false;
req.HotelName = "hotel name";
XhotelBatchGetResponse rsp = client.Execute(req, sessionKey);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new XhotelBatchGetRequest;
$req->setOuterHid("32432");
$req->setVendor("taobao");
$req->setStartRow("0");
$req->setHidList("123123,123123");
$req->setPageSize("13");
$req->setCityCode("122112");
$req->setShid("111");
$req->setDataConfirm("5");
$req->setUseOpenSearch("false");
$req->setHotelName("hotel name");
$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=taobao.xhotel.batch.get' \
-d 'partner_id=apidoc' \
-d 'session=b5b1bc93-7684-4e03-a2ac-34df1d72f6d1' \
-d 'sign=625B1C0B0D8FF008D259CA454E1B04A5' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-05-06+18%3A34%3A21' \
-d 'v=2.0' \
-d 'city_code=122112' \
-d 'data_confirm=5' \
-d 'hid_list=123123%2C123123' \
-d 'hotel_name=hotel+name' \
-d 'outer_hid=32432' \
-d 'page_size=13' \
-d 'shid=111' \
-d 'start_row=0' \
-d 'use_open_search=false' \
-d 'vendor=taobao'

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

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

req.outer_hid="32432"
req.vendor="taobao"
req.start_row=0
req.hid_list="123123,123123"
req.page_size=13
req.city_code=122112
req.shid=111
req.data_confirm=5
req.use_open_search=false
req.hotel_name="hotel name"
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,"taobao.xhotel.batch.get");
add_param(pRequest,"outer_hid","32432");
add_param(pRequest,"vendor","taobao");
add_param(pRequest,"start_row","0");
add_param(pRequest,"hid_list","123123,123123");
add_param(pRequest,"page_size","13");
add_param(pRequest,"city_code","122112");
add_param(pRequest,"shid","111");
add_param(pRequest,"data_confirm","5");
add_param(pRequest,"use_open_search","false");
add_param(pRequest,"hotel_name","hotel name");
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('taobao.xhotel.batch.get', {
	'outer_hid':'32432',
	'vendor':'taobao',
	'start_row':'0',
	'hid_list':'123123,123123',
	'page_size':'13',
	'city_code':'122112',
	'shid':'111',
	'data_confirm':'5',
	'use_open_search':'false',
	'hotel_name':'hotel name'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<xhotel_batch_get_response>
    <result>
        <first_result>
            <total_count>0</total_count>
            <hotel_list>
                <hotel>
                    <hid>1234342</hid>
                    <remark>备注</remark>
                    <tel>086123838</tel>
                    <hotel_facilities>0</hotel_facilities>
                    <type>0</type>
                    <ext>0</ext>
                    <city>101100</city>
                    <postal_code>311400</postal_code>
                    <floors>0</floors>
                    <seller_nick>0</seller_nick>
                    <description>万豪酒店</description>
                    <province>0</province>
                    <longitude>0</longitude>
                    <data_confirm>0</data_confirm>
                    <rooms>0</rooms>
                    <currency_code_name>0</currency_code_name>
                    <status>0</status>
                    <en_desc>0</en_desc>
                    <country>0</country>
                    <hotel_policies>0</hotel_policies>
                    <latitude>0</latitude>
                    <oper_xiaoer_name>0</oper_xiaoer_name>
                    <comment>0</comment>
                    <outer_id>0</outer_id>
                    <down_shelf_type>0</down_shelf_type>
                    <en_addr>0</en_addr>
                    <shid>0</shid>
                    <business>0</business>
                    <used_name>0</used_name>
                    <pics>0</pics>
                    <room_facilities>0</room_facilities>
                    <name>0</name>
                    <position_type>0</position_type>
                    <billing_process_type>0</billing_process_type>
                    <district>0</district>
                    <name_e>0</name_e>
                    <vendor>0</vendor>
                    <extend>0</extend>
                    <star>0</star>
                    <booking_notice>0</booking_notice>
                    <domestic>0</domestic>
                    <decorate_time>0</decorate_time>
                    <source>0</source>
                    <address>杭州市</address>
                    <seller_id>0</seller_id>
                    <match_status>0</match_status>
                    <service>0</service>
                    <brand>0</brand>
                    <kzzy_tag>0</kzzy_tag>
                    <opening_time>0</opening_time>
                    <ks_room_num>0</ks_room_num>
                    <ks_heathy_room_num>0</ks_heathy_room_num>
                </hotel>
            </hotel_list>
            <tag_json_list>
                <tag_json_unit>
                    <hid>121212</hid>
                    <tag_json>{&quot;pure-direct-hotel&quot;:0,&quot;direct-manual-order-hotel&quot;:1,&quot;ebk-direct-hotel&quot;:0,&quot;non-direct-hotel&quot;:1,&quot;allow-dingding-business-travel-hotel&quot;:1,&quot;willing-dingding-bussiness-travel-hotel&quot;:0,&quot;calendar-room-package-hotel&quot;:1,&quot;dijiajiajia-hotel&quot;:0,&quot;ebk-number-of-confirm-room-hotel&quot;:1}</tag_json>
                </tag_json_unit>
            </tag_json_list>
        </first_result>
        <error_code>0</error_code>
        <success>false</success>
        <error_msg>0</error_msg>
    </result>
</xhotel_batch_get_response>

{
    "xhotel_batch_get_response":{
        "result":{
            "first_result":{
                "total_count":0,
                "hotel_list":{
                    "hotel":[
                        {
                            "hid":1234342,
                            "remark":"备注",
                            "tel":"086123838",
                            "hotel_facilities":"0",
                            "type":"0",
                            "ext":"0",
                            "city":101100,
                            "postal_code":"311400",
                            "floors":"0",
                            "seller_nick":"0",
                            "description":"万豪酒店",
                            "province":0,
                            "longitude":0,
                            "data_confirm":0,
                            "rooms":0,
                            "currency_code_name":"0",
                            "status":0,
                            "en_desc":"0",
                            "country":"0",
                            "hotel_policies":"0",
                            "latitude":0,
                            "oper_xiaoer_name":"0",
                            "comment":"0",
                            "outer_id":"0",
                            "down_shelf_type":0,
                            "en_addr":"0",
                            "shid":0,
                            "business":"0",
                            "used_name":"0",
                            "pics":"0",
                            "room_facilities":"0",
                            "name":"0",
                            "position_type":"0",
                            "billing_process_type":0,
                            "district":0,
                            "name_e":"0",
                            "vendor":"0",
                            "extend":"0",
                            "star":"0",
                            "booking_notice":"0",
                            "domestic":0,
                            "decorate_time":"0",
                            "source":0,
                            "address":"杭州市",
                            "seller_id":0,
                            "match_status":0,
                            "service":"0",
                            "brand":"0",
                            "kzzy_tag":0,
                            "opening_time":"0",
                            "ks_room_num":0,
                            "ks_heathy_room_num":0
                        }
                    ]
                },
                "tag_json_list":{
                    "tag_json_unit":[
                        {
                            "hid":121212,
                            "tag_json":"{\"pure-direct-hotel\":0,\"direct-manual-order-hotel\":1,\"ebk-direct-hotel\":0,\"non-direct-hotel\":1,\"allow-dingding-business-travel-hotel\":1,\"willing-dingding-bussiness-travel-hotel\":0,\"calendar-room-package-hotel\":1,\"dijiajiajia-hotel\":0,\"ebk-number-of-confirm-room-hotel\":1}"
                        }
                    ]
                }
            },
            "error_code":"0",
            "success":false,
            "error_msg":"0"
        }
    }
}

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

开放平台

EBK上云API

taobao.xhotel.batch.get (卖家酒店列表查询)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ