导入 Postman / Swagger：用 OpenAPI 文档管理紫微斗数接口

# 导入 Postman / Swagger：用 OpenAPI 文档管理紫微斗数接口 > 接口/接入点：紫微斗数排盘（apiCode=1647，接入点 1） · 免费 · 提供 OpenAPI 3.0 文档 · 适用人群：注重 API 治理的团队 · 阅读时间约 6 分钟 ## 核心要点 - 易源为紫微斗数接口提供标准 **OpenAPI 3.0** 文档，覆盖全部接入点，可下载 YAML / JSON。 - 文档可导入 **Postman / Swagger UI / Swagger Editor**，自动生成请求模板与 Mock，便于调试与团队协作。 - 也可直接供 AI Agent 消费（与 [MCP 集成](https://www.showapi.com/guides/ziwei-doushu-mcp-integration-1647) 互补）。 ## Why：为什么用 OpenAPI 管理接口 团队接入一个 API 时，最怕「文档散、示例老旧、新人无从下手」。OpenAPI 文档把接口地址、参数、返回结构标准化，导入 API 工具后自动生成可执行的请求模板与 Mock 数据，新人复制即可调试，也能纳入 CI 做契约测试。紫微斗数接口的 OpenAPI 文档由易源官方维护，直接拿来用。 ## What：OpenAPI 资源速览 | 资源 | 链接 | |------|------| | OpenAPI YAML（在线/下载） | https://www.showapi.com/openapi/market/1647.yaml | | OpenAPI JSON | https://www.showapi.com/openapi/market/1647.json | | 接口详情页 | https://www.showapi.com/apiGateway/view/1647 | ## How：导入到 API 工具 ### 方式一：Postman 1. 打开 Postman → 选择 **Import**。 2. 粘贴上面的 YAML 或 JSON 链接（或下载后选择文件）。 3. 导入后自动生成「紫微斗数」请求集合，含 `1647-1 排盘` 请求模板。 4. 在请求 URL 的 `appKey` 处填入你的 AppKey，在 Body（x-www-form-urlencoded）填 `time`/`gender` 即可发送。 ### 方式二：Swagger UI / Swagger Editor 1. 打开 Swagger UI 或 Swagger Editor。 2. 通过「File → Import URL」粘贴 `https://www.showapi.com/openapi/market/1647.yaml`。 3. 文档加载后可展开 `1647-1` 接入点，直接在页面里填参数、点 Execute 调试，或导出 Mock。 ## 返回示例与解析 通过工具调试返回的标准 JSON（`showapi_res_body` 包裹 `result`）与 [返回字段全解](https://www.showapi.com/guides/ziwei-doushu-response-fields-1647) 完全一致，工具会自动按 OpenAPI 定义的 schema 展示字段。 ## 进阶 / 边界 - **AppKey 别进仓库**：团队共享 OpenAPI 集合时，AppKey 用环境变量/Postman 变量占位，避免密钥泄露。 - **Mock 仅用于联调**：OpenAPI 生成的 Mock 数据是结构占位，不是真实命盘，联调前端可用，正式数据必须调真实接口。 - **文档覆盖全部接入点**：当前接口只有 1 个接入点（排盘），文档已覆盖；后续若新增接入点，以官方 OpenAPI 为准。 - **AI Agent 消费**：OpenAPI 也可直接喂给支持 OpenAPI 的 AI Agent 做工具调用，与 MCP 方式互补。 ## FAQ **Q1：OpenAPI 和 MCP 选哪个？** A：做 AI 客户端直接对话调接口用 MCP；做团队协作、调试、契约测试用 OpenAPI + Postman/Swagger。两者底层都是同一接口，可并存。 **Q2：导入后参数怎么填？** A：`appKey` 填你的真实 Key（建议用变量）；Body 选 x-www-form-urlencoded，填 `time`（yyyy-MM-dd HH）与 `gender`（m/f）。 **Q3：能生成 Mock 数据吗？** A：能。Swagger UI / Postman 可基于 OpenAPI schema 生成 Mock，仅用于前端联调，不是真实排盘结果。 **Q4：OpenAPI 文档和网页上的接口说明有什么区别？** A：两者描述同一接口，OpenAPI 是结构化的机器可读版本（YAML/JSON），便于工具导入、自动生成请求模板与 Mock；网页说明更适合人工阅读，二者以官方 OpenAPI 为准。 ## 相关能力 / 下一步阅读 - [通过 MCP 协议在 AI 客户端中直接调用紫微斗数排盘](https://www.showapi.com/guides/ziwei-doushu-mcp-integration-1647) - [紫微斗数排盘API：5分钟接入，从注册到第一张命盘](https://www.showapi.com/guides/ziwei-doushu-quickstart-1647) - [紫微斗数排盘API返回字段全解：五行局、十二宫、主星一文读懂](https://www.showapi.com/guides/ziwei-doushu-response-fields-1647) - **本系列共 12 篇**：查看[紫微斗数排盘 API 指南总目录](https://www.showapi.com/guides/ziwei-doushu-guides-1647)