地区数据 3.7

获取地区根节点

• API 地址：area/root
• HTTP 方法：GET
• 授权方式：通用授权

请求参数

无

返回数据示例

{
  "error_code": 0,
  "error_msg": "调用成功",
  "data": [
    { "area_id":"017-000000000000000000000000000000000086", "area_name":"中国" }
  ]
}

返回数据说明

字段	类型	字段说明
area_id	string(40)	地区唯一 ID
area_name	string	地区名称

在系统内置的地区数据中，如未启用 国家 字段，则此处返回的是省份列表

获取子级地区

• API 地址：area/subarea
• HTTP 方法：GET
• 授权方式：通用授权

请求参数

参数	类型	是否必须	参数说明
parent	string	是	父级地区唯一 ID

返回数据示例

{
  "error_code": 0,
  "error_msg": "调用成功",
  "data": [
    { "area_id":"017-000000000000000000000000000000130000", "area_name":"河北省" },
    { "area_id":"017-000000000000000000000000000000140000", "area_name":"山西省" },
    { "area_id":"017-000000000000000000000000000000150000", "area_name":"内蒙古自治区" }
  ]
}

返回数据说明

字段	类型	字段说明
area_id	string(40)	地区唯一 ID
area_name	string	地区名称

此接口在实际应用中，应首先获取主地区，而后再逐级获取 省 > 市 > 区县