全国行政区划查询免费API接口教程

接口简介：

查询全国所有各级行政区，港澳台除外。可用于客户地址填写，资料登记等场景。共5级划分，省级/市级/区县级/乡镇级/村

请求地址：

https://cn.apihz.cn/api/other/xzqh.php

请求方式：

POST或GET。

请求参数：

【名称】【参数】【必填】【说明】

【用户ID】【id】【是】【用户中心的数字ID，例：id=10000000】

【用户KEY】【key】【是】【用户中心通讯秘钥，例：key=15he5h15ty854j5sr152hs2】

【查询级别】【type】【是】【1=省级，2=市级，3=县级，4=镇级，5=村级。例：type=1】

【省级名称】【sheng】【否】【查询省级以下提供省级名称，URL编码，例：sheng=四川省】

【市级名称】【shi】【否】【查询市级以下提供市级名称，URL编码，例：shi=绵阳市】

【县级名称】【xian】【否】【查询区县级以下提供县级名称，URL编码，例：xian=涪城区】

【镇级名称】【zhen】【否】【查询乡镇级以下提供镇级名称，URL编码，例：zhen=永兴镇】

返回参数：

【名称】【参数】【说明】

【状态码】【code】【200成功，400错误】

【消息内容】【msg】【如果状态码返回200则msg返回地名字符串，以 | 分割。num返回结果数量。否则状态码返回400则msg返回错误信息提示。】

GET请求示例：

https://cn.apihz.cn/api/other/xzqh.php?id=88888888&key=88888888&type=5&sheng=四川省&shi=绵阳市&xian=涪城区&zhen=永兴镇

注意：示例里的ID与KEY为公共ID与KEY，共享每分钟调用频次限制，接口本身免费，请使用自己的ID与KEY，独享每分钟调用频次。每日调用无上限。

POST请求示例：

请根据开发语言自行POST。

返回数据示例：

示例：{"code":400,"msg":"通讯秘钥错误。"}

示例：{"code":200,"msg":"金祥路社区居民委员会|华裕路社区居民委员会|龙家碾社区居民委员会|兴业路社区居民委员会|金祥寺社区居民委员会|张家营村民委员会|狮子山村民委员会|玉龙院村民委员会|黎家院村民委员会|方登寺村民委员会|三官庙村民委员会|飞牛坝村民委员会|双土地村民委员会|松山寺村民委员会","num":"14"}

参考资料(版权)：

https://www.apihz.cn/api/xzqh.html