淘宝开放平台 - 文档中心

请求地址：

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

名称	类型	是否必须	示例值	更多限制	描述
hotel_info_param	HotelInfoParam	可选			参数封装模型
└ city_code Number 可选 110100 城市code └ last_shid Number 可选 654543 上次请求的分页数据中最后一个shid └ page_size Number 可选 20 每页数据量 └ pid String 可选 452346 pid └ shid Number 可选 645643 单个请求的shid └ open_id String 可选 ferg3452t 经过混淆的userId

名称	类型	示例值	描述
result	ResultSet		查询结果集
└ channel_id String 1 渠道id └ error Boolean false 本次请求是否错误 └ error_code String err_001 errorCode，error=true时有值 └ error_msg String 查询错误错误信息，error=true时有值 └ h5_list_url String http: //h5.m.taobao.net/trip/hotel/order/order-confirm.html?id=10909001075&iid=2100521217078&rpid=2438001075&paymenttype=1&shid=10005252&hid=0&allbseller=1&sellerId=-1&ttid=12gao0000004 list页h5链接 └ has_next Boolean true 当前数据集合是否还有下一页 └ hotel_list_url String http: //kezhan.trip.taobao.com/order/auction/buy_now.htm?city=110100&id=2100521217078&rpId=2438001075 list页pc链接 └ request_id String 3242432f3f23 请求id，用于链路追踪 results SHotelVo [] 每个标准酒店及房型信息集合 └ address String 杭州市西湖断桥地址 └ bnb_hotel Boolean false 是否是民宿 └ brand String 2 品牌code └ check_in_time String 14:00 最早入住时间 └ check_out_time String 12:00 最晚离店时间 └ city Number 310100 当前酒店所在城市 └ decorate_time String 2009 装修时间 └ desc String 酒店特色鲜明，欢迎入住！酒店描述 └ distance Number 与某个POI的距离 └ district Number 310101 区县 └ gmt_modified Date 2020-01-15 00:00:00 最后修改时间 └ h5_detail_url String http://h5.m.taobao.com/trip/hotel/detail/detail.html?hid=0&shid=10107739&checkin=2014-05-12&checkout=2014-05-13&curcitycode=110100 h5详情页url └ hotel_detail_url String http://kezhan.trip.taobao.com/hotel_detail2.htm?shid=10004405&searchBy=yisou&requestId=1232322313 默认PC详情页url └ hotel_facilities String 收费停车场酒店设施文案 └ lat String 23.04050 维度 level NameValuePair 档次 └ code String 0 档次code └ name String 无档次档次名称 └ lng String 123.004243 经度 └ name String 测试酒店酒店中文名 └ opening_time String 2010 开业时间 └ pet_info String 禁止携带宠物重复信息 └ pic_urls String http://img08.taobaocdn.com/bao/uploaded/i8/T1v5JOFptbXXaAGmMT_013104.jpg,http://img04.taobaocdn.com/bao/uploaded/i4/T1TPVNFwFcXXaAGmMT_013104.jpg 图片信息 └ price Number 23400 价格 └ province Number 310000 省份 └ rate_number Number 23 评论数 └ rate_score String 4.5 评分 └ sell Number 1231 销量 └ shid Number 3455666 标准酒店id shotel_properties_vo ShotelPropertiesSetVo 服务设施集合类 shotel_booking_notics ShotelPropertiesVo [] 预订须知 └ id Number 4234 条目id └ order_num Number 1 排序 └ shid Number 3455666 所属shid └ srid Number 所属srid，如果是酒店上属性，则该字段无值 └ sub_type String -1 二级分类 └ type Number 10 一级分类，10-预订须知 └ type_id String 10001 二级服务设施字典code,10001--入店时间, 10002--离店时间, 10003--酒店政策, 10004--加床收费, 10005--额外收费, 10006--其他说明, 10007--酒店位于山顶, 10008--需坐船前往, 10009--位于景区内 └ value String 14:00 实际内容 shotel_fun_facilities ShotelPropertiesVo [] 娱乐设施 └ id Number 545345 条目id └ order_num Number 1 排序 └ shid Number 3455666 所属shid └ srid Number 所属srid，如果是酒店上属性，则该字段无值 └ sub_type String -1 二级分类 └ type Number 50 一级分类，50-娱乐设施 └ type_id String 24167 二级服务设施字典 └ value String 私人海滩实际内容 shotel_hotel_facilities ShotelPropertiesVo [] 酒店设施 └ id Number 75675 条目id └ order_num Number 1 排序 └ shid Number 3455666 所属shid └ srid Number 所属srid，如果是酒店上属性，则该字段无值 └ sub_type String 1 二级分类 └ type Number 20 一级分类，20-酒店设施 └ type_id String 24001 二级服务设施字典 └ value String 收费停车场实际内容 shotel_hotel_services ShotelPropertiesVo [] 酒店服务 └ id Number 876 条目id └ order_num Number 1 排序 └ shid Number 3455666 所属shid └ srid Number 所属srid，如果是酒店上属性，则该字段无值 └ sub_type String 1 二级分类二级分类 └ type Number 30 一级分类，30-酒店服务 └ type_id String 24058 二级服务设施字典 └ value String 可接待外宾实际内容 shotel_nomal_pictures ShotelPropertiesVo [] 酒店普通图 └ id Number 3056725 条目id └ order_num Number 1 排序 └ shid Number 3455666 所属shid └ srid Number 所属srid，如果是酒店上属性，则该字段无值；这里为空 └ sub_type String 外观二级分类，如外观、公共区域、设施、房间 └ type Number 1 一级分类，1--普通图 └ type_id String 二级服务设施字典 └ value String //img08.taobaocdn.com/bao/uploaded/i8/T1v5JOFptbXXaAGmMT_013104.jpg 实际内容 shotel_room_facilities ShotelPropertiesVo [] 酒店维度的房间设施 └ id Number 456573 条目id └ order_num Number 1 排序 └ shid Number 3455666 所属shid └ srid Number 所属srid，如果是酒店上属性，则该字段无值 └ sub_type String 3 二级分类 └ type Number 40 一级分类，40-房间设施 └ type_id String 24100 二级服务设施字典 └ value String 公共卫浴实际内容 sroom_types SRoomTypeVo [] 标准房型列表 └ add_bed Number 0 是否可加床，0--不可，1--可以 └ area String 34 面积 └ facility String 独立卫浴设施文本 └ floor String 3-6 所在楼层 └ gmt_create Date 2020-02-14 00:00:00 创建时间 └ gmt_modified Date 2020-02-15 00:00:00 最后修改时间 └ max_occupancy Number 2 最大入住人数 └ name String 大床房房型中文名 └ name_e String StandardRoom 房型英文名 room_type_bed_info RoomTypeBedInfoVo 床型结构化信息 bed_info_groups BedInfoGroupVo [] 或关系床型集合 bed_infos BedInfoVo [] 和关系床型集合 └ bed_num Number 1 床数量 └ bed_type String 2 床型 └ desc String 双人床描述 └ length String 2.0 床长 └ width String 1.8 长款 └ bed_num Number 1 床数量 └ brief_desc String 大床简短描述，用于详情页报价前面的床型展示 └ classification String 1 分类，大类，用于搜索的筛选项。1:大床,2:双床,3:单人床,4:多床 └ classification_desc String 大床分类描述 └ desc String 大床描述，长描述，描述为最详细的内容，用于详情页房型详情Dialog，下单页，订单页展示 └ fuzzy_desc String 大床模糊描述，最精简的描述信息，大床/双床/单人床/多床/床位简单描述，较长描述省略床宽 └ simple_desc String 大床简单描述，较长描述省略床宽，但依然会描述具体的床型信息，用于详情页标准房型床型展示 └ brief_desc String 大床简短描述，用于详情页报价前面的床型展示。 └ classifications String [] 1 分类，大类，用于搜索的筛选项 └ classification_desc String 大床分类描述 └ desc String 一张大床1.8米描述，长描述，描述为最详细的内容，用于详情页房型详情Dialog，下单页，订单页展示 └ fuzzy_desc String 大床模糊描述，最精简的描述信息，大床/双床/单人床/多床/床位简单描述，较长描述省略床宽 └ simple_desc String 大床简单描述，较长描述省略床宽，但依然会描述具体的床型信息，用于详情页标准房型床型展示 └ shid Number 3455666 所属标准酒店id └ srid Number 222 标准房型id └ status Number 0 上下架状态，0--下架，其他状态-下架 └ window_type String 1 窗型，0--无窗,1--有窗,2--部分有窗,3--暗窗,4--部分暗窗 └ pic_urls String //img.alicdn.com/bao/uploaded/i1/TB1CJfPNXXXXXaUapXX0o0u.pXX_102405.jpg,//img.alicdn.com/bao/uploaded/i8/TB1k0oqNXXXXXcRXXXX0o0u.pXX_102405.jpg 房型图片，多值使用英文逗号拼接 sroom_type_properties SRoomTypePropertiesSetVo 房型附加属性集合 sroom_type_nomal_pictures ShotelPropertiesVo [] 标准房型普通图集合 └ id Number 2424 属性条目id，定位数据时使用 └ order_num Number 1 排序，按数字升序 └ shid Number 3455666 房型所属shid └ srid Number 222 当前房型srid └ sub_type String 客房图片二级类型，房型上为“客房” └ type Number 1 附加属性类型，普通图type=1 └ type_id String 345 当前属性对应的编码id └ value String //img.alicdn.com/bao/uploaded/i3/TB1dYq2PpXXXXXBXFXXEYRw9FXX_042838.jpg 属性值，图片类型为url sroom_type_room_facilities ShotelPropertiesVo [] 房间设施集合 └ id Number 34 属性条目id，定位数据时使用 └ order_num Number 1 排序，按数字升序 └ shid Number 3455666 房型所属shid └ srid Number 222 当前房型srid └ sub_type String 1 房间设施二级类型，1--电话，2--上网，3--卫浴，4--景观，5--媒体，6--服务，7--安睡，-1--其他 └ type Number 40 附加属性类型，房间设施为40 └ type_id String 24088 当前设施属性对应的编码id └ value String 国内长途（收费）房间设施名称 └ star String 0 档次，0--无档次，2--二星及经济，3--舒适，4--高档，5--豪华 └ status Number 0 上下架状态，0--下架，其他状态-下架 └ tel String 0086-0571-12345 电话 └ type String 1,2 酒店业务分类 └ rooms Number 23 客房数 └ success Boolean false 是否成功标记 └ success_flag Number 0 成功标志 └ total_results Number 12 总数据量 └ version Number 2.3 数据版本 └ last_id Number 3455667 分页查询结果中最后一个id，配合hasNext进行分页查询的性能优化

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
XhotelInfoListGetForHelloRequest req = new XhotelInfoListGetForHelloRequest();
XhotelInfoListGetForHelloRequest.HotelInfoParam obj1 = new XhotelInfoListGetForHelloRequest.HotelInfoParam();
obj1.setCityCode(110100L);
obj1.setLastShid(654543L);
obj1.setPageSize(20L);
obj1.setPid("452346");
obj1.setShid(645643L);
obj1.setOpenId("ferg3452t");
req.setHotelInfoParam(obj1);
XhotelInfoListGetForHelloResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
XhotelInfoListGetForHelloRequest req = new XhotelInfoListGetForHelloRequest();
XhotelInfoListGetForHelloRequest.HotelInfoParamDomain obj1 = new XhotelInfoListGetForHelloRequest.HotelInfoParamDomain();
obj1.CityCode = 110100L;
obj1.LastShid = 654543L;
obj1.PageSize = 20L;
obj1.Pid = "452346";
obj1.Shid = 645643L;
obj1.OpenId = "ferg3452t";
req.HotelInfoParam_ = obj1;
XhotelInfoListGetForHelloResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new XhotelInfoListGetForHelloRequest;
$hotel_info_param = new HotelInfoParam;
$hotel_info_param->city_code="110100";
$hotel_info_param->last_shid="654543";
$hotel_info_param->page_size="20";
$hotel_info_param->pid="452346";
$hotel_info_param->shid="645643";
$hotel_info_param->open_id="ferg3452t";
$req->setHotelInfoParam(json_encode($hotel_info_param));
$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=taobao.xhotel.info.list.get.for.hello' \
-d 'partner_id=apidoc' \
-d 'sign=ACE2C30A5BC34C9116C873536D3F52ED' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-05-14+16%3A54%3A43' \
-d 'v=2.0' \
-d 'hotel_info_param=null'

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

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

