导入 Postman / Swagger：用 OpenAPI 文档管理你的周公解梦 API

# 导入 Postman / Swagger：用 OpenAPI 文档管理你的周公解梦 API > 接口：免费解梦详细（apiCode 1601）· 接入点：解梦详细（1601-2）· **免费** · 集成方式：OpenAPI 3.0 文档（接口级，覆盖全部接入点）· 适用人群：注重 API 治理的团队 · 阅读约 5 分钟 ## 核心要点 - ShowAPI 提供标准 OpenAPI 3.0 文档（YAML / JSON），覆盖本接口全部接入点，可导入 **Postman / Swagger UI / Swagger Editor**，或供 AI Agent 直接消费。 - YAML 地址：`https://www.showapi.com/openapi/market/1601.yaml`；JSON 地址：`https://www.showapi.com/openapi/market/1601.json`。 - 导入后即可自动生成请求模板与 Mock 数据，便于联调与文档沉淀。 ## Why：这跟我有什么关系 你带一个团队，接口越来越多，靠口头传「参数是什么、返回长啥样」迟早出乱子。把 OpenAPI 文档收进 Postman 集合、或挂到 Swagger UI，调用方自己看文档就能上手，还能自动生成 Mock 做前端联调。 ## What：前置条件与接口速览 | 项目 | 说明 | |------|------| | 集成能力 | OpenAPI 3.0 文档（接口级，覆盖全部接入点） | | YAML 地址 | `https://www.showapi.com/openapi/market/1601.yaml` | | JSON 地址 | `https://www.showapi.com/openapi/market/1601.json` | | 可导入工具 | **Postman / Swagger UI / Swagger Editor**（及兼容 OpenAPI 的 AI Agent） | | 接入点说明 | 内容参考《周公解梦全书》部分信息，提供解读参考（文化参考，非科学/医疗结论） | ## How：三种导入方式 **方式 1 — 导入 Postman** 1. 下载 YAML：`https://www.showapi.com/openapi/market/1601.yaml` 2. 打开 Postman → Import → 选择该文件 → 自动生成请求集合（含 `keyWords`、`page` 等参数与示例）。 3. 在集合中把 `appKey` 设为环境变量，即可一键发送。 **方式 2 — 本地预览 Swagger UI** ```bash # 用 npx 起一个 Swagger UI 并加载该 YAML npx swagger-ui-cli@latest serve https://www.showapi.com/openapi/market/1601.yaml # 或本地起 swagger-ui 后，在界面 URL 框粘贴上述 YAML 地址 ``` 也可在 Swagger Editor（在线或本地）粘贴 YAML，实时查看接口结构与示例。 **方式 3 — 供 AI Agent / 代码生成消费** OpenAPI 文档可被许多代码生成器与 Agent 框架直接读取，自动产出 SDK 或调用逻辑。把 YAML/JSON 地址交给对应工具即可。 ## 返回示例与解析 OpenAPI 文档中的示例与《[返回字段全解](https://www.showapi.com/guides/dream-response-fields-1601)》一致：`showapi_res_body.contentlist` 为对象数组，每项含 `name` 与 `detailList`。以文档为准，不要另造字段。 ## 进阶 / 边界 - **文档即事实底座**：团队内部若发现文档与实际返回有出入（如 `contentlist` 实为数组），以实际返回为准并在内部同步修正（详见《[返回字段全解](https://www.showapi.com/guides/dream-response-fields-1601)》中标注的文档偏差）。 - **内容为文化参考**：接口说明明确是「提供解读参考」，《周公解梦全书》类资料，展示/使用时应标注「仅供娱乐参考」。 - **免费有档位限制**：联调阶段也会消耗免费档位，建议用 Mock 做前端联调、真实接口只做必要验证；详见[免费档位说明](https://www.showapi.com/free-api)。 - **工具表述统一**：本文及系列所有文章一律使用 Postman / Swagger UI / Swagger Editor 表述接口导入与文档管理。 ## FAQ **Q1：OpenAPI 文档覆盖哪些接入点？** 覆盖本接口（1601）全部接入点，当前即「解梦详细（1601-2）」。 **Q2：除了 Postman / Swagger，还能用哪些工具？** 只要兼容 OpenAPI 3.0 的工具（如 Postman / Swagger UI / Swagger Editor，或能消费 OpenAPI 的 AI Agent）都可导入使用。 **Q3：Mock 数据能当真实返回用吗？** Mock 仅用于前端联调与结构验证，真实业务必须调用真实接口，以实际返回为准。 **Q4：文档更新了要重新导入吗？** ShowAPI 的 OpenAPI 地址是动态文件，重新拉取即可获得最新版；团队可定期同步。 **Q5：返回结构以哪个为准？** 以真实接口返回为准；若与文档文字描述冲突，按《[返回字段全解](https://www.showapi.com/guides/dream-response-fields-1601)》中标注的实际结构处理。 ## 相关能力 / 下一步阅读 - [在 AI 客户端里直接调用周公解梦 API：MCP 配置教程](https://www.showapi.com/guides/dream-mcp-integration-1601) - [周公解梦 API 返回字段全解：ret_code、contentlist、分页字段一文读懂](https://www.showapi.com/guides/dream-response-fields-1601) - [周公解梦 API：5 分钟接入，从注册到查出第一个梦境解读](https://www.showapi.com/guides/dream-quickstart-1601) - **本系列共 8 篇**：查看[周公解梦 API 指南总目录](https://www.showapi.com/guides/dream-guides-1601)