淘宝开放平台

请求地址：

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

名称	类型	是否必须	示例值	描述
vendor	String	可选	taobao	卖家渠道如果gid为空，那么out_rid和vendor都不能为空。支持通过gid或者通过out_rid和vendor来获取商品
out_rid	String	可选	123321	外部房型id 如果gid为空，那么out_rid和vendor都不能为空支持通过gid或者通过out_rid和vendor来获取商品
gid	Number	可选	100000	废弃

名称	类型	示例值	描述
room	FirstResult		房间信息
└ receipt_other_type_desc String bbb 发票类型为其他时的发票描述,不能超过30个汉字，60个字符 └ receipt_type String 1 发票类型。A,B。分别代表： A:酒店住宿发票,B:其他 └ has_receipt Boolean true 酒店商品是否提供发票 └ pic_urls String 123456,4444444 酒店商品图片Url。多个url用逗号隔开 └ desc String aaa 宝贝描述 └ guide String bbb 购买须知 └ title String aaa 宝贝名称 └ rid Number 123456 rid房型id └ hid Number 123456 hid酒店id └ iid Number 123456 iid淘宝商品id └ gid Number 123456 gid酒店商品id └ receipt_info String aaa 发票说明，不能超过100个汉字,200个字符。 └ inventory String bbb 库存日历 └ status Number 1 宝贝状态。1：上架。2：下架。3：删除 └ recommend Boolean true 橱窗推荐 └ created_time Date 2000-01-01 00:00:00 创建时间 └ modified_time Date 2000-01-01 00:00:00 修改时间 └ extend_info1 String aaa extend_info1 └ extend_info2 String bbb extend_info2 └ extend_info3 String ccc extend_info3 └ vendor String taobao 卖家渠道 └ out_rid String 123456 out_rid └ down_reason String demo 商品下架原因 └ switch_calendar String [{"date":"2018-10-10","isOpen":false}] switchCalendar

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
XhotelRoomGetRequest req = new XhotelRoomGetRequest();
req.setVendor("taobao");
req.setOutRid("123321");
req.setGid(100000L);
XhotelRoomGetResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

XML示例
JSON示例

<xhotel_room_get_response>
    <room>
        <receipt_other_type_desc>bbb</receipt_other_type_desc>
        <receipt_type>1</receipt_type>
        <has_receipt>true</has_receipt>
        <pic_urls>123456,4444444</pic_urls>
        <desc>aaa</desc>
        <guide>bbb</guide>
        <title>aaa</title>
        <rid>123456</rid>
        <hid>123456</hid>
        <iid>123456</iid>
        <gid>123456</gid>
        <receipt_info>aaa</receipt_info>
        <inventory>bbb</inventory>
        <status>1</status>
        <recommend>true</recommend>
        <created_time>2000-01-01 00:00:00</created_time>
        <modified_time>2000-01-01 00:00:00</modified_time>
        <extend_info1>aaa</extend_info1>
        <extend_info2>bbb</extend_info2>
        <extend_info3>ccc</extend_info3>
        <vendor>taobao</vendor>
        <out_rid>123456</out_rid>
        <down_reason>demo</down_reason>
        <switch_calendar>[{&quot;date&quot;:&quot;2018-10-10&quot;,&quot;isOpen&quot;:false}]</switch_calendar>
    </room>
</xhotel_room_get_response>

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>

错误码	错误描述	解决方案
isv.remote-service:CONVERT_ERROR	转换对象时出错	请检查输入参数
isv.invalid-parameter:ROOM_QUOTA_PARSE_ERROR	商品房态不正确	请检查输入参数
isv.invalid-parameter:ROOMS_QUOTA_NUMBER_ERROR	多个商品房态数量不能超过30个	请减少房态数量
isv.invalid-parameter: ERROR_SELLER_ROOM	商品不属于卖家	请使用正确的卖家账号操作
isv.invalid-parameter: ERROR_ROOM_REPEAT	一个房型下只允许发一个商品	请不要重复发商品
isv.invalid-parameter: ERROR_GUIDE	购买须知超长	请控制购买须知长度
isv.invalid-parameter: ERROR_NO_FOUND_ROOM	查询无此商品	请输入正确的参数
isv.invalid-parameter: ERROR_INVENTORY_NO_FOUND	查询不到对应商品的库存	请检查商品库存
isv.invalid-parameter: ERROR_HOTEL	酒店查询失败	请检查输入参数
isv.invalid-parameter: ERROR_ROOMTYPE	房型查询失败	请检查输入参数
isv.invalid-parameter: ERROR_RECEIPT	发票错误	请检查发票输入
isv.invalid-parameter: ERROR_SPU	生成spu失败	请检查输入参数
isv.invalid-parameter: ERROR_SHOTEL	标准酒店查询失败	请检查输入参数
isv.invalid-parameter: ERROR_PIC	图片参数错误	请检查图片参数
isv.invalid-parameter: ERROR_DESC	商品详情不能为空	商品详情不能为空
isv.invalid-parameter: ERROR_CHECK_INVENTORY	库存校验错误	请检查库存参数
isv.invalid-parameter: ERROR_TITILE	商品标题不能为空	商品标题不能为空
isv.invalid-parameter: ERROR_PIC_UP	图片上传错误	请检查图片参数并重新上传图片
isv.invalid-parameter: ERROR_PIC_POWER	图片权限错误	请检查图片参数
isv.invalid-parameter: ERROR_SHOTEL_STATUS	标准酒店状态错误	请检查输入参数
isv.permission-error:NO_PERMISSIONS_ERROR	权限不够、非法访问	请申请权限或者使用正确的卖家操作
isv.invalid-parameter: ERROR_HOTEL_POWER	酒店不属于该卖家	请使用正确的卖家操作
isv.invalid-parameter: ERROR_HOTEL_MATCH	酒店匹配状态错误	请检查酒店匹配状态
isv.invalid-parameter: ERROR_HOTEL_STATUS	酒店状态错误	请检查酒店状态
isv.invalid-parameter: ERROR_HOTEL_ROOMTYPE	房型不属于该酒店	请检查输入参数
isv.invalid-parameter: ERROR_ROOMTYPE_POWER	房型不属于该卖家	请使用正确的卖家操作
isv.invalid-parameter: ERROR_ROOMTYPE_STATUS	房型状态错误	请检查房型状态
isv.invalid-parameter: ERROR_ROOMTYPE_MATCH	房型匹配状态错误	请检查房型匹配状态
isv.invalid-parameter:CHOICE_ERROR	错误	错误
isv.sql-error:GET_NAME_TYPE_ERROR	错误	错误

API测试工具错误码查询工具 SDK下载

酒店商品API

taobao.xhotel.room.get (room实体查询)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