文档中心 > API类目 > 阿信-基础数据

taobao.alitrip.travel.fsc.route.api.division.get (获取国家城市信息)

获取国家城市信息

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
fsc_division_query_request FscDivisionQueryRequest 必须 fscDivisionQueryRequest
  • └ division_type
  • String
  • 可选
  • ABROAD
  • 行政区划类型(DOMAIN:境内,ABROAD:出境)
  • └ keyword
  • String
  • 可选
  • 曼谷
  • 关键字
  • └ country_id
  • Number
  • 可选
  • 900170
  • 国家ID
  • └ level
  • Number
  • 可选
  • 4
  • 行政区划级别(2-国家; 4-城市)
  • └ page_size
  • Number
  • 可选
  • 20
  • 分页大小(最大100)
  • └ page_index
  • Number
  • 可选
  • 1
  • 页码
  • └ supplier_id
  • String
  • 可选
  • 123
  • 供应商id

响应参数

名称 类型 示例值 描述
top_result TopResult 通用返回结果
  • └ success
  • Boolean
  • true
  • 是否成功
  • └ error_code
  • String
  • SYSTEM_ERROR
  • 错误码
  • └ error_msg
  • String
  • 授权异常
  • 错误信息
  • fsc_trip_division_api_response
  • FscTripDivisionApiResponse
  • 业务数据
  • └ total
  • Number
  • 100
  • 数据总条数
  • └ page_size
  • Number
  • 20
  • 分页大小(最大100)
  • └ page_index
  • Number
  • 1
  • 页码
  • data
  • FscTripDivisionApiDto []
  • 返回数据
  • └ division_id
  • Number
  • 123
  • 目的地ID
  • └ name
  • String
  • 曼谷
  • 行政区划名称
  • └ name_en
  • String
  • Bankok
  • 行政区划英文名
  • └ level
  • Number
  • 4
  • 行政区划级别
  • └ parent_id
  • Number
  • 12
  • 行政区划父级ID
  • └ country_name
  • String
  • 泰国
  • 国家名称
  • └ abroad
  • Boolean
  • true
  • 是否境外

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlitripTravelFscRouteApiDivisionGetRequest req = new AlitripTravelFscRouteApiDivisionGetRequest();
AlitripTravelFscRouteApiDivisionGetRequest.FscDivisionQueryRequest obj1 = new AlitripTravelFscRouteApiDivisionGetRequest.FscDivisionQueryRequest();
obj1.setDivisionType("ABROAD");
obj1.setKeyword("曼谷");
obj1.setCountryId(900170L);
obj1.setLevel(4L);
obj1.setPageSize(20L);
obj1.setPageIndex(1L);
obj1.setSupplierId("123");
req.setFscDivisionQueryRequest(obj1);
AlitripTravelFscRouteApiDivisionGetResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alitrip_travel_fsc_route_api_division_get_response>
    <top_result>
        <success>true</success>
        <error_code>SYSTEM_ERROR</error_code>
        <error_msg>授权异常</error_msg>
        <fsc_trip_division_api_response>
            <total>100</total>
            <page_size>20</page_size>
            <page_index>1</page_index>
            <data>
                <fsc_trip_division_api_dto>
                    <division_id>123</division_id>
                    <name>曼谷</name>
                    <name_en>Bankok</name_en>
                    <level>4</level>
                    <parent_id>12</parent_id>
                    <country_name>泰国</country_name>
                    <abroad>true</abroad>
                </fsc_trip_division_api_dto>
            </data>
        </fsc_trip_division_api_response>
    </top_result>
</alitrip_travel_fsc_route_api_division_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

返回
顶部