获取城市列表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": "成功"
}