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

taobao.xhotel.xitem.query (查询 x 元素)

查询 x 元素

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
vendor String 可选 taobao 系统商,一般不填写,使用须申请
out_hid String 必须 haohua123 商家酒店ID,指明该 x 元素属于哪家酒店
out_rid String 可选 room_123 商家房型ID,指明该 x 元素关联哪个房型
rate_plan_code String 可选 rp_1234 商家 RP ID,指明该 x 元素关联了哪个 RP
out_x_codes String 可选 ["abc_123"] 需要查询的 x_code 编码

响应参数

名称 类型 示例值 描述
result ResultSet 返回结果
  • └ error_msg
  • String
  • 参数不存在
  • 错误信息
  • └ error_code
  • String
  • 1
  • 错误码
  • x_items
  • HotelXitemDO []
  • 查询到的 x 元素
  • └ gmt_create
  • Date
  • 2023-07-22 00:12:23
  • 创建时间
  • └ gmt_modified
  • Date
  • 2023-07-22 00:12:23
  • 修改时间
  • └ out_x_code
  • String
  • xx_12345
  • 外部code
  • └ sub_type_code
  • String
  • ba_1234
  • 子类型code
  • └ out_hid
  • String
  • haozhu_124
  • 外部酒店code
  • └ short_name
  • String
  • 摆渡车
  • 元素类型简写
  • └ time
  • String
  • 18:00-21:00
  • 服务时间段
  • └ value
  • Number
  • 199
  • 商品价值
  • └ item_desc
  • String
  • ""
  • 商品使用说明
  • └ status
  • Number
  • 0
  • 状态是否生效0 失效, 1生效
  • └ dimension_type
  • Number
  • 1
  • 附加产品使用维度 1:每间房维度 2:每间夜维度
  • └ audit_status
  • Number
  • 0
  • 审核状态-1:拒绝,0:审核中,1:审核通过
  • └ audit_reject_reason
  • String
  • 图片不符合要求
  • 审核拒绝原因
  • └ feature_detail
  • String
  • {}
  • 详细信息json字符串
  • pictures
  • HotelXItemPicture []
  • 酒+X 图片格式化信息
  • └ url
  • String
  • https://url.xxxx.aaa
  • 图片地址
  • └ is_main
  • Boolean
  • true
  • 是否主图
  • └ total_count
  • Number
  • 0
  • 记录总数

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
XhotelXitemQueryRequest req = new XhotelXitemQueryRequest();
req.setVendor("taobao");
req.setOutHid("haohua123");
req.setOutRid("room_123");
req.setRatePlanCode("rp_1234");
req.setOutXCodes("[\"abc_123\"]");
XhotelXitemQueryResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<xhotel_xitem_query_response>
    <result>
        <error_msg>参数不存在</error_msg>
        <error_code>1</error_code>
        <x_items>
            <hotel_xitem_d_o>
                <gmt_create>2023-07-22 00:12:23</gmt_create>
                <gmt_modified>2023-07-22 00:12:23</gmt_modified>
                <out_x_code>xx_12345</out_x_code>
                <sub_type_code>ba_1234</sub_type_code>
                <out_hid>haozhu_124</out_hid>
                <short_name>摆渡车</short_name>
                <time>18:00-21:00</time>
                <value>199</value>
                <item_desc>&quot;&quot;</item_desc>
                <status>0</status>
                <dimension_type>1</dimension_type>
                <audit_status>0</audit_status>
                <audit_reject_reason>图片不符合要求</audit_reject_reason>
                <feature_detail>{}</feature_detail>
                <pictures>
                    <hotel_x_item_picture>
                        <url>https://url.xxxx.aaa</url>
                        <is_main>true</is_main>
                    </hotel_x_item_picture>
                </pictures>
            </hotel_xitem_d_o>
        </x_items>
        <total_count>0</total_count>
    </result>
</xhotel_xitem_query_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>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部