taobao.xhotel.city.distribution.get (酒店城市数据获取接口-分销场景使用)

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

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
start Number 必须 0 分页读取的开始下标,从0开始
count Number 必须 100 分页读取的城市个数,最小值为1,最大值为200

响应参数

名称 类型 示例值 描述
total_results Number 1000 总数
version Number 150 城市数据的版本。所有城市数据有一个统一的版本,与入参start和count无关。 ISV可通过版本判断城市数据是否有更新。判断方法如下:ISV在第一次拉取数据时请将version保存在本地;以后再调用接口时请比较本地version与接口返回的version。如果本地version小于于接口返回version,则说明城市数据有更新;如果本地version等于接口返回version,则说明城市数据无更新,不需要再继续拉取城市数据。
divisions 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);
XhotelCityDistributionGetRequest req = new XhotelCityDistributionGetRequest();
req.setStart(0L);
req.setCount(100L);
XhotelCityDistributionGetResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<xhotel_city_distribution_get_response>
    <total_results>1000</total_results>
    <version>150</version>
    <divisions>
        <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>
    </divisions>
</xhotel_city_distribution_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

返回
顶部