获取可用地区

根据动态子账号查询可用地区树。

接口信息

GET /client/dynamics/region/countries

请求头

参数名必选类型说明
x-merchant-tokenstring商户访问令牌
x-merchant-codestring商户编码

请求参数

参数名必选类型说明
accountIdLong子账号 ID

请求示例

const response = await fetch('/client/dynamics/region/countries?accountId=123', {
  method: 'GET',
  headers: {
    'x-merchant-token': 'your-token-here',
    'x-merchant-code': 'your-merchant-code'
  }
})

const result = await response.json()

响应示例

{
  "msg": "操作成功",
  "code": 200,
  "data": [
    {
      "countryCode": "US",
      "countryName": "United States",
      "states": [
        {
          "stateCode": "CA",
          "stateName": "California",
          "cities": [
            {
              "cityCode": "LosAngeles",
              "cityName": "Los Angeles"
            }
          ]
        }
      ]
    }
  ]
}

响应参数说明

参数名类型描述
codeInteger业务状态码
msgString提示信息
dataArray国家列表,每项含下级州/城市
data[].countryCodeString国家代码
data[].countryNameString国家名称
data[].statesArray州/省列表
data[].states[].stateCodeString州/省代码
data[].states[].stateNameString州/省名称
data[].states[].citiesArray城市列表
data[].states[].cities[].cityCodeString城市代码
data[].states[].cities[].cityNameString城市名称

注意事项

  1. 接口返回国家/州/城市树,前端可按需展开为三级下拉。