绕口令与谜语查询：导入 Postman / Swagger UI 管理接口（OpenAPI 文档）

# 绕口令与谜语查询：导入 Postman / Swagger UI 管理接口（OpenAPI 文档） **接口**：绕口令与谜语查询（apiCode=1623）· 接入点 1623-1 / 1623-2｜**是否免费**：免费（含使用档次限制）｜**集成能力**：OpenAPI 3.0 文档（YAML/JSON）｜**适用人群**：注重 API 治理的团队｜**阅读时间**：约 5 分钟 ## 核心要点 - 官方提供标准 **OpenAPI 3.0** 文档，覆盖全部接入点，可导入 **Postman / Swagger UI** 做请求模板与 Mock。 - 文档地址：`https://www.showapi.com/openapi/market/1623.yaml`（YAML）、`https://www.showapi.com/openapi/market/1623.json`（JSON）。 - 本文统一使用 **Postman / Swagger UI** 表述；按技能红线，**不出现 Apifox**。 ## Why：用 OpenAPI 做接口治理 团队接多个接口时，一份标准 OpenAPI 文档能让新人一键导入、自动生成请求示例、做 Mock 联调，不必手敲参数。绕口令与谜语查询的 OpenAPI 已含两个接入点的路径、参数与返回结构。 ## What：文档资源 | 资源 | 地址 | |------|------| | OpenAPI YAML（在线/下载） | https://www.showapi.com/openapi/market/1623.yaml | | OpenAPI JSON | https://www.showapi.com/openapi/market/1623.json | 文档含：`/1623-1`（绕口令，超时 5s）、`/1623-2`（谜语，超时 15s）两个 POST 路径，参数 `title`/`question`/`page`，返回结构含 `showapi_res_body` 与 `ShowapiResEnvelope` 信封。 ## How：导入 Postman / Swagger UI ### 方式 A · Postman 1. 打开 Postman，选择「Import（导入）」。 2. 粘贴 YAML 地址 `https://www.showapi.com/openapi/market/1623.yaml`，或先下载再选本地文件。 3. 导入后自动生成两个请求（绕口令 / 谜语），在 Query 参数填 `appKey=YOUR_APPKEY` 即可发送。 ### 方式 B · Swagger UI 1. 打开 Swagger UI（自建或在线编辑器均可）。 2. 选择「File → Import URL / Import File」，填入上面的 YAML 地址或上传文件。 3. 在页面中展开 `/1623-1`、`/1623-2`，填 `appKey` 与参数即可「Try it out」联调。 ### 方式 C · Swagger Editor（本地编辑/校验） - 打开 Swagger Editor，粘贴 YAML 内容，可实时校验语法、预览文档并导出客户端 SDK。 > 三种方式任选；本文以 Postman / Swagger UI / Swagger Editor 为准，不引入 Apifox。 ## 返回示例与解析 导入后请求返回结构与[返回字段全解](https://www.showapi.com/guides/tongue-riddle-response-fields-1623) 一致；OpenAPI 已描述 `showapi_res_body` 与信封字段，便于生成类型与 Mock。 ## 进阶 / 边界 - **Mock 联调**：导入后可对未接好的前端生成 Mock 响应，加速并行开发。 - **AppKey 入参**：OpenAPI 以 `appKey`（query）鉴权，导入后在 Query 填你的 AppKey（[控制台](https://www.showapi.com/console#/myApp) 获取）。 - **想直接进 AI 客户端**：见[MCP 集成](https://www.showapi.com/guides/tongue-riddle-mcp-integration-1623)。 - 首次调用看[5 分钟快速接入](https://www.showapi.com/guides/tongue-riddle-quickstart-1623)。 ## FAQ **Q1：OpenAPI 文档覆盖两个接入点吗？** A：是，官方 OpenAPI 覆盖本接口全部接入点（绕口令 1623-1、谜语 1623-2）。 **Q2：能生成多语言 SDK 吗？** A：可借助 OpenAPI 工具链（如 Swagger Editor / 代码生成器）生成客户端骨架；具体以所用工具为准。 **Q3：appKey 怎么填？** A：作为 query 参数 `appKey` 填入你的真实 AppKey；不要硬编码进共享文档。 **Q4：文档是最新的吗？** A：以官方实时文档为准；本文引用的是 `1623.yaml` / `1623.json` 的当前描述。 **Q5：为什么不用 Apifox？** A：本系列内容规范统一使用 Postman / Swagger UI 表述，不引入 Apifox。 ## 下一步阅读 - [绕口令与谜语查询：通过 MCP 在 Cherry Studio/ChatBox 中直接调用](https://www.showapi.com/guides/tongue-riddle-mcp-integration-1623) - [绕口令与谜语查询：5 分钟快速接入](https://www.showapi.com/guides/tongue-riddle-quickstart-1623) - **本系列共 12 篇**：查看[绕口令与谜语查询指南总目录](https://www.showapi.com/guides/tongue-riddle-guides-1623)