星座运势 API：用 OpenAPI 3.0 文档导入 Apifox / Postman

# 星座运势 API：用 OpenAPI 3.0 文档导入 Apifox / Postman > 接口 872（两接入点）· 免费 · 适用：注重 API 治理的团队 · 阅读时间：约 6 分钟 ## TL;DR - 星座运势 API 提供标准 **OpenAPI 3.0** 文档，覆盖接口 872 全部接入点。 - 文档地址：`https://www.showapi.com/openapi/market/872.yaml`（YAML）与 `https://www.showapi.com/openapi/market/872.json`（JSON）。 - 可导入 Apifox / Postman / Swagger UI，自动生成请求模板与 Mock 数据，无需手抄参数。 ## Why：为什么用 OpenAPI 做 API 治理 手写请求容易漏参数、错类型。OpenAPI 文档把 872-1/872-2 的请求参数、返回结构、鉴权方式一次性定义清楚，导入工具后即生成可调用的请求模板与示例响应，方便团队协作、接口测试与代码生成（如 openapi-generator）。 ## What：文档资源 | 资源 | 链接 | |------|------| | OpenAPI 3.0（YAML） | https://www.showapi.com/openapi/market/872.yaml | | OpenAPI 3.0（JSON） | https://www.showapi.com/openapi/market/872.json | | 在线查看 | 同上 YAML 链接，浏览器直接打开 | ## How：导入流程 ### Apifox 1. 打开 Apifox → 项目 → 「导入」。 2. 选择「URL 导入」，粘贴 `https://www.showapi.com/openapi/market/872.yaml`。 3. 导入后自动生成 872-1 / 872-2 两个接口的请求模板与 Mock。 4. 在环境变量中设置 `appKey=YOUR_APPKEY`，请求时自动带入鉴权。 ### Postman 1. 打开 Postman → Import → 粘贴 YAML/JSON 链接或上传文件。 2. 导入后生成 Collection，含两个接入点。 3. 在请求 `appKey` 参数或 Auth 中填入你的 AppKey。 ### Swagger UI / 本地预览 - 将 YAML 贴入 Swagger Editor（editor.swagger.io）即可交互调试。 ## 进阶 / 边界 - **覆盖全部接入点**：OpenAPI 文档同时描述 872-1 与 872-2，导入后两个接口都在。 - **与 MCP 二选一或并存**：需要 Agent 调用用[MCP](https://www.showapi.com/guides/horoscope-mcp-872)，需要工程化测试/代码生成用 OpenAPI，二者不冲突。 - **以文档为准**：若页面参数与 OpenAPI 不一致，以接口文档页与 OpenAPI 实际内容为准；本系列已对未明确项标注「需实测」。 ## FAQ **Q：OpenAPI 和 MCP 该用哪个？** A：做 AI/Agent 集成优先 MCP；做接口测试、Mock、代码生成优先 OpenAPI。两者可并存。 **Q：导入后参数不全怎么办？** A：OpenAPI 由平台生成，若个别字段缺失，以[接口文档页](https://www.showapi.com/apiGateway/view/872)与[返回字段全解](https://www.showapi.com/guides/horoscope-response-fields-872)补全。 **Q：能生成多语言 SDK 吗？** A：可借助 openapi-generator 等工具基于该 YAML 生成客户端 SDK，具体支持语言以工具为准。 ## 下一步阅读 - [星座运势 API：通过 MCP 在 Cherry Studio / ChatBox 直接查询](https://www.showapi.com/guides/horoscope-mcp-872) - [星座运势查询：5 分钟接入指南](https://www.showapi.com/guides/horoscope-quickstart-872) - [星座配对：5 分钟接入指南](https://www.showapi.com/guides/constellation-match-quickstart-872) - **本系列共 13 篇**：查看[星座运势 API 开发指南总目录](https://www.showapi.com/guides/horoscope-guides-872)