文档中心 > API类目 > 飞猪商家平台

alitrip.merchant.galaxy.hotel.detail.search (星河-酒店详细信息搜索)

星河服务=获取雅高酒店详细信息

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
tenant_key String 可选 111 租户id
hotel_details_param HotelDetailsParam 必须 酒店详情入参
  • └ check_out
  • String
  • 必须
  • 2020-01-02
  • 离店时间
  • └ check_in
  • String
  • 必须
  • 2020-01-01
  • 入店时间
  • └ hotel_id
  • String
  • 必须
  • 12345
  • 外部酒店id
  • └ shid
  • Number
  • 必须
  • 111111
  • 标准酒店id
  • └ member_level
  • String
  • 必须
  • 1
  • 会员等级
  • └ adult_num
  • Number
  • 必须
  • 1
  • 成人数量
  • └ children_ages
  • String
  • 可选
  • 11,12
  • 儿童年龄数组
  • └ few_nights
  • Number
  • 必须
  • 1
  • 连住几晚
  • └ room_type
  • String
  • 可选
  • FREE_CANCEL
  • 快筛选项
  • └ token
  • String
  • 可选
  • 123
  • 用户登录信息

响应参数

名称 类型 示例值 描述
result Result 接口返回model
  • └ success
  • Boolean
  • true
  • 是否成功
  • └ error_code
  • String
  • demo
  • 错误码
  • content
  • HotelDetailInfoDto
  • 酒店详情返回实体
  • hotel_pictures
  • HotelPictureDto []
  • demo
  • 酒店图片信息
  • └ type_name
  • String
  • 类型名称
  • └ type_code
  • String
  • 类型编码
  • └ picture_address
  • String []
  • 图片集合
  • └ rooms
  • Number
  • 274
  • 房间数
  • └ hid
  • Number
  • 243792003987
  • 旗舰店与标准酒店的绑定ID
  • └ district_code
  • Number
  • 520102
  • 地区code
  • └ position_type
  • byte
  • 0
  • 经纬度类型
  • └ shid
  • Number
  • 50185209
  • 标准酒店id
  • └ city_code
  • Number
  • 520100
  • 城市code
  • └ opening_time
  • String
  • 2017
  • 开业时间
  • └ postal_code
  • String
  • 11@qq.com
  • 邮编
  • └ latitude
  • String
  • 26.575793
  • 纬度
  • └ description
  • String
  • 贵阳亨特索菲特酒店位于城市中心繁华商务地段,毗邻亨特购物广场,邻近风光秀丽的南明河、甲秀楼及文昌阁等著名旅游景点,位置得天独厚。距贵阳龙洞堡国际机场仅20分钟车程,交通极为便利。酒店楼高298米,客房全部配有大型观景窗,房间宽敞舒适,配备高端智能设备。位于酒店57楼的云尚西餐厅全天营业,餐厅户外露台可俯瞰城市绝美景致。是商旅人士下榻的理想之选。
  • 酒店描述
  • └ fun_facilitys
  • String []
  • demo
  • 娱乐设施图片
  • └ domestic
  • byte
  • 0
  • 国别
  • └ floors
  • String
  • 38-54
  • 楼层信息
  • └ province
  • String
  • 贵州省
  • 省份
  • └ country_code
  • Number
  • 1
  • 国家
  • └ city_cn
  • String
  • 贵阳市
  • └ fax
  • String
  • 传真
  • └ hotel_facilitys
  • String []
  • demo
  • 酒店设施
  • └ brand_code
  • String
  • 1997
  • 品牌编码
  • └ facilitys
  • String
  • demo
  • 房型设施
  • └ longitude
  • String
  • 106.71941
  • 经度
  • └ brand_name
  • String
  • 索菲特
  • 品牌名称
  • └ address
  • String
  • 贵州省贵阳市南明区都司高架桥路33号
  • 地址
  • └ star
  • String
  • 5
  • 星级
  • └ province_code
  • Number
  • 520000
  • 省份code
  • └ decorate_time
  • String
  • 2017
  • 装修时间
  • └ name_cn
  • String
  • 贵阳亨特索菲特酒店
  • 酒店中文名称
  • └ hotel_id
  • String
  • 8873
  • 外部酒店id
  • └ check_in
  • String
  • 14:00
  • 最早入住时间
  • └ phone
  • String
  • 0086#0851#88887777
  • 酒店电话
  • └ district
  • String
  • 南明区
  • 地区
  • └ hotel_services
  • String []
  • demo
  • 酒店服务
  • └ check_out
  • String
  • 12:00
  • 最晚离店时间
  • └ country_cn
  • String
  • 中华人民共和国
  • 国家中文名
  • room_details
  • RoomDetailDto []
  • 房型详情
  • └ area
  • String
  • 40
  • 面积
  • └ lowest_price
  • Number
  • 76400
  • 最低价单位分
  • └ lowest_price_to_string
  • String
  • 764
  • 最低价单位元
  • room_type_bed_info
  • RoomTypeBedInfoDto
  • 床型详情
  • └ brief_desc
  • String
  • 双床
  • 简短描述,用于详情页报价前面的床型展示。
  • └ fuzzy_desc
  • String
  • 双床
  • 模糊描述,最精简的描述信息,大床/双床/单人床/多床/床位
  • └ classification_desc
  • String
  • 双床
  • 分类描述
  • └ simple_desc
  • String
  • 2张单人床
  • 简单描述,较长描述省略床宽,但依然会描述具体的床型信息,用于详情页标准房型床型展示
  • └ desc
  • String
  • 2张单人床(1.2M)
  • 描述,长描述,描述为最详细的内容,用于详情页房型详情Dialog,下单页,订单页展
  • └ max_occupancy_icon
  • String
  • demo
  • 入住人数图标
  • └ price_type
  • String
  • CNY
  • 货币类型
  • price_infos
  • PriceInfoDto []
  • 价格信息
  • └ is_guarantee
  • Number
  • 0
  • 是否担保商品
  • └ stock_number
  • Number
  • demo
  • 库存剩余数量
  • └ gid
  • Number
  • 1064830037987
  • 商品id
  • └ cancel_type
  • Number
  • 2
  • 取消政策枚举 01-不可取消 02-免费取消 03-阶梯取消 04-限时免费取消
  • └ dinamic_original_price
  • Number
  • 76400
  • 含税价 均价 单位分
  • └ is_sell_out
  • Number
  • 0
  • 是否已售空
  • └ tax_and_fee_to_string
  • String
  • 109
  • 税费 单位元
  • └ room_total_price
  • Number
  • 131000
  • 不含税总价 单位分
  • └ rp_id
  • Number
  • 2987749478987
  • Rate Plan ID商品定价规则
  • └ rate_id
  • Number
  • 150201875908987
  • 商品最小可售卖粒度
  • └ payment_type
  • Number
  • 1
  • 1:全额支付;5:前台面付;
  • └ dinamic_original_price_to_string
  • String
  • 764
  • 含税价 均价 单位元
  • └ refund_rules
  • String
  • 2021年02月04日00点前取消扣取首晚房费作为手续费。 2021年02月04日00点及以后取消,扣取全额房费。
  • 退订规则
  • └ cancel_insurance_icon
  • String
  • 可购取消险
  • 可够取消险
  • └ rate_price
  • Number
  • 65500
  • 净价均价 不含税
  • └ rate_price_to_string
  • String
  • 1310
  • 净价均价 不含税 单位元
  • └ tax_and_fee
  • Number
  • 10900
  • 税费 单位分
  • └ outer_room_id
  • Number
  • 1075054022987
  • 卖家房型id
  • └ member_level
  • String
  • demo
  • 会员等级
  • └ price_type
  • String
  • CNY
  • 币种CNY 人民币
  • └ breakfast_desc
  • String
  • 含早餐
  • 早餐
  • └ allow_person_number
  • Number
  • 2
  • 表示当前价格允许几人入住
  • └ breakfasts
  • String []
  • 早餐信息 -1 含早、0无早、1单早、2、双早
  • └ cancel_time
  • String
  • 不可取消
  • 取消政策模型同小搜一致即可,入住日往前XX小时
  • └ room_total_price_to_string
  • String
  • demo
  • 不含税总价 保留到元
  • └ cancel_insurance_desc
  • String
  • 购买取消险,未入住可获赔房费损失的90%,7个工作日内理赔到账
  • 取消险文案
  • └ rp_name
  • String
  • 雅高大中华区疯狂大促 - 享受七折优惠+含早餐
  • 商品定价规则标题
  • └ status
  • Number
  • 0
  • 是否售空
  • hotel_dinamic_labels
  • HotelDinamicLabelDto []
  • 详情页会员权益标签
  • └ name
  • String
  • 权益名称
  • └ type
  • String
  • 权益类型
  • └ stock_number_des
  • String
  • 库存数量
  • └ member_room
  • Boolean
  • 是否是会员房
  • └ member_room_v2
  • Boolean
  • 是否是副会员房
  • └ first_live
  • String
  • 首住标签
  • └ member_level_v2
  • String
  • 副会员商品等级
  • └ area_icon
  • String
  • demo
  • 面积图标
  • └ room_name
  • String
  • 高级双床房
  • 房型名称
  • └ room_id
  • Number
  • 61607195
  • 房型id
  • └ network_service
  • String
  • demo
  • 宽带服务
  • └ bed_type_icon
  • String
  • demo
  • 床型图标
  • └ add_bed
  • Number
  • 0
  • 是否可加床
  • └ max_occupancy
  • Number
  • 2
  • 最大入住人数
  • └ pics
  • String []
  • 房型图片
  • facilitys
  • RoomPropertiesDto []
  • 房型设施
  • └ sub_type
  • String
  • -1
  • 设施类型
  • └ value
  • String
  • 电子秤
  • 设施名称
  • └ full
  • Boolean
  • demo
  • 是否满房
  • └ floor
  • String
  • 楼层
  • └ window_type
  • String
  • 窗型
  • └ status
  • byte
  • 0
  • 0-营业中;-1,筹建中;-2,暂停营业;-3,已停业;-4,失效,-5 ,需电话咨询;默认为0
  • └ rating_average
  • String
  • demo
  • 评分
  • └ country_en
  • String
  • 国家英文名
  • └ hotel_policys
  • String []
  • 酒店政策
  • └ error_msg
  • String
  • demo
  • 错误信息

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlitripMerchantGalaxyHotelDetailSearchRequest req = new AlitripMerchantGalaxyHotelDetailSearchRequest();
req.setTenantKey("111");
AlitripMerchantGalaxyHotelDetailSearchRequest.HotelDetailsParam obj1 = new AlitripMerchantGalaxyHotelDetailSearchRequest.HotelDetailsParam();
obj1.setCheckOut("2020-01-02");
obj1.setCheckIn("2020-01-01");
obj1.setHotelId("12345");
obj1.setShid(111111L);
obj1.setMemberLevel("1");
obj1.setAdultNum(1L);
obj1.setChildrenAges("11,12");
obj1.setFewNights(1L);
obj1.setRoomType("FREE_CANCEL");
obj1.setToken("123");
req.setHotelDetailsParam(obj1);
AlitripMerchantGalaxyHotelDetailSearchResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alitrip_merchant_galaxy_hotel_detail_search_response>
    <result>
        <success>true</success>
        <error_code>demo</error_code>
        <content>
            <hotel_pictures>
                <hotel_picture_dto>
                    <type_name></type_name>
                    <type_code></type_code>
                    <picture_address>
                        <string></string>
                    </picture_address>
                </hotel_picture_dto>
            </hotel_pictures>
            <rooms>274</rooms>
            <hid>243792003987</hid>
            <district_code>520102</district_code>
            <position_type>0</position_type>
            <shid>50185209</shid>
            <city_code>520100</city_code>
            <opening_time>2017</opening_time>
            <postal_code>11@qq.com</postal_code>
            <latitude>26.575793</latitude>
            <description>贵阳亨特索菲特酒店位于城市中心繁华商务地段,毗邻亨特购物广场,邻近风光秀丽的南明河、甲秀楼及文昌阁等著名旅游景点,位置得天独厚。距贵阳龙洞堡国际机场仅20分钟车程,交通极为便利。酒店楼高298米,客房全部配有大型观景窗,房间宽敞舒适,配备高端智能设备。位于酒店57楼的云尚西餐厅全天营业,餐厅户外露台可俯瞰城市绝美景致。是商旅人士下榻的理想之选。</description>
            <fun_facilitys>
                <string>demo</string>
            </fun_facilitys>
            <domestic>0</domestic>
            <floors>38-54</floors>
            <province>贵州省</province>
            <country_code>1</country_code>
            <city_cn>贵阳市</city_cn>
            <fax></fax>
            <hotel_facilitys>
                <string>demo</string>
            </hotel_facilitys>
            <brand_code>1997</brand_code>
            <facilitys>demo</facilitys>
            <longitude>106.71941</longitude>
            <brand_name>索菲特</brand_name>
            <address>贵州省贵阳市南明区都司高架桥路33号</address>
            <star>5</star>
            <province_code>520000</province_code>
            <decorate_time>2017</decorate_time>
            <name_cn>贵阳亨特索菲特酒店</name_cn>
            <hotel_id>8873</hotel_id>
            <check_in>14:00</check_in>
            <phone>0086#0851#88887777</phone>
            <district>南明区</district>
            <hotel_services>
                <string>demo</string>
            </hotel_services>
            <check_out>12:00</check_out>
            <country_cn>中华人民共和国</country_cn>
            <room_details>
                <room_detail_dto>
                    <area>40</area>
                    <lowest_price>76400</lowest_price>
                    <lowest_price_to_string>764</lowest_price_to_string>
                    <room_type_bed_info>
                        <brief_desc>双床</brief_desc>
                        <fuzzy_desc>双床</fuzzy_desc>
                        <classification_desc>双床</classification_desc>
                        <simple_desc>2张单人床</simple_desc>
                        <desc>2张单人床(1.2M)</desc>
                    </room_type_bed_info>
                    <max_occupancy_icon>demo</max_occupancy_icon>
                    <price_type>CNY</price_type>
                    <price_infos>
                        <price_info_dto>
                            <is_guarantee>0</is_guarantee>
                            <stock_number>demo</stock_number>
                            <gid>1064830037987</gid>
                            <cancel_type>2</cancel_type>
                            <dinamic_original_price>76400</dinamic_original_price>
                            <is_sell_out>0</is_sell_out>
                            <tax_and_fee_to_string>109</tax_and_fee_to_string>
                            <room_total_price>131000</room_total_price>
                            <rp_id>2987749478987</rp_id>
                            <rate_id>150201875908987</rate_id>
                            <payment_type>1</payment_type>
                            <dinamic_original_price_to_string>764</dinamic_original_price_to_string>
                            <refund_rules>2021年02月04日00点前取消扣取首晚房费作为手续费。
