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

taobao.xhotel.roomtype.get (房型查询接口)

房型查询房型查询接口返回结果增加date_confirm字段

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
rid Number 可选 100000 废弃,使用商家房型ID
outer_id String 可选 123123
  • 最大长度:64
  • 商家房型ID
    vendor String 可选 taobao
  • 最大长度:50
  • 系统商,一般不填写,使用须申请

    响应参数

    名称 类型 示例值 描述
    xroomtype XRoomType 查询得到的RoomType
    • └ rid
    • Number
    • 123456
    • rid
    • └ hid
    • Number
    • 123456
    • hid
    • └ created_time
    • Date
    • 2000-01-01 00:00:00
    • 创建时间
    • └ modified_time
    • Date
    • 2000-01-01 00:00:00
    • 修改时间
    • └ match_status
    • Number
    • 1
    • 此字段已废弃
    • └ status
    • Number
    • 1
    • 房型状态。0:正常,-1:删除,-2:停售
    • └ error_info
    • String
    • 房型不存在
    • 出错原因,没有匹配上标准房型时,小二拒绝的理由
    • └ outer_id
    • String
    • 1111
    • 卖家系统id
    • └ name
    • String
    • 标准间
    • 房型名称
    • └ max_occupancy
    • Number
    • 2
    • 最大入住人数
    • └ area
    • String
    • A
    • 可选值:A,B,C,D。分别代表: A:15平米以下,B:16-30平米,C:31-50平米,D:50平米以上 2)也可以自己定义,比如:40平方米
    • └ floor
    • String
    • 3-5层
    • 客房在建筑的第几层,隔层为1-2层,4-5层,7-8层
    • └ bed_type
    • String
    • 大床
    • 床型。按自己定义存储,比如:高低床、上下床
    • └ bed_size
    • String
    • 2.1米
    • 床宽。
    • └ internet
    • String
    • A
    • 宽带服务。A,B,C,D。分别代表: A:无宽带,B:免费宽带,C:收费宽带,D:部分收费宽带
    • └ service
    • String
    • {"bar":false,"catv":false,"ddd":false,"idd":false,"pubtoilet":false,"toilet":false}
    • 设施服务。JSON格式。 value值true有此服务,false没有。 bar:吧台,catv:有线电视,ddd:国内长途电话,idd:国际长途电话,toilet:独立卫生间,pubtoliet:公共卫生间。 如: {"bar":false,"catv":false,"ddd":false,"idd":false,"pubtoilet":false,"toilet":false}
    • └ window_type
    • Number
    • 1
    • 窗型,0:无窗/1:有窗
    • └ extend
    • String
    • {"keyword":”上地”}
    • 扩展信息的JSON。 注:此字段的值需要ISV在接入前与淘宝沟通,且确认能解析
    • s_roomtype
    • SRoomType
    • 标准房型信息
    • └ srid
    • Number
    • 123456
    • 匹配的标准房型
    • └ name
    • String
    • aaa
    • 房型名
    • └ floor
    • String
    • 7-8层
    • 楼层
    • └ internet
    • String
    • aaa
    • 宽带服务 "0","有线上网(免费), "1","有线上网(无)", "2","有线上网(收费)", "3","有线上网(部分有且免费)", "4","有线上网(部分有且收费)"
    • └ shid
    • Number
    • 123456
    • shid
    • └ pic_url
    • String
    • aaa
    • pic_url
    • └ facility
    • String
    • aaa
    • facility
    • └ max_occupancy
    • Number
    • 1
    • 最大入住人数
    • └ area
    • String
    • 16-30平米
    • 面积
    • └ extend
    • String
    • aaa
    • 扩展字段
    • └ created_time
    • Date
    • 2000-01-01 00:00:00
    • 创建时间
    • └ modified_time
    • Date
    • 2000-01-01 00:00:00
    • 修改时间
    • └ window_type
    • String
    • 有窗
    • 窗型,枚举类型 0, 无窗, 1, 有窗;
    • └ bed
    • String
    • [{"bedType":"大床","bedSize":"1.5m"},{"bedType":"双床","bedSize":"1.2m"}]
    • 床型。json格式:[{"bedType":"大床","bedSize":"1.5m"},{"bedType":"双床","bedSize":"1.2m"}]
    • └ status
    • Number
    • 1
    • 状态。0:正常;-1:删除
    • └ data_confirm_str
    • String
    • 匹配成功
    • 酒店数据状态:匹配成功;待匹配;待审核;审核失败;疑似错误;请注意:只有状态为“匹配成功”才是正常状态。其他状态都不会上架商品。
    • └ name_e
    • String
    • standard room
    • 卖家房型英文名称
    • └ tag_json
    • String
    • {"non-direct-roomType":1}
    • 房型维度下特殊标签含义 json: {"non-direct-roomType":1} , key:non-direct-roomType 表示非直连房型

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    XhotelRoomtypeGetRequest req = new XhotelRoomtypeGetRequest();
    req.setRid(100000L);
    req.setOuterId("123123");
    req.setVendor("taobao");
    XhotelRoomtypeGetResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <xhotel_roomtype_get_response>
        <xroomtype>
            <rid>123456</rid>
            <hid>123456</hid>
            <created_time>2000-01-01 00:00:00</created_time>
            <modified_time>2000-01-01 00:00:00</modified_time>
            <match_status>1</match_status>
            <status>1</status>
            <error_info>房型不存在</error_info>
            <outer_id>1111</outer_id>
            <name>标准间</name>
            <max_occupancy>2</max_occupancy>
            <area>A</area>
            <floor>3-5层</floor>
            <bed_type>大床</bed_type>
            <bed_size>2.1米</bed_size>
            <internet>A</internet>
            <service>{&quot;bar&quot;:false,&quot;catv&quot;:false,&quot;ddd&quot;:false,&quot;idd&quot;:false,&quot;pubtoilet&quot;:false,&quot;toilet&quot;:false}</service>
            <window_type>1</window_type>
            <extend>{&quot;keyword&quot;:”上地”}</extend>
            <s_roomtype>
                <srid>123456</srid>
                <name>aaa</name>
                <floor>7-8层</floor>
                <internet>aaa</internet>
                <shid>123456</shid>
                <pic_url>aaa</pic_url>
                <facility>aaa</facility>
                <max_occupancy>1</max_occupancy>
                <area>16-30平米</area>
                <extend>aaa</extend>
                <created_time>2000-01-01 00:00:00</created_time>
                <modified_time>2000-01-01 00:00:00</modified_time>
                <window_type>有窗</window_type>
                <bed>[{&quot;bedType&quot;:&quot;大床&quot;,&quot;bedSize&quot;:&quot;1.5m&quot;},{&quot;bedType&quot;:&quot;双床&quot;,&quot;bedSize&quot;:&quot;1.2m&quot;}]</bed>
                <status>1</status>
            </s_roomtype>
            <data_confirm_str>匹配成功</data_confirm_str>
            <name_e>standard room</name_e>
            <tag_json>{&quot;non-direct-roomType&quot;:1}</tag_json>
        </xroomtype>
    </xhotel_roomtype_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.invalid-parameter:NOTNULL 参数不能为空 请检查参数
    isv.invalid-parameter:ERROR 参数不正确 请检查参数
    isv.biz-error:STATUS_NOT_CORRECT 状态不正确 请检查状态
    isv.biz-error:NOT_RIGHTS_TO_PUBLISH_ERROR 非消保酒店卖家不能发布修改酒店、房型或宝贝 请使用消保酒店卖家操作
    isv.invalid-parameter:ROOM_TYPE_EXIST 房型已存在 请添加其他房型
    isv.invalid-parameter:ROOM_TYPE_NOT_EXIST 房型不存在 请检查输入参数
    isv.biz-error:CAN_NOT_UPDATE_ROOMTYPE 房型处于待匹配待确认或已确认成功状态无法更新 请更换房型操作或稍后重试
    isv.biz-error:UPDATE_ROOMTYPE_ERROR 更新房型失败 请稍后重试
    isv.biz-error:HAS_NOT_MATCH_SHOTEL 酒店尚未匹配到标准酒店 请先进行酒店匹配
    isv.biz-error:HAS_NOT_CONFRIM_HOTEL 酒店匹配结果尚未确认 请先进行酒店匹配结果确认
    isv.biz-error:CAN_NOT_UPDATE_HID 不能变更房型所属的酒店 不要更新房型对应的hid
    isv.biz-error:ALREADY_EXIST_SROOMTYPE 该卖家已经有房型匹配了该标准房型 请检查房型信息,不要重复匹配
    isv.permission-error:NO_PERMISSIONS_ERROR 权限不够、非法访问 请申请权限
    isv.remote-service:CONVERT_ERROR 转换对象时出错 请检查输入参数

    API工具

    如何获得此API

    FAQ

    返回
    顶部