导入 Postman / Swagger UI：用 OpenAPI 文档管理猜一猜谜语 API

# 导入 Postman / Swagger UI：用 OpenAPI 文档管理猜一猜谜语 API > 接口/接入点：猜一猜谜语 API · OpenAPI 3.0 文档（覆盖全部接入点） · 免费 · 适用人群：注重 API 治理的团队 · 阅读时间：约 4 分钟 ## 核心要点 - 官方提供标准 OpenAPI 3.0 文档，覆盖 151 全部接入点，可下载 YAML / JSON。 - 导入 **Postman** 或 **Swagger UI** 即可自动生成请求模板与 Mock 数据，便于联调与团队共享。 - 导入工具表述按规范统一使用 **Postman / Swagger UI / Swagger Editor**，避免写入其他 API 工具品牌名。 ## Why：这跟我有什么关系 团队协作时，把接口定义交给 Postman / Swagger UI 统一管理，前端、测试、后端共用一份契约，少踩"字段名记错"的坑。猜一猜谜语 API 已给出 OpenAPI 文档，导入即用。 ## What：接口速览 | 项 | 内容 | |----|------| | OpenAPI YAML | https://www.showapi.com/openapi/market/151.yaml | | OpenAPI JSON | https://www.showapi.com/openapi/market/151.json | | 版本 | OpenAPI 3.0（文档标注 3.0.3） | | 覆盖范围 | 151-2 / 151-3 / 151-4 全部接入点 | ## How：导入与联调 ### 方式一 — Swagger UI / Swagger Editor 1. 打开 Swagger Editor（或自托管 Swagger UI）。 2. 粘贴或导入 YAML：`https://www.showapi.com/openapi/market/151.yaml`。 3. 文档自动展开三个接入点的参数与返回 schema，可直接在页面 "Try it out" 填 `appKey` 联调。 ### 方式二 — Postman 1. 下载 YAML 到本地。 2. Postman → Import → 选择文件，自动生成 151-2/151-3/151-4 三个请求集合。 3. 在请求 URL 的 `appKey` 处填入你的 AppKey（[AppKey 管理](https://www.showapi.com/console#/myApp)），即可发送。 ```bash # 先把文档下到本地 curl -O https://www.showapi.com/openapi/market/151.yaml ``` ## 返回示例与解析 OpenAPI 文档已声明各接入点返回 schema（`showapi_res_body` 结构、分页对象、类型列表等）。注意文档 schema 与页面返回示例存在命名差异（如 151-2 大小写），联调时以实际返回为准，详见 [字段避坑](https://www.showapi.com/guides/riddle-field-case-151)。 ## 进阶/边界 - **文档覆盖全部接入点**：一份 YAML 管理三个接入点，无需分别导入。 - **schema 与示例不一致**：OpenAPI 对 151-2 描述为单条扁平结构，而页面返回示例为 `pagebean.contentlist` 数组，代码解析做防御性兼容。 - **Mock 数据**：Swagger UI / Postman 可基于 schema 生成 Mock，适合前端并行开发；但 Mock 值非真实谜语，联调请以真实调用为准。 - **工具表述红线**：本文及全系列统一用 Postman / Swagger UI / Swagger Editor，不写入其他 API 工具品牌名。 ## FAQ **Q1：OpenAPI 文档和页面文档哪个为准？** 都以官方为准；出现不一致（如 151-2 返回结构）时以实际接口返回为准，并在代码里防御性解析。 **Q2：YAML 和 JSON 选哪个导入？** 功能等价，Postman / Swagger 都支持；按团队工具习惯选。 **Q3：能用 Mock 当真实题库吗？** 不能，Mock 只是 schema 生成的占位数据，真实谜语需调接口获取。 **Q4：三个接入点在一个文档里怎么区分？** 路径分别为 `/151-2`、`/151-3`、`/151-4`，OpenAPI 各自带 summary。 **Q5：不想用 MCP，只想代码调，怎么开始？** 看 [5 分钟接入](https://www.showapi.com/guides/riddle-quickstart-151) 拿可运行代码。 ## 相关能力 / 下一步阅读 - [用 MCP 在 AI 客户端里直接玩猜谜：Cherry Studio / ChatBox 接入 151](https://www.showapi.com/guides/riddle-mcp-151) - [避坑：三大接入点返回字段大小写不一致，解析代码怎么写才稳](https://www.showapi.com/guides/riddle-field-case-151) - [猜一猜谜语 API：5 分钟接入，调通你的第一条随机谜语](https://www.showapi.com/guides/riddle-quickstart-151) - **本系列共 13 篇**：查看[猜一猜谜语 API 指南总目录](https://www.showapi.com/guides/riddle-guides-151)