地區(qū)數(shù)據(jù) 3.7

獲取地區(qū)根節(jié)點(diǎn)

• API 地址：area/root
• HTTP 方法：GET
• 授權(quán)方式：通用授權(quán)

請(qǐng)求參數(shù)

無(wú)

返回?cái)?shù)據(jù)示例

{
  "error_code": 0,
  "error_msg": "調(diào)用成功",
  "data": [
    { "area_id":"017-000000000000000000000000000000000086", "area_name":"中國(guó)" }
  ]
}

返回?cái)?shù)據(jù)說(shuō)明

字段	類型	字段說(shuō)明
area_id	string(40)	地區(qū)唯一 ID
area_name	string	地區(qū)名稱

在系統(tǒng)內(nèi)置的地區(qū)數(shù)據(jù)中，如未啟用 國(guó)家 字段，則此處返回的是省份列表

獲取子級(jí)地區(qū)

• API 地址：area/subarea
• HTTP 方法：GET
• 授權(quán)方式：通用授權(quán)

請(qǐng)求參數(shù)

參數(shù)	類型	是否必須	參數(shù)說(shuō)明
parent	string	是	父級(jí)地區(qū)唯一 ID

返回?cái)?shù)據(jù)示例

{
  "error_code": 0,
  "error_msg": "調(diào)用成功",
  "data": [
    { "area_id":"017-000000000000000000000000000000130000", "area_name":"河北省" },
    { "area_id":"017-000000000000000000000000000000140000", "area_name":"山西省" },
    { "area_id":"017-000000000000000000000000000000150000", "area_name":"內(nèi)蒙古自治區(qū)" }
  ]
}

返回?cái)?shù)據(jù)說(shuō)明

字段	類型	字段說(shuō)明
area_id	string(40)	地區(qū)唯一 ID
area_name	string	地區(qū)名稱

此接口在實(shí)際應(yīng)用中，應(yīng)首先獲取主地區(qū)，而后再逐級(jí)獲取 省 > 市 > 區(qū)縣