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

alitrip.merchant.galaxy.hotel.list.search (星河-酒店列表页搜索)

星河产品=酒店列表页搜索

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
tenant_key String 必须 123 商家租户id
list_search_param ListSearchParam 必须 请求参数
  • └ price_max
  • Number
  • 可选
  • 1
  • 最高价格
  • └ adult_num
  • Number
  • 必须
  • 2
  • 成人数
  • └ child_num
  • Number
  • 必须
  • 1
  • 儿童数
  • └ offset
  • Number
  • 可选
  • 0
  • 偏移量
  • └ star
  • String
  • 可选
  • -1
  • 星级筛选
  • └ city_code
  • String
  • 必须
  • 330100
  • 城市编码,默认上海
  • └ page_size
  • Number
  • 可选
  • 20
  • 每页数量
  • └ dir
  • Number
  • 可选
  • 1
  • 升降序 0降序 1升序
  • └ children_ages
  • String
  • 可选
  • 5
  • 儿童年龄
  • └ price_min
  • Number
  • 可选
  • 0
  • 最低价格
  • └ check_in
  • String
  • 必须
  • 2021-02-25
  • 入店时间
  • └ page_no
  • Number
  • 可选
  • 1
  • 当前页
  • └ check_out
  • String
  • 必须
  • 2021-02-26
  • 离店时间
  • └ brand
  • String
  • 可选
  • 1997
  • 品牌编码
  • └ token
  • String
  • 可选
  • 123
  • 用户登录信息
  • └ member_level
  • String
  • 可选
  • 3
  • 会员等级
  • └ voucher_id
  • String
  • 可选
  • 1
  • 套餐代金券id
  • └ version
  • Number
  • 可选
  • 1
  • 版本号

响应参数

