文档中心 > API类目 > 蚂蚁采购

taobao.xhotel.calendar.list (飞猪酒店列表页)

飞猪酒店列表页

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
city_code String 必须 30010 城市code
check_in String 必须 2024-06-11 入店时间
check_out String 必须 2024-06-12 离店日期,格式2013-10-31
key_words String 可选 123 关键字,多个值(以空白分隔),是and的关系
star String 可选 0 逗号分隔的数字0-客栈公寓|1-经济连锁|2-二星级/以下|3-三星级/舒适|4-四星级/高档|5-五星级/豪华
radius String 可选 -1
  • 默认值:-1
  • 半径范围,单位米
    dir String 必须 0
  • 默认值:0
  • 1-升序 or 0-降序
    page_no String 必须 1
  • 默认值:1
  • 页码, 默认为1
    page_size String 必须 10
  • 默认值:10
  • 分页大小,不能超过50,默认20
    offset Number 必须 0
  • 默认值:-1
  • 查询偏移量,需要上一页的返回值中的offset回传
    city_name String 可选 杭州市 cityName String 否 城市名称,与城市码之间必须有一个
    order Number 可选 0
  • 默认值:0
  • 必填项, 排序方式 0-默认|1-销量|2-价格|3-距离|4-好评|5-通用排序
    price_min Number 可选 100 最低价
    price_max Number 可选 800 最高价
    brand_code String 可选 91 品牌码
    adult_num Number 可选 2
  • 默认值:2
  • 成人数
    children_ages String 可选 12,6,2 儿童年龄,多个以逗号分隔
    user_id String 可选 2214601320409 用户
    sversion Number 可选 85
  • 默认值:85
  • 版本号
    longitude String 可选 1.09399 经度
    latitude String 可选 1.0987 纬度
    support_second_search Boolean 可选 false
  • 默认值:false
  • 是否需要少无结果推荐功能

    响应参数

    名称 类型 示例值 描述
    result Result 返回值
    • model
    • SearchHotelListVO
    • 列表页返回对象
    • hotel_list
    • HotelListInfo []
    • 酒店列表
    • └ index
    • String
    • 0
    • 返回的卡片酒店位置
    • └ shid
    • Number
    • 51234576
    • 标准酒店id
    • └ name
    • String
    • 曼谷万豪酒店
    • 酒店中文名称
    • └ english_name
    • String
    • english name
    • 酒店英文名称
    • └ pic_url
    • String
    • https://
    • 酒店图片
    • └ original_price_with_tax
    • Number
    • 900
    • 酒店划线价
    • └ price_with_tax
    • Number
    • 200
    • 酒店售价
    • └ rate_number_without_unit
    • String
    • 4.8
    • 评分
    • └ rate_count
    • String
    • 251条评价
    • 评价书
    • └ assist_and_rec_poi
    • String
    • "近惠恭王·素铁讪"
    • 关联poi
    • hotel_dinamic_label
    • HotelDinamicLabelDTO []
    • 酒店标签
    • └ name
    • String
    • 天际美景
    • 标签名称
    • └ hotel_brand_desc
    • String
    • 雅高旗下
    • 品牌
    • └ star_logo
    • String
    • https://img.alicdn.com/imgextra/i4/O1CN01pQ9rOJ1ro7EUslkiU_!!6000000005677-2-tps-100-80.png
    • 酒店类型
    • └ jump_link
    • String
    • 详情页跳转链接
    • └ longitude
    • String
    • 1.9983
    • 经度
    • └ latitude
    • String
    • 1.9873
    • 维度
    • └ offset
    • Number
    • 11
    • 酒店偏移量(用于下一页的入参)
    • exception_info
    • ExceptionInfoVO
    • 错误信息
    • └ error_code
    • String
    • HWSEARCH_LIST_SENTINEL_ERROR
    • 错误码
    • └ error_msg
    • String
    • 调用平台获取附近定位失败
    • 错误信息
    • └ trace_id
    • String
    • traceId
    • traceId
    • └ debug_search_id
    • String
    • 123as123412314
    • 请求的唯一键,用于排查问题
    • └ http_status_code
    • Number
    • 200
    • 200:成功

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    XhotelCalendarListRequest req = new XhotelCalendarListRequest();
    req.setCityCode("30010");
    req.setCheckIn("2024-06-11");
    req.setCheckOut("2024-06-12");
    req.setKeyWords("123");
    req.setStar("0");
    req.setRadius("-1");
    req.setDir("0");
    req.setPageNo("1");
    req.setPageSize("10");
    req.setOffset(0L);
    req.setCityName("杭州市");
    req.setOrder(0L);
    req.setPriceMin(100L);
    req.setPriceMax(800L);
    req.setBrandCode("91");
    req.setAdultNum(2L);
    req.setChildrenAges("12,6,2");
    req.setUserId("2214601320409");
    req.setSversion(85L);
    req.setLongitude("1.09399");
    req.setLatitude("1.0987");
    req.setSupportSecondSearch(false);
    XhotelCalendarListResponse rsp = client.execute(req);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <xhotel_calendar_list_response>
        <result>
            <model>
                <hotel_list>
                    <hotel_list_info>
                        <index>0</index>
                        <shid>51234576</shid>
                        <name>曼谷万豪酒店</name>
                        <english_name>english name</english_name>
                        <pic_url>https://</pic_url>
                        <original_price_with_tax>900</original_price_with_tax>
                        <price_with_tax>200</price_with_tax>
                        <rate_number_without_unit>4.8</rate_number_without_unit>
                        <rate_count>251条评价</rate_count>
                        <assist_and_rec_poi>&quot;近惠恭王·素铁讪&quot;</assist_and_rec_poi>
                        <hotel_dinamic_label>
                            <hotel_dinamic_label_d_t_o>
                                <name>天际美景</name>
                            </hotel_dinamic_label_d_t_o>
                        </hotel_dinamic_label>
                        <hotel_brand_desc>雅高旗下</hotel_brand_desc>
                        <star_logo>https://img.alicdn.com/imgextra/i4/O1CN01pQ9rOJ1ro7EUslkiU_!!6000000005677-2-tps-100-80.png</star_logo>
                        <longitude>1.9983</longitude>
                        <latitude>1.9873</latitude>
                    </hotel_list_info>
                </hotel_list>
                <offset>11</offset>
                <exception_info>
                    <error_code>HWSEARCH_LIST_SENTINEL_ERROR</error_code>
                    <error_msg>调用平台获取附近定位失败</error_msg>
                    <trace_id>traceId</trace_id>
                </exception_info>
                <debug_search_id>123as123412314</debug_search_id>
            </model>
            <http_status_code>200</http_status_code>
        </result>
    </xhotel_calendar_list_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

    返回
    顶部