获取城市列表V2 - 在途商旅

接口调用请求说明请求方法：POST 功能描述：此接口用于获取在途系统城市数据，返回结果为城市数据。新增了包含国内外的城市数据。
限流说明：同一时刻同一家企业只能有一个请求，超过返回错误码：RATE_LIMITED

请求参数

Query 参数

access_token

string

必需

Body 参数application/json

countryCode

string

可选

国家编码；对应值见：https://apifox.com/apidoc/shared-dc2185cb-5405-431d-9c3b-f0dcaa3f44ec/doc-3198732

codes

array[integer]

行政区ID集合

可选

levels

array[string]

可选

行政区级别：0-国际，1-国家，2-省份，3-城市，4-区县

pageNum

integer

可选

页码（不传默认第 1 页）

pageSize

integer

可选

每页显示数量（不传默认 10 条，超出 10000 条只返回 10000 条）

示例

{
  "countryCode": "CN",
  "codes": [
    10001,
    719419
  ],
  "levels": [
    "3",
    "1"
  ],
  "pageNum": 1,
  "pageSize": 10
}

返回响应

🟢200成功

application/json

Body

error

string

必需

data

object

必需

list

array [object {8}]

查询城市数据结果

必需

pageNum

integer

当前页

必需

pageSize

integer

每页数量

必需

pages

integer

总页数

必需

total

integer

总条数

必需

error_description

string

必需

示例

{
  "error": "0",
  "data": {
    "list": [
      {
        "code": 719408,
        "level": "0",
        "nameCn": "行政区域测试",
        "sort": 1
      },
      {
        "code": 10001,
        "countryCode": "CN",
        "level": "3",
        "nameCn": "北京",
        "nameEn": "beijingshi",
        "parentCode": 10000,
        "sort": 2
      },
      {
        "code": 719419,
        "countryCode": "CN",
        "level": "3",
        "nameCn": "行政区域测试1-2",
        "nameEn": "xzqycs1-2",
        "parentCode": 719408,
        "sort": 4,
        "type": "2"
      },
      {
        "code": 10020,
        "countryCode": "CN",
        "level": "3",
        "nameCn": "天津",
        "nameEn": "tianjinshi",
        "parentCode": 10019,
        "sort": 21
      },
      {
        "code": 719421,
        "level": "2",
        "nameCn": "行政区域测试1-3",
        "parentCode": 719408,
        "sort": 32,
        "type": "2"
      },
      {
        "code": 10039,
        "countryCode": "CN",
        "level": "3",
        "nameCn": "石家庄",
        "nameEn": "shijiazhuangshi",
        "parentCode": 10038,
        "sort": 40
      },
      {
        "code": 10222,
        "countryCode": "CN",
        "level": "3",
        "nameCn": "太原",
        "nameEn": "taiyuanshi",
        "parentCode": 10221,
        "sort": 223
      },
      {
        "code": 10354,
        "countryCode": "CN",
        "level": "3",
        "nameCn": "呼和浩特",
        "nameEn": "huhehaoteshi",
        "parentCode": 10353,
        "sort": 355
      },
      {
        "code": 10471,
        "countryCode": "CN",
        "level": "3",
        "nameCn": "沈阳",
        "nameEn": "shenyangshi",
        "parentCode": 10470,
        "sort": 472
      },
      {
        "code": 10587,
        "countryCode": "CN",
        "level": "3",
        "nameCn": "长春",
        "nameEn": "changchunshi",
        "parentCode": 10586,
        "sort": 588
      }
    ],
    "pageNum": 1,
    "pageSize": 10,
    "pages": 64146,
    "total": 641455
  },
  "error_description": "成功"
}