文档中心 > API类目 > 飞猪推广平台

alibaba.fliggy.promote.hotel.details (四海通推广者酒店详细查询)

四海通推广者酒店详细查询

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
query_hotel_details_request QueryHotelDetailsRequest 必须 参数数据包装类
  • └ activity_id
  • String
  • 必须
  • sht_zb_travel
  • 活动编码
  • └ promotion_position_id
  • Number
  • 必须
  • 2219172258770
  • 推广位ID
  • └ hotel_id
  • String
  • 必须
  • 78816219
  • 一家酒店ID
  • └ promote_app_key
  • Number
  • 必须
  • 1000028
  • promoteAppKey | 媒体id | 推广平台生成给到渠道

响应参数

名称 类型 示例值 描述
is_success Boolean true 是否成功
result_code String SHT_CHANNEL_SUPPLY_PARAMS_ERROR 1
model QueryHotelDetailsResponse 数据包装类
  • └ hotel_id
  • String
  • 78816219
  • 酒店ID
  • hotel_detail
  • HotelDetail
  • 酒店详细
  • └ hotel_name
  • String
  • 美好南城保利公寓
  • 酒店名称
  • └ address
  • String
  • 东莞南城街道三元路4号保利都汇大厦四栋1楼, 中国
  • 地址
  • └ city_code
  • String
  • 441900
  • 城市编码
  • └ city_name
  • String
  • 东莞市
  • 城市名称
  • └ latitude
  • String
  • 23.006490660980383
  • 高德纬度
  • └ longitude
  • String
  • 113.73977192943835
  • 高德经度
  • └ phone_list
  • String []
  • 手机号列表
  • └ hotel_type
  • String
  • HOTEL
  • 酒店类型(酒店类型枚举 酒店: HOTEL 公寓: APARTMEN T 民宿: HOMESTAY 农家乐: AGRITAINM ENT 特色住宿: SPECIAL 别 墅 : VILLA 客栈: INN 连锁酒店: CHAIN 休闲度假: RESORT 住宿加早餐 旅馆: B&B 旅舍: HOSTEL 汽车旅馆: MOTEL 排屋: TOWNHOU SE 日式旅店: JAPANESE 摩洛哥特色 旅馆: MOROCCA N 帐篷屋: TENT 船屋: HOUSEBOA T 游轮: CRUISE 城堡: CASTLE 宫殿: PALACE 树屋: TREE)
  • └ status
  • Number
  • 0
  • 状态( 0:有效 0 1:无效 2:删除)
  • facilities
  • Facility
  • 设施列表
  • └ category
  • String
  • Facilities
  • 设施种类
  • └ category_name
  • String
  • 酒店设施
  • 种类种类名称
  • └ facility_name
  • String
  • 24小时前台
  • 设施名称
  • └ arrival_time
  • String
  • 14:00
  • 入住时间
  • └ departure_time
  • String
  • 12:00
  • 离店时间
  • hotel_tag
  • HotelTag
  • 酒店标签
  • └ support_breakfast
  • Boolean
  • true
  • 是否支持早餐
  • └ support_free_cancel
  • Boolean
  • true
  • 是否支持免费支持取消
  • └ support_special_invoice
  • Boolean
  • true
  • 是否支持专用发票
  • └ support_prepay_invoice
  • Boolean
  • true
  • 是否支持预付发票
  • └ support_prepay
  • Boolean
  • true
  • 是否支持支付预付
  • └ support_self_pay
  • Boolean
  • true
  • 是否支持到付
  • └ hotel_star
  • Number
  • 2
  • 酒店星级
  • └ hotel_category
  • Number
  • 2
  • 推荐星级(经济型 2 (二星/经 济) 舒适型 3 (三星/舒 适) 高档型 4 (四星/高 档) 豪华型 5 (五星/豪 华))
  • └ hotel_name_en
  • String
  • Hotel Name
  • 酒店英文名称
  • └ brand_name
  • String
  • 如家精选
  • 品牌名称
  • └ group_name
  • String
  • 首旅如家
  • 集团名称
  • └ address_en
  • String
  • 广东省东莞市
  • 地址
  • └ postal_code
  • String
  • 523000
  • 邮政编码
  • └ district_code
  • String
  • 330100
  • 地区代码
  • └ district_name
  • String
  • 萧山区
  • 地区名称
  • └ business_zone
  • String
  • 天安门/王府井地区
  • 商业区
  • └ hotel_desc
  • String
  • 酒店坐落在东莞南城宏远桥旁,保利珑远广场,光观电梯对面\r\n经过一座城,寻觅一间房,消去您满身的疲劳,我们将以热情的服务,舒适的房间,期待您的到来。我们,在这里,等您来!
  • 酒店描述
  • └ hotel_brief
  • String
  • 酒店坐落在东莞南城宏远桥旁,保利珑远广场,光观电梯对面\r\n经过一座城,寻觅一间房,消去您满身的疲劳,我们将以热情的服务,舒适的房间,期待您的到来。我们,在这里,等您来!
  • 酒店简短说明
  • └ open_year
  • String
  • 2024-01-01
  • 开店时间
  • └ fitment_year
  • String
  • 2024-01-01
  • 装修时间
  • └ email
  • String
  • xxxx@x.com
  • 电子邮箱地址
  • └ total_score
  • String
  • 5.0
  • 总得分
  • booking_limits
  • BookingLimit []
  • 预定限制
  • └ time
  • String
  • 2025
  • 可订时间范围
  • └ pet_info
  • String
  • 不能带宠物
  • 是否可以养宠物
  • └ children_policy
  • String
  • 儿童政策
  • 儿童政策
  • └ breakfast_policy
  • String
  • 早餐政策
  • 早餐政策
  • park_infos
  • ParkInfo []
  • 停车信息
  • └ time
  • String
  • 24
  • 时间
  • └ desc
  • String
  • 停车详细
  • 收费标准: 每小时 ¥ 10,酒店内提 供公共停车 场,无法提 前预 订"
  • └ type
  • String
  • 停车信息类型
  • 停车信息类 型, Normal:普 通停车场, ChargingSt ation:充电 桩
  • room_list
  • RoomDetail []
  • 房间列表信息
  • └ room_id
  • String
  • 114755225
  • 房间ID
  • └ room_name
  • String
  • 一房一厅双床
  • 房间名称
  • └ has_window
  • Number
  • 1
  • 是否有窗户(窗型 对应属性值: 0表示 无窗, 1表 示有假窗, 2表示有窗)
  • └ has_many_beds
  • Boolean
  • true
  • 是否有多床
  • └ bed_number
  • Number
  • 1
  • 床总数
  • └ wireless_broad_net
  • Number
  • 2
  • 无线网络(无线宽带 0 没有, 1有 且收费, 2 有且免费)
  • └ wired_broad_net
  • Number
  • 2
  • 有线宽带(有线宽带 0 没有, 1有 且收费, 2 有且免费)
  • └ area
  • String
  • 50
  • 面积
  • └ floor
  • String
  • 11-23
  • 房间楼层
  • bed_details
  • BedDetail []
  • 床位详细
  • └ bed_number
  • Number
  • 1
  • 床型数量
  • └ bed_width
  • String
  • 1.6
  • 宽度(m)
  • └ bed_length
  • String
  • 1.6
  • 长度(m)
  • └ bed_type
  • String
  • 大床
  • 类型
  • └ bath
  • String
  • 独立卫浴
  • 洗澡设施(卫浴设施 独立卫浴,公共卫浴)
  • └ description
  • String
  • 中文描述
  • 无窗、大床 1.5米、2层 楼、18-20 平米、可入 住2人
  • └ capacity
  • Number
  • 32
  • 最大入住人
  • facilities
  • Facility []
  • 房间设施详细
  • └ category
  • String
  • 服务
  • 设施种类
  • └ category_name
  • String
  • 服务设施
  • 设施类目名称
  • └ facility_name
  • String
  • 中餐厅
  • 设施名称
  • image_list
  • HotelImage []
  • 图片列表
  • └ hotel_id
  • String
  • 78816219
  • 酒店ID
  • └ type
  • String
  • GUEST_ROOM
  • 类型(餐厅: RESTAURA NT 休闲: RECREATIO N 会议室: CONFEREN CE 外观: EXTERIOR 大堂/接待 台: LOBBY 客房: GUEST_RO OM 周边景点: NEARBY 公共区域: PUBLIC_AR EA 其他: OTHER)
  • └ is_cover
  • Boolean
  • false
  • 是否是封面
  • └ is_room_cover
  • Boolean
  • true
  • 是否是床封面
  • url_list
  • HotelImageLocation []
  • 地址列表
  • └ water_mark
  • Boolean
  • false
  • 水印标记
  • └ size
  • String
  • 640_960
  • 大小
  • └ url
  • String
  • img.alicdn.com/imgextra/i2/6000000003521/O1CN01ihAhRu1bsfZGhp1Qu_!!6000000003521-0-hotel.jpg
  • URL地址
  • └ image_description
  • String
  • 图片描述
  • 图片描述
  • └ room_id
  • String
  • 114755225
  • 房间ID
  • hotel_review
  • HotelReview
  • 酒店点评
  • └ count
  • Number
  • 20000
  • 点评总数
  • └ positive_count
  • Number
  • 20
  • 好评数
  • └ negative_count
  • Number
  • 10
  • 差评数
  • └ score
  • String
  • 90
  • 总评分
  • └ confirm_rate
  • Number
  • 90
  • 订单30分钟确认率(%)
  • common_tag_list
  • CommonTag []
  • 评论标签列表
  • └ tag_name
  • String
  • 性价比高
  • 点评名称
  • └ heat_value
  • String
  • 233
  • 点评热度
