文档中心 > API类目 > EBK上云API

taobao.xhotel.roomtype.batch.get (房型列表查询)

房型列表查询,包括房型库存,以及标准房型信息,通过参数开关控制

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
hid Number 可选 12312 卖家酒店hid
srid Number 可选 31231 标准房型srid
start_row Number 可选 12 startRow
page_size Number 可选 222 pageSize
need_room_inv Boolean 可选 false
  • 默认值:false
  • 是否需要房型库存
    need_s_room_type Boolean 可选 false
  • 默认值:false
  • 是否需要标准房型信息
    start_date Date 可选 2017-10-22 00:00:00 日历化信息开始时间
    end_date Date 可选 2018-10-22 00:00:00 日历化信息结束时间
    rid_list String 可选 [123,356] 房型id列表,仅用于在hid有效的情况下筛选返回的房型列表

    响应参数

    名称 类型 示例值 描述
    result ResultSet result
    • └ error_code
    • String
    • 0
    • errorCode
    • └ error_msg
    • String
    • 0
    • errorMsg
    • └ success
    • Boolean
    • false
    • success
    • first_result
    • XRoomTypeListInfo
    • firstResult
    • 结果
    • room_type_list
    • RoomTypeWithInvAndSwitch []
    • 房型列表和库存开关
    • inv_and_switch_unit_list
    • InvAndSwitchUnit []
    • invAndSwitchUnitList
    • └ room_switch
    • Boolean
    • 0
    • roomSwitch
    • └ quota
    • Number
    • 0
    • quota
    • └ date
    • Date
    • 0
    • date
    • room_type
    • RoomType
    • roomType
    • └ window_type
    • Number
    • 0
    • windowType
    • └ hid
    • Number
    • 0
    • hid
    • └ remark
    • String
    • 0
    • remark
    • └ out_hid
    • String
    • 0
    • outHid
    • └ srid
    • Number
    • 0
    • srid
    • └ pics
    • String
    • 0
    • pics
    • └ area
    • String
    • 0
    • area
    • └ bed_size
    • String
    • 0
    • bedSize
    • └ seller_nick
    • String
    • 0
    • sellerNick
    • └ priority
    • Number
    • 0
    • priority
    • └ name
    • String
    • 0
    • name
    • └ old_rid
    • Number
    • 0
    • oldRid
    • └ data_confirm
    • Number
    • 0
    • dataConfirm
    • └ agg_name
    • String
    • 0
    • aggName
    • └ name_e
    • String
    • 0
    • nameE
    • └ vendor
    • String
    • 0
    • vendor
    • └ extend
    • String
    • 0
    • extend
    • └ floor
    • String
    • 0
    • floor
    • └ rid
    • Number
    • 0
    • rid
    • └ seller_id
    • Number
    • 0
    • sellerId
    • └ match_status
    • Number
    • 0
    • matchStatus
    • └ service
    • String
    • 0
    • service
    • └ bed_type
    • String
    • 0
    • bedType
    • └ oper_xiaoer_name
    • String
    • 0
    • operXiaoerName
    • └ comment
    • String
    • 0
    • comment
    • └ max_occupancy
    • Number
    • 0
    • maxOccupancy
    • └ internet
    • String
    • 0
    • internet
    • └ internet_parser
    • String
    • 0
    • internetParser
    • └ outer_id
    • String
    • 0
    • outerId
    • └ status
    • Number
    • 0
    • 房型状态, 0:正常, -1:删除, -2:停售
    • └ iid
    • Number
    • 0
    • iid
    • └ gid
    • Number
    • 0
    • gid
    • └ download_reason
    • String
    • 0
    • 下架原因
    • └ on_sell
    • Boolean
    • false
    • 是否可售
    • └ tag_json
    • String
    • {"non-direct-roomType":1}
    • 房型维度下特殊标签含义 json: {"non-direct-roomType":1} , key:non-direct-roomType 表示非直连房型
    • └ total_count
    • Number
    • 0
    • 房型列表数量
    • s_room_type_list
    • Sroomtypelist []
    • 标准房型信息
    • └ window_type
    • String
    • 0
    • windowType
    • └ gmt_modified
    • String
    • 0
    • gmtModified
    • └ pics_info
    • String
    • 0
    • picsInfo
    • └ network_service
    • String
    • 0
    • networkService
    • └ include_types
    • String
    • 0
    • includeTypes
    • └ auditor
    • String
    • 0
    • auditor
    • └ last_modify
    • String
    • 0
    • lastModify
    • └ shid
    • Number
    • 0
    • shid
    • └ original_pics
    • String
    • 0
    • originalPics
    • └ version
    • Number
    • 0
    • version
    • └ srid
    • Number
    • 0
    • srid
    • └ pics
    • String
    • 0
    • pics
    • └ pics_ext
    • String
    • 0
    • picsExt
    • └ area
    • String
    • 0
    • area
    • └ facility
    • String
    • 0
    • facility
    • └ name
    • String
    • 0
    • name
    • └ properties_d_os
    • String
    • 0
    • propertiesDOs
    • └ add_bed
    • Number
    • 0
    • addBed
    • └ name_e
    • String
    • 0
    • nameE
    • └ gmt_create
    • String
    • 0
    • gmtCreate
    • └ status
    • Number
    • 0
    • status
    • └ extend
    • String
    • 0
    • extend
    • └ bed
    • String
    • 0
    • bed
    • └ transfer_pics
    • String
    • 0
    • transferPics
    • └ facility_object
    • String
    • 0
    • facilityObject
    • └ source
    • Number
    • 0
    • source
    • └ floor
    • String
    • 0
    • floor
    • └ bed_list
    • String
    • 0
    • bedList
    • └ max_occupancy
    • Number
    • 0
    • maxOccupancy
    • └ outer_id
    • String
    • 0
    • outerId

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    XhotelRoomtypeBatchGetRequest req = new XhotelRoomtypeBatchGetRequest();
    req.setHid(12312L);
    req.setSrid(31231L);
    req.setStartRow(12L);
    req.setPageSize(222L);
    req.setNeedRoomInv(false);
    req.setNeedSRoomType(false);
    req.setStartDate(StringUtils.parseDateTime("2017-10-22 00:00:00"));
    req.setEndDate(StringUtils.parseDateTime("2018-10-22 00:00:00"));
    req.setRidList("[123,356]");
    XhotelRoomtypeBatchGetResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <xhotel_roomtype_batch_get_response>
        <result>
            <error_code>0</error_code>
            <error_msg>0</error_msg>
            <success>false</success>
            <first_result>
                <room_type_list>
                    <room_type_with_inv_and_switch>
                        <inv_and_switch_unit_list>
                            <inv_and_switch_unit>
                                <room_switch>0</room_switch>
                                <quota>0</quota>
                                <date>0</date>
                            </inv_and_switch_unit>
                        </inv_and_switch_unit_list>
                        <room_type>
                            <window_type>0</window_type>
                            <hid>0</hid>
                            <remark>0</remark>
                            <out_hid>0</out_hid>
                            <srid>0</srid>
                            <pics>0</pics>
                            <area>0</area>
                            <bed_size>0</bed_size>
                            <seller_nick>0</seller_nick>
                            <priority>0</priority>
                            <name>0</name>
                            <old_rid>0</old_rid>
                            <data_confirm>0</data_confirm>
                            <agg_name>0</agg_name>
                            <name_e>0</name_e>
                            <vendor>0</vendor>
                            <extend>0</extend>
                            <floor>0</floor>
                            <rid>0</rid>
                            <seller_id>0</seller_id>
                            <match_status>0</match_status>
                            <service>0</service>
                            <bed_type>0</bed_type>
                            <oper_xiaoer_name>0</oper_xiaoer_name>
                            <comment>0</comment>
                            <max_occupancy>0</max_occupancy>
                            <internet>0</internet>
                            <internet_parser>0</internet_parser>
                            <outer_id>0</outer_id>
                            <status>0</status>
                        </room_type>
                        <iid>0</iid>
                        <gid>0</gid>
                        <download_reason>0</download_reason>
                        <on_sell>false</on_sell>
                        <tag_json>{&quot;non-direct-roomType&quot;:1}</tag_json>
                    </room_type_with_inv_and_switch>
                </room_type_list>
                <total_count>0</total_count>
                <s_room_type_list>
                    <sroomtypelist>
                        <window_type>0</window_type>
                        <gmt_modified>0</gmt_modified>
                        <pics_info>0</pics_info>
                        <network_service>0</network_service>
                        <include_types>0</include_types>
                        <auditor>0</auditor>
                        <last_modify>0</last_modify>
                        <shid>0</shid>
                        <original_pics>0</original_pics>
                        <version>0</version>
                        <srid>0</srid>
                        <pics>0</pics>
                        <pics_ext>0</pics_ext>
                        <area>0</area>
                        <facility>0</facility>
                        <name>0</name>
                        <properties_d_os>0</properties_d_os>
                        <add_bed>0</add_bed>
                        <name_e>0</name_e>
                        <gmt_create>0</gmt_create>
                        <status>0</status>
                        <extend>0</extend>
                        <bed>0</bed>
                        <transfer_pics>0</transfer_pics>
                        <facility_object>0</facility_object>
                        <source>0</source>
                        <floor>0</floor>
                        <bed_list>0</bed_list>
                        <max_occupancy>0</max_occupancy>
                        <outer_id>0</outer_id>
                    </sroomtypelist>
                </s_room_type_list>
            </first_result>
        </result>
    </xhotel_roomtype_batch_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>

    错误码解释

    错误码 错误描述 解决方案

    API工具

    如何获得此API

    FAQ

    返回
    顶部