# 行政区划查询开发指南总目录
> 接口：行政区划查询（apiCode 1149）· 免费服务 · 万维易源官方自营 · 请求方式 POST/GET · 返回 JSON
## 一句话速览
行政区划查询提供「**区域查询（1149-1）**」与「**子区域查询（1149-2）**」两个接入点，可按 **省 / 市 / 区县 / 乡镇 / 村委会** 5 级行政层级检索区划信息，并逐级下钻子区域，返回各级编码、区号、邮编、拼音等字段。数据**每月 1-3 号同步民政部**更新。本接口**免费**，支持 **MCP** 与 **OpenAPI** 集成。
## 文章列表（按阅读顺序）
### 入门层
1. [行政区划查询：5 分钟接入，从注册到第一条区划数据](https://www.showapi.com/guides/region-query-quickstart-1149) — 注册到首调，替换 AppKey 即可运行。
2. [行政区划查询返回字段全解：wholeName / 各级编码 / 拼音一文读懂](https://www.showapi.com/guides/region-query-response-fields-1149) — 返回体字段语义与层级关系图。
### 场景实战层
3. [行政区划查询子区域查询实战：用 parentId 逐级下钻省→市→区→街道](https://www.showapi.com/guides/region-query-subregion-1149) — 两级接入点联动下钻。
4. [行政区划查询 level 参数怎么选？省级到村委会 5 级行政层级对照](https://www.showapi.com/guides/region-query-level-guide-1149) — level 1~5 速查表。
5. [行政区划查询实战：省市区三级联动选择器前端实现](https://www.showapi.com/guides/region-query-cascade-1149) — 前端级联下拉实现。
### 技术深挖层
6. [行政区划查询拼音字段能干嘛？pinYin / simplePy / prePinYin 在搜索排序中的应用](https://www.showapi.com/guides/region-query-pinyin-1149) — 拼音检索与排序。
7. [免费接口也要缓存：行政区划查询低频更新下的缓存设计](https://www.showapi.com/guides/region-query-cache-1149) — Redis 缓存 key 与 TTL 策略。
8. [行政区划查询状态码与错误码排查：ret_code / showapi_res_code 一文说清](https://www.showapi.com/guides/region-query-codes-1149) — 系统级与业务级状态码区分。
### 行业方案层
9. [地址录入与校验方案：用行政区划查询规范用户填地址](https://www.showapi.com/guides/region-query-address-1149) — 电商 / 物流收货地址校验。
### 生态集成层
10. [通过 MCP 在 AI 客户端直接调用行政区划查询](https://www.showapi.com/guides/region-query-mcp-1149) — Cherry Studio / ChatBox 配置。
11. [导入 Postman / Swagger：用 OpenAPI 文档管理行政区划查询接口](https://www.showapi.com/guides/region-query-openapi-1149) — OpenAPI YAML 导入 API 工具。
## 相关资源
- 接口详情页：[行政区划查询 apiCode=1149](https://www.showapi.com/apiGateway/view/1149)
- 接入点 1（区域查询）：[1149-1](https://www.showapi.com/apiGateway/view/1149/1)
- 接入点 2（子区域查询）：[1149-2](https://www.showapi.com/apiGateway/view/1149/2)
- OpenAPI 文档：[YAML](https://www.showapi.com/openapi/market/1149.yaml) / [JSON](https://www.showapi.com/openapi/market/1149.json)
- AppKey 管理：[控制台](https://www.showapi.com/console#/myApp)
- 调用帮助：[使用向导](https://www.showapi.com/helpcenter/view#/3960/1)
## 阅读建议
- **第一次使用**：先读第 1 篇「5 分钟接入」，再读第 2 篇「返回字段全解」。
- **做省市区选择器**：重点看第 3、4、5 篇。
- **接 AI 客户端 / API 治理**：直接看第 10 篇（MCP）与第 11 篇（OpenAPI）。
