身份证归属地查询：导入 OpenAPI 文档到 Apifox / Postman 管理接口

# 身份证归属地查询：导入 OpenAPI 文档到 Apifox / Postman 管理接口 > 接口：身份证归属地查询（apiCode=25，接入点 25-3） · 免费 · 提供 OpenAPI 3.0 文档 · 适用人群：API 治理团队、注重规范的后端 · 阅读时间：约 5 分钟 ## TL;DR - 官方提供标准 OpenAPI 3.0 文档，可一键导入 Apifox / Postman / Swagger UI。 - 文档地址：YAML `https://www.showapi.com/openapi/market/25.yaml`、JSON `https://www.showapi.com/openapi/market/25.json`。 - 导入后自动生成请求模板与 Mock，便于团队协作与测试。 ## Why 把接口文档导入 API 管理工具，能让团队在一个地方维护请求示例、环境变量、Mock 和测试用例，而不是散落在各自脚本里。本接口官方提供了标准 OpenAPI 3.0 文档，覆盖全部接入点，导入即可用。 ## What | 项 | 值 | |----|------| | 文档格式 | OpenAPI 3.0 | | YAML | `https://www.showapi.com/openapi/market/25.yaml` | | JSON | `https://www.showapi.com/openapi/market/25.json` | | 覆盖 | 本接口全部接入点 | ## How ### 步骤 1：下载 / 复制文档 直接访问上面的 YAML 或 JSON 链接，保存到本地（如 `idcard-attribution-25.yaml`）。 ### 步骤 2：导入工具 - **Apifox**：项目 → 导入 → 选择文件 / 粘贴 URL → 确认，自动生成接口与请求示例。 - **Postman**：Import → 上传文件或粘贴链接 → 生成 Collection。 - **Swagger UI**：`File → Import URL/File` 加载 YAML 即可在线调试。 ### 步骤 3：配置变量与 Mock 把 `appKey` 设为环境变量（别写死在文档里），利用工具自带的 Mock 功能做前端联调，无需每次真打接口。 ## 返回示例 OpenAPI 文档内已含接口的请求/响应结构；业务返回结构同样见 [返回字段全解](https://www.showapi.com/guides/idcard-attribution-fields-25)。 ## 进阶 / 边界 - **文档以官方为准**：OpenAPI 由官方维护，若接口有变更以官方文档/该 YAML 最新版为准。 - **AppKey 入环境变量**：导入后把鉴权参数抽成环境变量，避免密钥散落。 - **免费但需鉴权**：即使导入文档，调用仍要带 AppKey。 ## FAQ **Q：OpenAPI 和 MCP 哪个更好？** 用途不同：OpenAPI 适合团队协作、规范化管理与测试；MCP 适合让 AI 客户端/Agent 直接调用。两者可并存。 **Q：文档会及时更新吗？** 以官方提供的 YAML/JSON 为准；接口有变动时建议重新拉取最新版。 **Q：Postman 能直接读 URL 导入吗？** 可以，Postman 支持 Import 粘贴链接；若你的版本仅支持文件，先下载再导入。 **Q：导入后怎么测？** 配置好 AppKey 环境变量后直接发请求；或用工具 Mock 功能做前端联调，详见 [5 分钟接入](https://www.showapi.com/guides/idcard-attribution-quickstart-25)。 **Q：这个接口免费，为什么还要治理？** 即便免费，统一文档、变量与测试用例仍能降低团队协作成本、减少误用。 ## 相关能力 / 下一步阅读 - [身份证归属地查询：通过 MCP 在 Cherry Studio / ChatBox 等 AI 客户端直接调用](https://www.showapi.com/guides/idcard-attribution-mcp-25) - [身份证归属地查询：5 分钟接入，从注册到拿到第一条籍贯/生日/性别](https://www.showapi.com/guides/idcard-attribution-quickstart-25) - [身份证归属地查询：返回字段全解（retData / address / birthday / sex 与系统级结构）](https://www.showapi.com/guides/idcard-attribution-fields-25) - **本系列共 12 篇**：查看[身份证归属地查询指南总目录](https://www.showapi.com/guides/idcard-attribution-guides-25)