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

taobao.xhotel.distribution.foundation.hotel.query (飞猪酒店分销-标准酒店信息-查询)

飞猪酒店分销-标准酒店信息-查询

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
hotel_static_info_top_param HotelStaticInfoTopParam 必须 请求入参
  • └ language
  • String
  • 必须
  • zh_CN
  • 语言:zn_CN、en_US
  • └ shid_list
  • Number []
  • 必须
  • [80748001]
  • shid列表

响应参数

名称 类型 示例值 描述
result Result 请求结果
  • └ trace_id
  • String
  • 21365c1f17763048795651540e03b2
  • traceId
  • data
  • HotelStaticInfoTopResult
  • 响应
  • └ language
  • String
  • zh_CN
  • 实际查询语言
  • └ missing_shids
  • Number []
  • 查询无结果的shid
  • 查询无结果的shid
  • list
  • Hotel []
  • 静态酒店信息列表
  • └ shid
  • Number
  • 2131331
  • shid
  • └ name
  • String
  • 酒店名称
  • 酒店名称
  • └ name_e
  • String
  • 酒店英文名称
  • 酒店英文名称
  • └ policy_groups
  • String
  • 酒店政策
  • 酒店政策
  • └ image_show
  • String
  • 图文秀
  • 图文秀
  • └ status_reason_desc
  • String
  • 状态原因
  • 状态原因描述
  • └ telephones
  • String
  • 电话信息
  • 电话信息
  • └ phone_map
  • String
  • 电话信息
  • 电话信息
  • └ used_name
  • String
  • 曾用名
  • 曾用名
  • └ domestic
  • String
  • 国内/国际
  • 国内/国际
  • └ country
  • String
  • 国际
  • country
  • └ country_code
  • String
  • 7000001
  • 国家编码
  • └ province_code
  • String
  • 12
  • 省份编码
  • └ province
  • String
  • 浙江
  • 省份
  • └ city_code
  • String
  • 城市编码
  • 城市编码
  • └ city
  • String
  • 城市
  • 城市
  • └ district_code
  • String
  • 区县编码
  • 区县编码
  • └ district
  • String
  • 区县
  • 区县
  • └ business
  • String
  • 商圈
  • 商圈
  • └ address
  • String
  • 地址
  • 地址
  • └ en_addr
  • String
  • 英文地址
  • 英文地址
  • └ position_type
  • String
  • 坐标类型
  • 坐标类型
  • └ longitude
  • String
  • 经度
  • 经度
  • └ latitude
  • String
  • 纬度
  • 纬度
  • └ email
  • String
  • 1@gmail.com
  • 邮箱
  • └ hotel_type
  • String
  • 酒店类型
  • 酒店类型
  • └ type
  • String
  • 类型
  • 类型
  • └ star
  • String
  • 星级
  • 星级
  • └ star_rate
  • String
  • 星级评定
  • 星级评定
  • └ brand
  • String
  • 品牌
  • 品牌
  • └ description
  • String
  • 描述
  • 描述
  • └ en_description
  • String
  • 英文描述
  • 英文描述
  • └ opening_hours
  • String
  • 营业时间
  • 营业时间
  • └ decoration_time
  • String
  • 装修时间
  • 装修时间
  • └ floors
  • String
  • 楼层
  • 楼层
  • └ rooms
  • String
  • 12
  • 房间数
  • └ tags
  • String
  • tags
  • tags
  • └ status
  • String
  • 状态
  • 状态
  • └ refuse_type
  • String
  • 拒绝类型
  • 拒绝原因
  • └ refuse_reason
  • String
  • 拒绝原因
  • 拒绝原因
  • └ status_reason
  • String
  • 状态原因
  • 状态原因
  • └ facility_groups
  • String
  • 设施
  • 设施
  • room_list
  • RoomStaticInfoDTO []
  • 房型
  • └ srid
  • String
  • 房型id
  • 房型id
  • └ name
  • String
  • 房型名称
  • 房型名称
  • └ name_e
  • String
  • 房型英文名称
  • 房型英文名称
  • └ floor
  • String
  • 楼层
  • 楼层
  • └ room_num
  • String
  • 房间数
  • 房间数
  • └ area
  • String
  • 面积
  • 面积
  • └ window_type
  • String
  • 窗户类型
  • 窗户类型
  • └ window_type_defect
  • String
  • 窗户类型缺陷
  • 窗户类型缺陷
  • └ window_type_special
  • String
  • 窗户类型缺陷
  • 窗户类型缺陷
  • └ dorm_room
  • String
  • 是否宿舍房
  • 是否宿舍房
  • └ shared_room
  • String
  • 是否合住房
  • 是否合住房
  • └ bed_info_json
  • String
  • 床型信息
  • 床型信息
  • └ room_type_bed_info
  • String
  • 床型信息
  • 床型信息
  • └ add_bed
  • String
  • 是否可加床
  • 是否可加床
  • └ add_child_bed
  • String
  • 是否可加婴儿床
  • 是否可加婴儿床
  • └ max_occupancy
  • String
  • 最大入住人数
  • 最大入住人数
  • └ max_adults
  • String
  • 最大成人数
  • 最大成人数
  • └ max_children
  • String
  • 最大儿童数
  • 最大儿童数
  • └ status
  • String
  • 状态
  • 状态
  • └ basic_room_type
  • String
  • 是否基础房型
  • 是否基础房型
  • └ lowest_price_room_type
  • String
  • 是否最低价房型
  • 是否最低价房型
  • └ status_reason
  • String
  • 正常
  • 状态原因
  • └ status_reason_desc
  • String
  • 状态原因描述
  • 状态原因描述
  • └ add_bed_charge
  • String
  • 加床是否收费
  • 加床是否收费
  • └ add_bed_policy
  • String
  • 加床政策
  • 加床政策
  • └ facility_groups
  • String
  • 设施分组
  • 设施分组
  • └ pictures
  • String
  • 房型图片信息
  • 房型图片信息
  • └ videos
  • String
  • 房型视频信息
  • 房型视频信息
  • └ pictures
  • String
  • 图片信息
  • 图片信息
  • └ videos
  • String
  • 视频信息
  • 视频信息
  • └ success
  • Boolean
  • true
  • 成功
  • └ message
  • String
  • 请求异常
  • 请求信息
  • └ status
  • String
  • SUCCESS
  • 状态码

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
XhotelDistributionFoundationHotelQueryRequest req = new XhotelDistributionFoundationHotelQueryRequest();
XhotelDistributionFoundationHotelQueryRequest.HotelStaticInfoTopParam obj1 = new XhotelDistributionFoundationHotelQueryRequest.HotelStaticInfoTopParam();
obj1.setLanguage("zh_CN");
obj1.setShidList(new Long[] { 80748001 };
);
req.setHotelStaticInfoTopParam(obj1);
XhotelDistributionFoundationHotelQueryResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<xhotel_distribution_foundation_hotel_query_response>
    <result>
        <trace_id>21365c1f17763048795651540e03b2</trace_id>
        <data>
            <language>zh_CN</language>
            <missing_shids>
                <number>查询无结果的shid</number>
            </missing_shids>
            <list>
                <hotel>
                    <shid>2131331</shid>
                    <name>酒店名称</name>
                    <name_e>酒店英文名称</name_e>
                    <policy_groups>酒店政策</policy_groups>
                    <image_show>图文秀</image_show>
                    <status_reason_desc>状态原因</status_reason_desc>
                    <telephones>电话信息</telephones>
                    <phone_map>电话信息</phone_map>
                    <used_name>曾用名</used_name>
                    <domestic>国内/国际</domestic>
                    <country>国际</country>
                    <country_code>7000001</country_code>
                    <province_code>12</province_code>
                    <province>浙江</province>
                    <city_code>城市编码</city_code>
                    <city>城市</city>
                    <district_code>区县编码</district_code>
                    <district>区县</district>
                    <business>商圈</business>
                    <address>地址</address>
                    <en_addr>英文地址</en_addr>
                    <position_type>坐标类型</position_type>
                    <longitude>经度</longitude>
                    <latitude>纬度</latitude>
                    <email>1@gmail.com</email>
                    <hotel_type>酒店类型</hotel_type>
                    <type>类型</type>
                    <star>星级</star>
                    <star_rate>星级评定</star_rate>
                    <brand>品牌</brand>
                    <description>描述</description>
                    <en_description>英文描述</en_description>
                    <opening_hours>营业时间</opening_hours>
                    <decoration_time>装修时间</decoration_time>
                    <floors>楼层</floors>
                    <rooms>12</rooms>
                    <tags>tags</tags>
                    <status>状态</status>
                    <refuse_type>拒绝类型</refuse_type>
                    <refuse_reason>拒绝原因</refuse_reason>
                    <status_reason>状态原因</status_reason>
                    <facility_groups>设施</facility_groups>
                    <room_list>
                        <room_static_info_d_t_o>
                            <srid>房型id</srid>
                            <name>房型名称</name>
                            <name_e>房型英文名称</name_e>
                            <floor>楼层</floor>
                            <room_num>房间数</room_num>
                            <area>面积</area>
                            <window_type>窗户类型</window_type>
                            <window_type_defect>窗户类型缺陷</window_type_defect>
                            <window_type_special>窗户类型缺陷</window_type_special>
                            <dorm_room>是否宿舍房</dorm_room>
                            <shared_room>是否合住房</shared_room>
                            <bed_info_json>床型信息</bed_info_json>
                            <room_type_bed_info>床型信息</room_type_bed_info>
                            <add_bed>是否可加床</add_bed>
                            <add_child_bed>是否可加婴儿床</add_child_bed>
                            <max_occupancy>最大入住人数</max_occupancy>
                            <max_adults>最大成人数</max_adults>
                            <max_children>最大儿童数</max_children>
                            <status>状态</status>
                            <basic_room_type>是否基础房型</basic_room_type>
                            <lowest_price_room_type>是否最低价房型</lowest_price_room_type>
                            <status_reason>正常</status_reason>
                            <status_reason_desc>状态原因描述</status_reason_desc>
                            <add_bed_charge>加床是否收费</add_bed_charge>
                            <add_bed_policy>加床政策</add_bed_policy>
                            <facility_groups>设施分组</facility_groups>
                            <pictures>房型图片信息</pictures>
                            <videos>房型视频信息</videos>
                        </room_static_info_d_t_o>
                    </room_list>
                    <pictures>图片信息</pictures>
                    <videos>视频信息</videos>
                </hotel>
            </list>
        </data>
        <success>true</success>
        <message>请求异常</message>
        <status>SUCCESS</status>
    </result>
</xhotel_distribution_foundation_hotel_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

返回
顶部