全国五级行政区划查询
  • 141
  • 5974

全国行政区划

全国五级行政区划查询免费接口正常调用
  • 该接口免费会员每天赠送100次调用额度
  • 高级会员1万次/天黄金会员50万次/天
    全国五级行政区划查询,省、市、区(县)乡镇、街道、社区(村)联动查询。请注意,直辖市是省级行政区(如北京市),相对应的市级行政区只分为市辖区和市辖县、相对应的区县级行政区如东城区或密云县。注:港澳台只有一级行政区信息。
    ▼ 接口信息
  • 接口地址:http://api.tianapi.com/txapi/area/index
  • 请求示例:http://api.tianapi.com/txapi/area/index?key=APIKEY
  • 支持协议:HTTP/HTTPS
  • 请求方式:GET/POST
  • 返回格式:UTF8 JSON
▼ 请求参数

post请求时,enctype应为application/x-www-form-urlencoded

请求参数中有url或特殊字符时,应该对值urlencode编码下

名称类型必填位置示例值说明
keystringurlParam用户自己的APIKEYapi密钥
provincestringurlParam420省级行政区ID(含直辖市),获取市级行政区
citystringurlParam421100000000市级行政区ID(市辖区/市辖县),获取区县级行政区
countystringurlParam421123000000区县级行政区ID,获取乡镇(街道)级行政区
townstringurlParam421123100000乡镇(街道)级行政区ID,获取社区(村)级行政区
villagestringurlParam421123100212社区(村)级行政区ID,获取社区(村)全部上级行政区
▼ 返回示例

返回示例作为参考,建议以实际测试结果为准

▼ 返回参数
名称类型示例值说明
idint1数据编号
provinceidstring420省级行政区ID
provincenamestring湖北省行政区名称
cityidstring421100000000市级行政区ID
citynamestring黄冈市市级行政区名称
countyidstring421123000000区县级行政区ID
countynamestring罗田县区县级行政区名称
townidstring421123100000乡镇(街道)行政区ID
townnamestring凤山镇乡镇(街道)级行政区名称
villageidstring421123100212社区(村)级行政区ID
villagenamestring七里牌村社区(村)级行政区名称
▼ 接口价格
用户等级免费接口数每日赠送次数会员价格说明
免费会员15个100次免费每个免费接口每天赠送100次
高级会员15个1万次99元/年每个免费接口每天赠送1W次
黄金会员不限50万次299元/年(限时特价)每个免费接口每天赠送50W次
提示:免费额度外的调用1天行币/次(0.0001元),如项目有更高需求请点此升级会员等级。
▼ 错误状态码

错误消息可能会有所调整,请根据错误代码进行流程判断

错误代码错误消息解释帮助
100内部服务器错误出现此错误码请及时反馈或等待修复
110接口暂时维护中接口暂时关闭维护中,请注意相关公告
120IP请求来源受限设置了IP白名单,来源IP不在白名单内
130分钟请求频率超限API超出了分钟调用最大频率被暂时限制
140API没有调用权限请检查接口是否被自行停用或被官方禁用
150接口可用次数不足接口可用次数不足,请在接口列表查看
160账号未申请该接口请先在对应的接口文档页面申请接口,点此查看帮助
170Referer请求来源受限设置了Referer白名单,来源Referer不在白名单内
230key错误或为空请检查apikey是否填写错误,点此查看帮助
240缺少key参数请检查是否传递了key参数,如变量请检查是否赋值
250数据返回为空数据查询或转换失败,请确保输入值正确或重试
260关键词不得为空请检查word参数是否传递了空值
270缺少有效数据接口需要传递数据,请参考接口文档的说明
280缺少必要的参数缺少必填的参数,请根据接口文档检查
290超过最大输入字节限制超出最大字符,请查看对应的接口文档说明
1开头的是系统级错误,2开头的是用户级错误,其中200代码表示请求成功处理并返回。
▼ 参考代码

其他可直接下载使用的部分开源项目推荐。

此处的参考代码都是get方式请求,post请求请参考此项目

此处代码并非完整项目,仅供参考,实际使用请根据本地开发环境修改。

活动推荐EXERCISE 更多>

开通会员专享福利
留言反馈