# 身份证归属地查询 · 官方指南总目录
> 身份证归属地查询（apiCode=25）是万维易源（ShowAPI）提供的**免费**官方自营接口。传入 18 位身份证号，即可返回对应**籍贯(address)**、**生日(birthday)**、**性别(sex)**；官方说明该能力"可辅助识别随机生成的身份证号或潜在篡改情况"。本系列共 12 篇文章，按"入门 → 场景 → 深挖 → 行业 → 集成 → 排错"分层，帮助你从第一次调用到生产级集成。
## 系列文章
### 入门层 · 降低首次调用成本
1. [身份证归属地查询：5 分钟接入，从注册到拿到第一条籍贯/生日/性别](https://www.showapi.com/guides/idcard-attribution-quickstart-25) — 注册、拿 AppKey、第一次调用、解析返回，附可直接运行的代码。
2. [身份证归属地查询：返回字段全解（retData / address / birthday / sex 与系统级结构）](https://www.showapi.com/guides/idcard-attribution-fields-25) — 系统级与业务级字段一张表讲清，所有文章链回此处。
### 场景实战层 · 解决具体业务问题
3. [身份证归属地查询：用户注册实名核验的集成设计（前端 + 后端）](https://www.showapi.com/guides/idcard-attribution-verify-25) — 注册表单如何采集、后端如何调用、与用户自填信息交叉比对。
4. [身份证归属地查询：批量核验（Excel/CSV 导入）的循环调用设计](https://www.showapi.com/guides/idcard-attribution-batch-25) — 本接口无批量接入点，批量=客户端循环调用，含限速与重试写法。
5. [身份证归属地查询：调用前如何先做身份证号格式与校验位合法性自检](https://www.showapi.com/guides/idcard-attribution-input-check-25) — 客户端 GB 11643 校验位自检，避免把非法号码发到接口浪费调用。
### 技术深挖层 · 建立专业壁垒
6. [身份证归属地查询：用 Redis 缓存降低重复查询与频率限制风险](https://www.showapi.com/guides/idcard-attribution-cache-25) — 同一身份证结果不变，以 id 为 key 缓存，降调用、提性能。
7. [身份证归属地查询背后的 18 位编码规则：为何能反推籍贯/生日/性别](https://www.showapi.com/guides/idcard-attribution-number-std-25) — GB 11643 结构与校验位算法，解释接口能力的来源与边界。
### 行业方案层 · 垂直领域渗透
8. [身份证归属地查询：风控场景如何用"籍贯+生日+性别"识别伪造/篡改身份证](https://www.showapi.com/guides/idcard-attribution-fraud-25) — 对应官方价值点，三方比对发现矛盾即标记。
9. [身份证归属地查询：客服/用户系统如何一键核验、自动识别异常](https://www.showapi.com/guides/idcard-attribution-cs-25) — 后台嵌入查询、异常标红、自动生成回复话术。
### 生态集成层 · 扩大技术影响力
10. [身份证归属地查询：通过 MCP 在 Cherry Studio / ChatBox 等 AI 客户端直接调用](https://www.showapi.com/guides/idcard-attribution-mcp-25) — 零代码在 AI 客户端调用，蹭 MCP/Agent 热度。
11. [身份证归属地查询：导入 OpenAPI 文档到 Apifox / Postman 管理接口](https://www.showapi.com/guides/idcard-attribution-openapi-25) — 下载 YAML 导入工具，自动生成请求模板与 Mock。
### 最佳实践 / 排错层
12. [身份证归属地查询：错误处理与排错（showapi_res_code / ret_code 通用处理）](https://www.showapi.com/guides/idcard-attribution-errors-25) — 文档未列专用错误枚举，给出基于公共返回结构的通用处理。
## 相关资源
| 资源 | 链接 |
|------|------|
| 接口详情页（apiCode=25） | https://www.showapi.com/apiGateway/view/25 |
| 接入点（25-3） | https://www.showapi.com/apiGateway/view/25/3 |
| AppKey 管理 | https://www.showapi.com/console#/myApp |
| OpenAPI YAML | https://www.showapi.com/openapi/market/25.yaml |
| OpenAPI JSON | https://www.showapi.com/openapi/market/25.json |
| 调用帮助 | https://www.showapi.com/helpcenter/view#/3960/1 |
## 阅读建议
- **第一次用**：按 1 → 2 → 3 顺序，先跑通再集成。
- **做风控/反欺诈**：重点看 8，并配合 7 理解"号码本身能反推出什么"。
- **已在用、想优化**：看 6（缓存）、12（排错）。
- **想接入 AI 工具链**：看 10（MCP）、11（OpenAPI）。