result_message String QUERY_HOTEL_ERROR 结果消息

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaFliggyPromoteHotelDetailsRequest req = new AlibabaFliggyPromoteHotelDetailsRequest();
AlibabaFliggyPromoteHotelDetailsRequest.QueryHotelDetailsRequest obj1 = new AlibabaFliggyPromoteHotelDetailsRequest.QueryHotelDetailsRequest();
obj1.setActivityId("sht_zb_travel");
obj1.setPromotionPositionId(2219172258770L);
obj1.setHotelId("78816219");
obj1.setPromoteAppKey(1000028L);
req.setQueryHotelDetailsRequest(obj1);
AlibabaFliggyPromoteHotelDetailsResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_fliggy_promote_hotel_details_response>
    <is_success>true</is_success>
    <result_code>SHT_CHANNEL_SUPPLY_PARAMS_ERROR</result_code>
    <model>
        <hotel_id>78816219</hotel_id>
        <hotel_detail>
            <hotel_name>美好南城保利公寓</hotel_name>
            <address>东莞南城街道三元路4号保利都汇大厦四栋1楼, 中国</address>
            <city_code>441900</city_code>
            <city_name>东莞市</city_name>
            <latitude>23.006490660980383</latitude>
            <longitude>113.73977192943835</longitude>
            <hotel_type>HOTEL</hotel_type>
            <status>0</status>
            <facilities>
                <category>Facilities</category>
                <category_name>酒店设施</category_name>
                <facility_name>24小时前台</facility_name>
            </facilities>
            <arrival_time>14:00</arrival_time>
            <departure_time>12:00</departure_time>
            <hotel_tag>
                <support_breakfast>true</support_breakfast>
                <support_free_cancel>true</support_free_cancel>
                <support_special_invoice>true</support_special_invoice>
                <support_prepay_invoice>true</support_prepay_invoice>
                <support_prepay>true</support_prepay>
                <support_self_pay>true</support_self_pay>
            </hotel_tag>
            <hotel_star>2</hotel_star>
            <hotel_category>2</hotel_category>
            <hotel_name_en>Hotel Name</hotel_name_en>
            <brand_name>如家精选</brand_name>
            <group_name>首旅如家</group_name>
            <address_en>广东省东莞市</address_en>
            <postal_code>523000</postal_code>
            <district_code>330100</district_code>
            <district_name>萧山区</district_name>
            <business_zone>天安门/王府井地区</business_zone>
            <hotel_desc>酒店坐落在东莞南城宏远桥旁,保利珑远广场,光观电梯对面\r\n经过一座城,寻觅一间房,消去您满身的疲劳,我们将以热情的服务,舒适的房间,期待您的到来。我们,在这里,等您来!</hotel_desc>
            <hotel_brief>酒店坐落在东莞南城宏远桥旁,保利珑远广场,光观电梯对面\r\n经过一座城,寻觅一间房,消去您满身的疲劳,我们将以热情的服务,舒适的房间,期待您的到来。我们,在这里,等您来!</hotel_brief>
            <open_year>2024-01-01</open_year>
            <fitment_year>2024-01-01</fitment_year>
            <email>xxxx@x.com</email>
            <total_score>5.0</total_score>
            <booking_limits>
                <booking_limit>
                    <time>2025</time>
                    <pet_info>不能带宠物</pet_info>
                    <children_policy>儿童政策</children_policy>
                    <breakfast_policy>早餐政策</breakfast_policy>
                </booking_limit>
            </booking_limits>
            <park_infos>
                <park_info>
                    <time>24</time>
                    <desc>停车详细</desc>
                    <type>停车信息类型</type>
                </park_info>
            </park_infos>
        </hotel_detail>
        <room_list>
            <room_detail>
                <room_id>114755225</room_id>
                <room_name>一房一厅双床</room_name>
                <has_window>1</has_window>
                <has_many_beds>true</has_many_beds>
                <bed_number>1</bed_number>
                <wireless_broad_net>2</wireless_broad_net>
                <wired_broad_net>2</wired_broad_net>
                <area>50</area>
                <floor>11-23</floor>
                <bed_details>
                    <bed_detail>
                        <bed_number>1</bed_number>
                        <bed_width>1.6</bed_width>
                        <bed_length>1.6</bed_length>
                        <bed_type>大床</bed_type>
                    </bed_detail>
                </bed_details>
                <bath>独立卫浴</bath>
                <description>中文描述</description>
                <capacity>32</capacity>
                <facilities>
                    <facility>
                        <category>服务</category>
                        <category_name>服务设施</category_name>
                        <facility_name>中餐厅</facility_name>
                    </facility>
                </facilities>
            </room_detail>
        </room_list>
        <image_list>
            <hotel_image>
                <hotel_id>78816219</hotel_id>
                <type>GUEST_ROOM</type>
                <is_cover>false</is_cover>
                <is_room_cover>true</is_room_cover>
                <url_list>
                    <hotel_image_location>
                        <water_mark>false</water_mark>
                        <size>640_960</size>
                        <url>img.alicdn.com/imgextra/i2/6000000003521/O1CN01ihAhRu1bsfZGhp1Qu_!!6000000003521-0-hotel.jpg</url>
                        <image_description>图片描述</image_description>
                    </hotel_image_location>
                </url_list>
                <room_id>114755225</room_id>
            </hotel_image>
        </image_list>
        <hotel_review>
            <count>20000</count>
            <positive_count>20</positive_count>
            <negative_count>10</negative_count>
            <score>90</score>
            <confirm_rate>90</confirm_rate>
            <common_tag_list>
                <common_tag>
                    <tag_name>性价比高</tag_name>
                    <heat_value>233</heat_value>
                </common_tag>
            </common_tag_list>
        </hotel_review>
    </model>
    <result_message>QUERY_HOTEL_ERROR</result_message>
</alibaba_fliggy_promote_hotel_details_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

返回
顶部