BSS-OpenAPI

获取国家、省份、城市信列表信息

POST

/geography/country/tier/all

国家地区配置 - 国家相关接口

请求参数

Header 参数

X-Auth-Appid

string

可选

示例值:

appbe2a8f185734

Body 参数application/json

alpha3Code

array[string]

必需

三字母代码（国家key）

provinceKey

array[string]

省份key

必需

cityKey

array[string]

城市key

必需

示例

{
  "alpha3Code": [
    "1"
  ],
  "provinceKey": [
    "3124"
  ],
  "cityKey": [
    "36397"
  ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/geography/country/tier/all' \
--header 'X-Auth-Appid: appbe2a8f185734' \
--header 'Content-Type: application/json' \
--data-raw '{
    "alpha3Code": [
        "1"
    ],
    "provinceKey": [
        "3124"
    ],
    "cityKey": [
        "36397"
    ]
}'

返回响应

🟢200成功

application/json

Body

code

integer

必需

data

object

必需

country

array [object {11}]

国家列表

必需

province

array [object {7}]

省份列表

必需

city

array [object {7}]

城市列表

必需

msg

string

必需

traceId

string

必需

示例

{
  "code": 0,
  "data": {
    "country": [
      {
        "id": 46,
        "alpha2Code": "CN",
        "alpha3Code": "1",
        "digitalCode": "156",
        "currencyCode": "CNY",
        "areaCode": "+86",
        "countryNameEn": "China",
        "countryNameSc": "中国",
        "countryNameTc": "中國",
        "localLanguage": "汉语",
        "status": 1
      }
    ],
    "province": [
      {
        "id": 3,
        "provinceKey": "3124",
        "countryKey": "1",
        "provinceNameEn": "Beijing",
        "provinceNameSc": "北京",
        "provinceNameTc": "北京",
        "status": 1
      }
    ],
    "city": [
      {
        "id": 1,
        "cityKey": "36397",
        "provinceKey": "3124",
        "cityNameEn": "Dongcheng",
        "cityNameSc": "东城",
        "cityNameTc": "東城",
        "status": 1
      }
    ]
  },
  "msg": "string",
  "traceId": "string"
}

修改于 2025-04-15 09:09:34

获取国家、省份、城市区域信息

更新国家