文档中心 > API类目 > 酒店商品API

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

此接口用于查询一个商品,根据传入的gid查询商品信息。卖家只能查询自己的商品。

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
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工具

如何获得此API

FAQ

返回
顶部