地區數據 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	地區名稱

此接口在實際應用中，應首先獲取主地區，而后再逐級獲取 省 > 市 > 區縣