名称 类型 示例值 描述
result PageableResponse 返回结果
  • └ size
  • Number
  • 8
  • 当前页的数量
  • └ has_next_page
  • Boolean
  • false
  • 是否有下一页
  • └ page_no
  • Number
  • 1
  • 当前页
  • └ success
  • Boolean
  • true
  • 是否成功
  • └ page_size
  • Number
  • 10
  • 每页的数量
  • └ error_code
  • String
  • error
  • 错误编码
  • └ total_page_num
  • Number
  • 1
  • 总页数
  • └ total_count
  • Number
  • 8
  • 总数量
  • contents
  • HotelListSearchDto []
  • 返回类型
  • └ brand_name
  • String
  • 索菲特
  • 品牌名字
  • └ address
  • String
  • 西湖大道333号近 南山路(近西湖,雷峰塔,中国美院,南山路,河坊街)
  • 地址详情
  • └ position_type
  • Number
  • 0
  • 经纬度类型 0-高德 1-google
  • └ hotel_facility_list
  • String []
  • ["24小时前台","大堂吧","中餐厅","西餐厅","商务中心","残疾人设施","咖啡厅","会议室","室内游泳池","前台贵重物品保险柜","储物柜","免费停车场","吸烟区","健身房","行政酒廊","电梯","公共区域免费wifi"]
  • 酒店设施
  • └ star
  • String
  • 5
  • 酒店星级
  • └ shid
  • Number
  • 10023179
  • 标准库id
  • └ latitude
  • String
  • 30.245586
  • 纬度
  • └ picture_url
  • String
  • https://fm-unicorn-hotel.oss-cn-beijing.aliyuncs.com/10006373010/hotel/5554/%E5%A4%96%E8%A7%82/O1CN01L77i2y1Gyyhm2lxTw_%21%216000000000692-0-hotel.jpg
  • 图片头图
  • └ name_cn
  • String
  • 杭州索菲特西湖大酒店
  • 酒店中文名
  • └ hotel_id
  • String
  • 5554
  • 酒店id
  • └ domestic
  • String
  • 0
  • 国内外 0国内 1国外
  • └ fun_facility_list
  • String []
  • ["spa/水疗","桑拿"]
  • 娱乐设施
  • └ brand_url
  • String
  • demo
  • 品牌头图
  • └ price
  • Number
  • 100
  • 酒店商品的最低价格
  • └ hotel_service_list
  • String []
  • ["接送服务","行李寄存","叫醒服务","票务服务","叫车服务","礼宾接待服务","租车","送餐服务","24小时大堂经理","看护小孩服务","管家服务","外币兑换","洗衣服务","24小时客房服务"]
  • 酒店服务
  • └ city_cn
  • String
  • 杭州市
  • 城市中文名
  • └ id
  • Number
  • 530
  • 酒店id
  • facility_list
  • FacilityDto []
  • demo
  • 设施icon
  • └ icon
  • String
  • https://fm-unicorn-hotel.oss-cn-beijing.aliyuncs.com/10006373010/facility/%E5%81%A5%E8%BA%AB%E6%88%BF.png
  • 设施图片
  • └ name
  • String
  • 健身房
  • 设施名字
  • └ id
  • Number
  • 2
  • 设施id
  • └ country_cn
  • String
  • 中华人民共和国
  • 国家中文名
  • └ room_name_cn
  • String
  • 大床房
  • 最低价格房型名
  • └ full
  • Boolean
  • false
  • 是否满房 0未满房1满房
  • └ longitude
  • String
  • 30.245586
  • 经度
  • └ brand_code
  • String
  • 1997
  • 品牌code
  • └ hot
  • Number
  • 1
  • 是否热门
  • voucher_info
  • VoucherVo
  • 1
  • 代金券实体类
  • └ is_mark_up
  • Boolean
  • 1
  • 是否加价
  • └ mark_up_info
  • String
  • 1
  • 加价信息
  • └ mark_up_rule_list
  • String []
  • 1
  • 加价规则
  • └ mark_up_amount
  • Number
  • 1
  • 加价金额
  • └ city_py
  • String
  • S
  • 城市首字母
  • └ phone
  • String
  • 1
  • 酒店电话
  • └ error_msg
  • String
  • 1
  • 错误信息

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlitripMerchantGalaxyHotelListSearchRequest req = new AlitripMerchantGalaxyHotelListSearchRequest();
req.setTenantKey("123");
AlitripMerchantGalaxyHotelListSearchRequest.ListSearchParam obj1 = new AlitripMerchantGalaxyHotelListSearchRequest.ListSearchParam();
obj1.setPriceMax(1L);
obj1.setAdultNum(2L);
obj1.setChildNum(1L);
obj1.setOffset(0L);
obj1.setStar("-1");
obj1.setCityCode("330100");
obj1.setPageSize(20L);
obj1.setDir(1L);
obj1.setChildrenAges("5");
obj1.setPriceMin(0L);
obj1.setCheckIn("2021-02-25");
obj1.setPageNo(1L);
obj1.setCheckOut("2021-02-26");
obj1.setBrand("1997");
obj1.setToken("123");
obj1.setMemberLevel("3");
obj1.setVoucherId("1");
obj1.setVersion(1L);
req.setListSearchParam(obj1);
AlitripMerchantGalaxyHotelListSearchResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alitrip_merchant_galaxy_hotel_list_search_response>
    <result>
        <size>8</size>
        <has_next_page>false</has_next_page>
        <page_no>1</page_no>
        <success>true</success>
        <page_size>10</page_size>
        <error_code>error</error_code>
        <total_page_num>1</total_page_num>
        <total_count>8</total_count>
        <contents>
            <hotel_list_search_dto>
                <brand_name>索菲特</brand_name>
                <address>西湖大道333号近 南山路(近西湖,雷峰塔,中国美院,南山路,河坊街)</address>
                <position_type>0</position_type>
                <hotel_facility_list>
                    <string>[&quot;24小时前台&quot;</string>
                    <string>&quot;大堂吧&quot;</string>
                    <string>&quot;中餐厅&quot;</string>
                    <string>&quot;西餐厅&quot;</string>
                    <string>&quot;商务中心&quot;</string>
                    <string>&quot;残疾人设施&quot;</string>
                    <string>&quot;咖啡厅&quot;</string>
                    <string>&quot;会议室&quot;</string>
                    <string>&quot;室内游泳池&quot;</string>
                    <string>&quot;前台贵重物品保险柜&quot;</string>
                    <string>&quot;储物柜&quot;</string>
                    <string>&quot;免费停车场&quot;</string>
                    <string>&quot;吸烟区&quot;</string>
                    <string>&quot;健身房&quot;</string>
                    <string>&quot;行政酒廊&quot;</string>
                    <string>&quot;电梯&quot;</string>
                    <string>&quot;公共区域免费wifi&quot;]</string>
                </hotel_facility_list>
                <star>5</star>
                <shid>10023179</shid>
                <latitude>30.245586</latitude>
                <picture_url>https://fm-unicorn-hotel.oss-cn-beijing.aliyuncs.com/10006373010/hotel/5554/%E5%A4%96%E8%A7%82/O1CN01L77i2y1Gyyhm2lxTw_%21%216000000000692-0-hotel.jpg</picture_url>
                <name_cn>杭州索菲特西湖大酒店</name_cn>
                <hotel_id>5554</hotel_id>
                <domestic>0</domestic>
                <fun_facility_list>
                    <string>[&quot;spa/水疗&quot;</string>
                    <string>&quot;桑拿&quot;]</string>
                </fun_facility_list>
                <brand_url>demo</brand_url>
                <price>100</price>
                <hotel_service_list>
                    <string>[&quot;接送服务&quot;</string>
                    <string>&quot;行李寄存&quot;</string>
                    <string>&quot;叫醒服务&quot;</string>
                    <string>&quot;票务服务&quot;</string>
                    <string>&quot;叫车服务&quot;</string>
                    <string>&quot;礼宾接待服务&quot;</string>
                    <string>&quot;租车&quot;</string>
                    <string>&quot;送餐服务&quot;</string>
                    <string>&quot;24小时大堂经理&quot;</string>
                    <string>&quot;看护小孩服务&quot;</string>
                    <string>&quot;管家服务&quot;</string>
                    <string>&quot;外币兑换&quot;</string>
                    <string>&quot;洗衣服务&quot;</string>
                    <string>&quot;24小时客房服务&quot;]</string>
                </hotel_service_list>
                <city_cn>杭州市</city_cn>
                <id>530</id>
                <facility_list>
                    <facility_dto>
                        <icon>https://fm-unicorn-hotel.oss-cn-beijing.aliyuncs.com/10006373010/facility/%E5%81%A5%E8%BA%AB%E6%88%BF.png</icon>
                        <name>健身房</name>
                        <id>2</id>
                    </facility_dto>
                </facility_list>
                <country_cn>中华人民共和国</country_cn>
                <room_name_cn>大床房</room_name_cn>
                <full>false</full>
                <longitude>30.245586</longitude>
                <brand_code>1997</brand_code>
                <hot>1</hot>
                <voucher_info>
                    <is_mark_up>1</is_mark_up>
                    <mark_up_info>1</mark_up_info>
                    <mark_up_rule_list>
                        <string>1</string>
                    </mark_up_rule_list>
                    <mark_up_amount>1</mark_up_amount>
                </voucher_info>
                <city_py>S</city_py>
                <phone>1</phone>
            </hotel_list_search_dto>
        </contents>
        <error_msg>1</error_msg>
    </result>
</alitrip_merchant_galaxy_hotel_list_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>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部