2021年02月04日00点及以后取消,扣取全额房费。</refund_rules>
                            <cancel_insurance_icon>可购取消险</cancel_insurance_icon>
                            <rate_price>65500</rate_price>
                            <rate_price_to_string>1310</rate_price_to_string>
                            <tax_and_fee>10900</tax_and_fee>
                            <outer_room_id>1075054022987</outer_room_id>
                            <member_level>demo</member_level>
                            <price_type>CNY</price_type>
                            <breakfast_desc>含早餐</breakfast_desc>
                            <allow_person_number>2</allow_person_number>
                            <breakfasts>
                                <string></string>
                            </breakfasts>
                            <cancel_time>不可取消</cancel_time>
                            <room_total_price_to_string>demo</room_total_price_to_string>
                            <cancel_insurance_desc>购买取消险,未入住可获赔房费损失的90%,7个工作日内理赔到账</cancel_insurance_desc>
                            <rp_name>雅高大中华区疯狂大促 - 享受七折优惠+含早餐</rp_name>
                            <status>0</status>
                            <hotel_dinamic_labels>
                                <hotel_dinamic_label_dto>
                                    <name></name>
                                    <type></type>
                                </hotel_dinamic_label_dto>
                            </hotel_dinamic_labels>
                            <stock_number_des></stock_number_des>
                            <member_room></member_room>
                            <member_room_v2></member_room_v2>
                            <first_live></first_live>
                            <member_level_v2></member_level_v2>
                        </price_info_dto>
                    </price_infos>
                    <area_icon>demo</area_icon>
                    <room_name>高级双床房</room_name>
                    <room_id>61607195</room_id>
                    <network_service>demo</network_service>
                    <bed_type_icon>demo</bed_type_icon>
                    <add_bed>0</add_bed>
                    <max_occupancy>2</max_occupancy>
                    <pics>
                        <string></string>
                    </pics>
                    <facilitys>
                        <room_properties_dto>
                            <sub_type>-1</sub_type>
                            <value>电子秤</value>
                        </room_properties_dto>
                    </facilitys>
                    <full>demo</full>
                    <floor></floor>
                    <window_type></window_type>
                </room_detail_dto>
            </room_details>
            <status>0</status>
            <rating_average>demo</rating_average>
            <country_en></country_en>
            <hotel_policys>
                <string></string>
            </hotel_policys>
        </content>
        <error_msg>demo</error_msg>
    </result>
</alitrip_merchant_galaxy_hotel_detail_search_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>

错误码解释

错误码 错误描述 解决方案
isp.top-mapping-parse-error top接口映射分析错误 人工排查

API工具

如何获得此API

FAQ

返回
顶部