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

alibaba.fliggy.xhotel.city.get (飞猪四海通城市酒店数据获取接口)

引流API,对外提供酒店城市数据

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
start Number 必须 0 分页读取的开始下标,从0开始
count Number 必须 100 分页读取的城市个数,最小值为1,最大值为200
promote_app_key Number 必须 1001 媒体ID
promotion_position_id Number 必须 1001 推广位id
activity_id String 必须 1234 活动id

响应参数

名称 类型 示例值 描述
result Result 查询结果
  • └ msg_code
  • String
  • 0
  • 错误码
  • └ msg_info
  • String
  • 服务异常
  • 错误信息
  • └ success
  • Boolean
  • true
  • 返回响应
  • model
  • QueryCityHotelResponse
  • 酒店城市数据
  • └ total_results
  • Number
  • 10000
  • 总数
  • hotel_division
  • HotelDivision []
  • 酒店区域数据列表
  • └ region
  • Number
  • 0
  • 0:国内;1:国外
  • └ code
  • Number
  • 330100
  • 城市编码
  • └ name
  • String
  • 杭州
  • 城市名称
  • └ level
  • Number
  • 3
  • 层级,1:国家,2:州省,3:城市,4:区县
  • └ type
  • Number
  • 0
  • 类型,0:普通,1:景点,cityTag,如千岛湖
  • └ parent_code
  • Number
  • 330000
  • 父行政区编码,例如杭州市(330100)的父行政区为浙江省(330000)。注意:如果parent_code的值为0,表示该行政区为最高级别的行政区,没有父行政区。
  • └ searchable
  • Boolean
  • true
  • code是否可用来搜索酒店,true:code可直接用于搜索酒店,false: code不可直接用于搜索酒店。

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaFliggyXhotelCityGetRequest req = new AlibabaFliggyXhotelCityGetRequest();
req.setStart(0L);
req.setCount(100L);
req.setPromoteAppKey(1001L);
req.setPromotionPositionId(1001L);
req.setActivityId("1234");
AlibabaFliggyXhotelCityGetResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_fliggy_xhotel_city_get_response>
    <result>
        <msg_code>0</msg_code>
        <msg_info>服务异常</msg_info>
        <success>true</success>
        <model>
            <total_results>10000</total_results>
            <hotel_division>
                <hotel_division>
                    <region>0</region>
                    <code>330100</code>
                    <name>杭州</name>
                    <level>3</level>
                    <type>0</type>
                    <parent_code>330000</parent_code>
                    <searchable>true</searchable>
                </hotel_division>
            </hotel_division>
        </model>
    </result>
</alibaba_fliggy_xhotel_city_get_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

返回
顶部