req.hotel_info_param=""
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,"taobao.xhotel.info.list.get.for.hello");
add_param(pRequest,"hotel_info_param","数据结构JSON示例");
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('taobao.xhotel.info.list.get.for.hello', {
	'hotel_info_param':'数据结构JSON示例'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<xhotel_info_list_get_for_hello_response>
    <result>
        <channel_id>1</channel_id>
        <error>false</error>
        <error_code>err_001</error_code>
        <error_msg>查询错误</error_msg>
        <h5_list_url>http: //h5.m.taobao.net/trip/hotel/order/order-confirm.html?id=10909001075&amp;iid=2100521217078&amp;rpid=2438001075&amp;paymenttype=1&amp;shid=10005252&amp;hid=0&amp;allbseller=1&amp;sellerId=-1&amp;ttid=12gao0000004</h5_list_url>
        <has_next>true</has_next>
        <hotel_list_url>http: //kezhan.trip.taobao.com/order/auction/buy_now.htm?city=110100&amp;id=2100521217078&amp;rpId=2438001075</hotel_list_url>
        <request_id>3242432f3f23</request_id>
        <results>
            <s_hotel_vo>
                <address>杭州市西湖断桥</address>
                <bnb_hotel>false</bnb_hotel>
                <brand>2</brand>
                <check_in_time>14:00</check_in_time>
                <check_out_time>12:00</check_out_time>
                <city>310100</city>
                <decorate_time>2009</decorate_time>
                <desc>酒店特色鲜明，欢迎入住！</desc>
                <distance></distance>
                <district>310101</district>
                <gmt_modified>2020-01-15 00:00:00</gmt_modified>
                <h5_detail_url>http://h5.m.taobao.com/trip/hotel/detail/detail.html?hid=0&amp;shid=10107739&amp;checkin=2014-05-12&amp;checkout=2014-05-13&amp;curcitycode=110100</h5_detail_url>
                <hotel_detail_url>http://kezhan.trip.taobao.com/hotel_detail2.htm?shid=10004405&amp;searchBy=yisou&amp;requestId=1232322313</hotel_detail_url>
                <hotel_facilities>收费停车场</hotel_facilities>
                <lat>23.04050</lat>
                <level>
                    <code>0</code>
                    <name>无档次</name>
                </level>
                <lng>123.004243</lng>
                <name>测试酒店</name>
                <opening_time>2010</opening_time>
                <pet_info>禁止携带宠物</pet_info>
                <pic_urls>http://img08.taobaocdn.com/bao/uploaded/i8/T1v5JOFptbXXaAGmMT_013104.jpg,http://img04.taobaocdn.com/bao/uploaded/i4/T1TPVNFwFcXXaAGmMT_013104.jpg</pic_urls>
                <price>23400</price>
                <province>310000</province>
                <rate_number>23</rate_number>
                <rate_score>4.5</rate_score>
                <sell>1231</sell>
                <shid>3455666</shid>
                <shotel_properties_vo>
                    <shotel_booking_notics>
                        <shotel_properties_vo>
                            <id>4234</id>
                            <order_num>1</order_num>
                            <shid>3455666</shid>
                            <srid></srid>
                            <sub_type>-1</sub_type>
                            <type>10</type>
                            <type_id>10001</type_id>
                            <value>14:00</value>
                        </shotel_properties_vo>
                    </shotel_booking_notics>
                    <shotel_fun_facilities>
                        <shotel_properties_vo>
                            <id>545345</id>
                            <order_num>1</order_num>
                            <shid>3455666</shid>
                            <srid></srid>
                            <sub_type>-1</sub_type>
                            <type>50</type>
                            <type_id>24167</type_id>
                            <value>私人海滩</value>
                        </shotel_properties_vo>
                    </shotel_fun_facilities>
                    <shotel_hotel_facilities>
                        <shotel_properties_vo>
                            <id>75675</id>
                            <order_num>1</order_num>
                            <shid>3455666</shid>
                            <srid></srid>
                            <sub_type>1</sub_type>
                            <type>20</type>
                            <type_id>24001</type_id>
                            <value>收费停车场</value>
                        </shotel_properties_vo>
                    </shotel_hotel_facilities>
                    <shotel_hotel_services>
                        <shotel_properties_vo>
                            <id>876</id>
                            <order_num>1</order_num>
                            <shid>3455666</shid>
                            <srid></srid>
                            <sub_type>1</sub_type>
                            <type>30</type>
                            <type_id>24058</type_id>
                            <value>可接待外宾</value>
                        </shotel_properties_vo>
                    </shotel_hotel_services>
                    <shotel_nomal_pictures>
                        <shotel_properties_vo>
                            <id>3056725</id>
                            <order_num>1</order_num>
                            <shid>3455666</shid>
                            <srid></srid>
                            <sub_type>外观</sub_type>
                            <type>1</type>
                            <type_id></type_id>
                            <value>//img08.taobaocdn.com/bao/uploaded/i8/T1v5JOFptbXXaAGmMT_013104.jpg</value>
                        </shotel_properties_vo>
                    </shotel_nomal_pictures>
                    <shotel_room_facilities>
                        <shotel_properties_vo>
                            <id>456573</id>
                            <order_num>1</order_num>
                            <shid>3455666</shid>
                            <srid></srid>
                            <sub_type>3</sub_type>
                            <type>40</type>
                            <type_id>24100</type_id>
                            <value>公共卫浴</value>
                        </shotel_properties_vo>
                    </shotel_room_facilities>
                </shotel_properties_vo>
                <sroom_types>
                    <s_room_type_vo>
                        <add_bed>0</add_bed>
                        <area>34</area>
                        <facility>独立卫浴</facility>
                        <floor>3-6</floor>
                        <gmt_create>2020-02-14 00:00:00</gmt_create>
                        <gmt_modified>2020-02-15 00:00:00</gmt_modified>
                        <max_occupancy>2</max_occupancy>
                        <name>大床房</name>
                        <name_e>StandardRoom</name_e>
                        <room_type_bed_info>
                            <bed_info_groups>
                                <bed_info_group_vo>
                                    <bed_infos>
                                        <bed_info_vo>
                                            <bed_num>1</bed_num>
                                            <bed_type>2</bed_type>
                                            <desc>双人床</desc>
                                            <length>2.0</length>
                                            <width>1.8</width>
                                        </bed_info_vo>
                                    </bed_infos>
                                    <bed_num>1</bed_num>
                                    <brief_desc>大床</brief_desc>
                                    <classification>1</classification>
                                    <classification_desc>大床</classification_desc>
                                    <desc>大床</desc>
                                    <fuzzy_desc>大床</fuzzy_desc>
                                    <simple_desc>大床</simple_desc>
                                </bed_info_group_vo>
                            </bed_info_groups>
                            <brief_desc>大床</brief_desc>
                            <classifications>
                                <string>1</string>
                            </classifications>
                            <classification_desc>大床</classification_desc>
                            <desc>一张大床1.8米</desc>
                            <fuzzy_desc>大床</fuzzy_desc>
                            <simple_desc>大床</simple_desc>
                        </room_type_bed_info>
                        <shid>3455666</shid>
                        <srid>222</srid>
                        <status>0</status>
                        <window_type>1</window_type>
                        <pic_urls>//img.alicdn.com/bao/uploaded/i1/TB1CJfPNXXXXXaUapXX0o0u.pXX_102405.jpg,//img.alicdn.com/bao/uploaded/i8/TB1k0oqNXXXXXcRXXXX0o0u.pXX_102405.jpg</pic_urls>
                        <sroom_type_properties>
                            <sroom_type_nomal_pictures>
                                <shotel_properties_vo>
                                    <id>2424</id>
                                    <order_num>1</order_num>
                                    <shid>3455666</shid>
                                    <srid>222</srid>
                                    <sub_type>客房</sub_type>
                                    <type>1</type>
                                    <type_id>345</type_id>
                                    <value>//img.alicdn.com/bao/uploaded/i3/TB1dYq2PpXXXXXBXFXXEYRw9FXX_042838.jpg</value>
                                </shotel_properties_vo>
                            </sroom_type_nomal_pictures>
                            <sroom_type_room_facilities>
                                <shotel_properties_vo>
                                    <id>34</id>
                                    <order_num>1</order_num>
                                    <shid>3455666</shid>
                                    <srid>222</srid>
                                    <sub_type>1</sub_type>
                                    <type>40</type>
                                    <type_id>24088</type_id>
                                    <value>国内长途（收费）</value>
                                </shotel_properties_vo>
                            </sroom_type_room_facilities>
                        </sroom_type_properties>
                    </s_room_type_vo>
                </sroom_types>
                <star>0</star>
                <status>0</status>
                <tel>0086-0571-12345</tel>
                <type>1,2</type>
                <rooms>23</rooms>
            </s_hotel_vo>
        </results>
        <success>false</success>
        <success_flag>0</success_flag>
        <total_results>12</total_results>
        <version>2.3</version>
        <last_id>3455667</last_id>
    </result>
</xhotel_info_list_get_for_hello_response>

{
    "xhotel_info_list_get_for_hello_response":{
        "result":{
            "channel_id":"1",
            "error":false,
            "error_code":"err_001",
            "error_msg":"查询错误",
            "h5_list_url":"http: \/\/h5.m.taobao.net\/trip\/hotel\/order\/order-confirm.html?id=10909001075&iid=2100521217078&rpid=2438001075&paymenttype=1&shid=10005252&hid=0&allbseller=1&sellerId=-1&ttid=12gao0000004",
            "has_next":true,
            "hotel_list_url":"http: \/\/kezhan.trip.taobao.com\/order\/auction\/buy_now.htm?city=110100&id=2100521217078&rpId=2438001075",
            "request_id":"3242432f3f23",
            "results":{
                "s_hotel_vo":[
                    {
                        "address":"杭州市西湖断桥",
                        "bnb_hotel":false,
                        "brand":"2",
                        "check_in_time":"14:00",
                        "check_out_time":"12:00",
                        "city":310100,
                        "decorate_time":"2009",
                        "desc":"酒店特色鲜明，欢迎入住！",
                        "distance":,
                        "district":310101,
                        "gmt_modified":"2020-01-15 00:00:00",
                        "h5_detail_url":"http:\/\/h5.m.taobao.com\/trip\/hotel\/detail\/detail.html?hid=0&shid=10107739&checkin=2014-05-12&checkout=2014-05-13&curcitycode=110100",
                        "hotel_detail_url":"http:\/\/kezhan.trip.taobao.com\/hotel_detail2.htm?shid=10004405&searchBy=yisou&requestId=1232322313",
                        "hotel_facilities":"收费停车场",
                        "lat":"23.04050",
                        "level":{
                            "code":"0",
                            "name":"无档次"
                        },
                        "lng":"123.004243",
                        "name":"测试酒店",
                        "opening_time":"2010",
                        "pet_info":"禁止携带宠物",
                        "pic_urls":"http:\/\/img08.taobaocdn.com\/bao\/uploaded\/i8\/T1v5JOFptbXXaAGmMT_013104.jpg,http:\/\/img04.taobaocdn.com\/bao\/uploaded\/i4\/T1TPVNFwFcXXaAGmMT_013104.jpg",
                        "price":23400,
                        "province":310000,
                        "rate_number":23,
                        "rate_score":"4.5",
                        "sell":1231,
                        "shid":3455666,
                        "shotel_properties_vo":{
                            "shotel_booking_notics":{
                                "shotel_properties_vo":[
                                    {
                                        "id":4234,
                                        "order_num":1,
                                        "shid":3455666,
                                        "srid":,
                                        "sub_type":"-1",
                                        "type":10,
                                        "type_id":"10001",
                                        "value":"14:00"
                                    }
                                ]
                            },
                            "shotel_fun_facilities":{
                                "shotel_properties_vo":[
                                    {
                                        "id":545345,
                                        "order_num":1,
                                        "shid":3455666,
                                        "srid":,
                                        "sub_type":"-1",
                                        "type":50,
                                        "type_id":"24167",
                                        "value":"私人海滩"
                                    }
                                ]
                            },
                            "shotel_hotel_facilities":{
                                "shotel_properties_vo":[
                                    {
                                        "id":75675,
                                        "order_num":1,
                                        "shid":3455666,
                                        "srid":,
                                        "sub_type":"1",
                                        "type":20,
                                        "type_id":"24001",
                                        "value":"收费停车场"
                                    }
                                ]
                            },
                            "shotel_hotel_services":{
                                "shotel_properties_vo":[
                                    {
                                        "id":876,
                                        "order_num":1,
                                        "shid":3455666,
                                        "srid":,
                                        "sub_type":"1",
                                        "type":30,
                                        "type_id":"24058",
                                        "value":"可接待外宾"
                                    }
                                ]
                            },
                            "shotel_nomal_pictures":{
                                "shotel_properties_vo":[
                                    {
                                        "id":3056725,
                                        "order_num":1,
                                        "shid":3455666,
                                        "srid":,
                                        "sub_type":"外观",
                                        "type":1,
                                        "type_id":"",
                                        "value":"\/\/img08.taobaocdn.com\/bao\/uploaded\/i8\/T1v5JOFptbXXaAGmMT_013104.jpg"
                                    }
                                ]
                            },
                            "shotel_room_facilities":{
                                "shotel_properties_vo":[
                                    {
                                        "id":456573,
                                        "order_num":1,
                                        "shid":3455666,
                                        "srid":,
                                        "sub_type":"3",
                                        "type":40,
                                        "type_id":"24100",
                                        "value":"公共卫浴"
                                    }
                                ]
                            }
                        },
                        "sroom_types":{
                            "s_room_type_vo":[
                                {
                                    "add_bed":0,
                                    "area":"34",
                                    "facility":"独立卫浴",
                                    "floor":"3-6",
                                    "gmt_create":"2020-02-14 00:00:00",
                                    "gmt_modified":"2020-02-15 00:00:00",
                                    "max_occupancy":2,
                                    "name":"大床房",
                                    "name_e":"StandardRoom",
                                    "room_type_bed_info":{
                                        "bed_info_groups":{
                                            "bed_info_group_vo":[
                                                {
                                                    "bed_infos":{
                                                        "bed_info_vo":[
                                                            {
                                                                "bed_num":1,
                                                                "bed_type":"2",
                                                                "desc":"双人床",
                                                                "length":"2.0",
                                                                "width":"1.8"
                                                            }
                                                        ]
                                                    },
                                                    "bed_num":1,
                                                    "brief_desc":"大床",
                                                    "classification":"1",
                                                    "classification_desc":"大床",
                                                    "desc":"大床",
                                                    "fuzzy_desc":"大床",
                                                    "simple_desc":"大床"
                                                }
                                            ]
                                        },
                                        "brief_desc":"大床",
                                        "classifications":{
                                            "string":[
                                                "1"
                                            ]
                                        },
                                        "classification_desc":"大床",
                                        "desc":"一张大床1.8米",
                                        "fuzzy_desc":"大床",
                                        "simple_desc":"大床"
                                    },
                                    "shid":3455666,
                                    "srid":222,
                                    "status":0,
                                    "window_type":"1",
                                    "pic_urls":"\/\/img.alicdn.com\/bao\/uploaded\/i1\/TB1CJfPNXXXXXaUapXX0o0u.pXX_102405.jpg,\/\/img.alicdn.com\/bao\/uploaded\/i8\/TB1k0oqNXXXXXcRXXXX0o0u.pXX_102405.jpg",
                                    "sroom_type_properties":{
                                        "sroom_type_nomal_pictures":{
                                            "shotel_properties_vo":[
                                                {
                                                    "id":2424,
                                                    "order_num":1,
                                                    "shid":3455666,
                                                    "srid":222,
                                                    "sub_type":"客房",
                                                    "type":1,
                                                    "type_id":"345",
                                                    "value":"\/\/img.alicdn.com\/bao\/uploaded\/i3\/TB1dYq2PpXXXXXBXFXXEYRw9FXX_042838.jpg"
                                                }
                                            ]
                                        },
                                        "sroom_type_room_facilities":{
                                            "shotel_properties_vo":[
                                                {
                                                    "id":34,
                                                    "order_num":1,
                                                    "shid":3455666,
                                                    "srid":222,
                                                    "sub_type":"1",
                                                    "type":40,
                                                    "type_id":"24088",
                                                    "value":"国内长途（收费）"
                                                }
                                            ]
                                        }
                                    }
                                }
                            ]
                        },
                        "star":"0",
                        "status":0,
                        "tel":"0086-0571-12345",
                        "type":"1,2",
                        "rooms":23
                    }
                ]
            },
            "success":false,
            "success_flag":0,
            "total_results":12,
            "version":2.3,
            "last_id":3455667
        }
    }
}

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

taobao.xhotel.info.list.get.for.hello (哈罗获取酒店详情)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