全国行政区域查询API
接口描述
全国行政区域查询API，支持省份，城市，区县，乡镇街道最大4级划分。
GET https://www.idcd.com/api/china-area
输入参数
以下请求参数列表仅列出了接口请求参数，不包含公共参数，完整公共参数列表见 公共请求参数。
| 参数名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| parent_id | Int | 是 | 默认0为省直辖市 |
输出参数
| 参数名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| id | Int | 是 | 区域ID |
| parent_id | Int | 是 | 父级ID |
| deep | Int | 是 | 当前层级 |
| name | String | 是 | 名称 |
| pinyin | String | 是 | 拼音名称 |
| ext_name | String | 是 | 扩展名称 |
示例
- 输入示例
curl --location --request GET 'https://www.idcd.com/api/china-area?parent_id=0' \
--header 'ClientID: df77f2de-2924-4499-adda-1c4cc243625a' \
--header 'Nonce: v0j38hHHUEqFwoh0Gc8Rbfi737xtIpLL' \
--header 'Timestamp: 1716085926' \
--header 'Signature: 5b1230f42bad2ffd5ad09890a8ebb47c02d74668be0cf7bb54a0f6a14996117b' \
--header 'SignatureMethod: HmacSHA256'
- 输出示例
{
"status": true,
"code": 200,
"message": "Success",
"request_id": "be1ea9b6-440c-4d7c-a26a-53f460628643",
"data": [
{
"id": 11,
"parent_id": 0,
"deep": 0,
"name": "北京",
"pinyin": "bei jing",
"ext_name": "北京市"
},
{
"id": 12,
"parent_id": 0,
"deep": 0,
"name": "天津",
"pinyin": "tian jin",
"ext_name": "天津市"
},
{
"id": 13,
"parent_id": 0,
"deep": 0,
"name": "河北",
"pinyin": "he bei",
"ext_name": "河北省"
},
{
"id": 14,
"parent_id": 0,
"deep": 0,
"name": "山西",
"pinyin": "shan xi",
"ext_name": "山西省"
},
{
"id": 15,
"parent_id": 0,
"deep": 0,
"name": "内蒙古",
"pinyin": "nei meng gu",
"ext_name": "内蒙古自治区"
},
{
"id": 21,
"parent_id": 0,
"deep": 0,
"name": "辽宁",
"pinyin": "liao ning",
"ext_name": "辽宁省"
},
{
"id": 22,
"parent_id": 0,
"deep": 0,
"name": "吉林",
"pinyin": "ji lin",
"ext_name": "吉林省"
},
{
"id": 23,
"parent_id": 0,
"deep": 0,
"name": "黑龙江",
"pinyin": "hei long jiang",
"ext_name": "黑龙江省"
},
{
"id": 31,
"parent_id": 0,
"deep": 0,
"name": "上海",
"pinyin": "shang hai",
"ext_name": "上海市"
},
{
"id": 32,
"parent_id": 0,
"deep": 0,
"name": "江苏",
"pinyin": "jiang su",
"ext_name": "江苏省"
},
{
"id": 33,
"parent_id": 0,
"deep": 0,
"name": "浙江",
"pinyin": "zhe jiang",
"ext_name": "浙江省"
},
{
"id": 34,
"parent_id": 0,
"deep": 0,
"name": "安徽",
"pinyin": "an hui",
"ext_name": "安徽省"
},
{
"id": 35,
"parent_id": 0,
"deep": 0,
"name": "福建",
"pinyin": "fu jian",
"ext_name": "福建省"
},
{
"id": 36,
"parent_id": 0,
"deep": 0,
"name": "江西",
"pinyin": "jiang xi",
"ext_name": "江西省"
},
{
"id": 37,
"parent_id": 0,
"deep": 0,
"name": "山东",
"pinyin": "shan dong",
"ext_name": "山东省"
},
{
"id": 41,
"parent_id": 0,
"deep": 0,
"name": "河南",
"pinyin": "he nan",
"ext_name": "河南省"
},
{
"id": 42,
"parent_id": 0,
"deep": 0,
"name": "湖北",
"pinyin": "hu bei",
"ext_name": "湖北省"
},
{
"id": 43,
"parent_id": 0,
"deep": 0,
"name": "湖南",
"pinyin": "hu nan",
"ext_name": "湖南省"
},
{
"id": 44,
"parent_id": 0,
"deep": 0,
"name": "广东",
"pinyin": "guang dong",
"ext_name": "广东省"
},
{
"id": 45,
"parent_id": 0,
"deep": 0,
"name": "广西",
"pinyin": "guang xi",
"ext_name": "广西壮族自治区"
},
{
"id": 46,
"parent_id": 0,
"deep": 0,
"name": "海南",
"pinyin": "hai nan",
"ext_name": "海南省"
},
{
"id": 50,
"parent_id": 0,
"deep": 0,
"name": "重庆",
"pinyin": "chong qing",
"ext_name": "重庆市"
},
{
"id": 51,
"parent_id": 0,
"deep": 0,
"name": "四川",
"pinyin": "si chuan",
"ext_name": "四川省"
},
{
"id": 52,
"parent_id": 0,
"deep": 0,
"name": "贵州",
"pinyin": "gui zhou",
"ext_name": "贵州省"
},
{
"id": 53,
"parent_id": 0,
"deep": 0,
"name": "云南",
"pinyin": "yun nan",
"ext_name": "云南省"
},
{
"id": 54,
"parent_id": 0,
"deep": 0,
"name": "西藏",
"pinyin": "xi zang",
"ext_name": "西藏自治区"
},
{
"id": 61,
"parent_id": 0,
"deep": 0,
"name": "陕西",
"pinyin": "shan xi",
"ext_name": "陕西省"
},
{
"id": 62,
"parent_id": 0,
"deep": 0,
"name": "甘肃",
"pinyin": "gan su",
"ext_name": "甘肃省"
},
{
"id": 63,
"parent_id": 0,
"deep": 0,
"name": "青海",
"pinyin": "qing hai",
"ext_name": "青海省"
},
{
"id": 64,
"parent_id": 0,
"deep": 0,
"name": "宁夏",
"pinyin": "ning xia",
"ext_name": "宁夏回族自治区"
},
{
"id": 65,
"parent_id": 0,
"deep": 0,
"name": "新疆",
"pinyin": "xin jiang",
"ext_name": "新疆维吾尔自治区"
},
{
"id": 71,
"parent_id": 0,
"deep": 0,
"name": "台湾",
"pinyin": "tai wan",
"ext_name": "台湾省"
},
{
"id": 81,
"parent_id": 0,
"deep": 0,
"name": "香港",
"pinyin": "xiang gang",
"ext_name": "香港特别行政区"
},
{
"id": 82,
"parent_id": 0,
"deep": 0,
"name": "澳门",
"pinyin": "ao men",
"ext_name": "澳门特别行政区"
}
]
}