免费名言警句：导入 Postman / Swagger UI 用 OpenAPI 文档管理接口

# 免费名言警句：导入 Postman / Swagger UI 用 OpenAPI 文档管理接口 > 接口 1839-1 · 免费 · 集成方式 OpenAPI 3.0 · 适用人群：API 治理团队、注重规范化的开发者 · 阅读时间：约 4 分钟 ## 核心要点 - 易源提供标准 OpenAPI 3.0 文档（YAML / JSON），覆盖本接口全部接入点。 - 可导入 **Postman / Swagger UI / Swagger Editor** 做请求模板管理与 Mock，规范团队协作。 - 注意：**禁用 Apifox**（本技能硬性红线）；本文只使用 Postman / Swagger 系工具。 ## Why 当团队要统一接口规范、生成调用示例、做联调 Mock 时，一份标准的 OpenAPI 文档比口头说明靠谱得多。易源已为你生成好 1839 的 OpenAPI 文件，直接导入主流 API 工具即可。本文演示如何用 Postman / Swagger UI 消费它。 ## What **资源地址** | 资源 | 地址 | |------|------| | OpenAPI YAML | `https://www.showapi.com/openapi/market/1839.yaml` | | OpenAPI JSON | `https://www.showapi.com/openapi/market/1839.json` | > 文档内 `parameters: []`、`requestBody` 仅含 `num`，可作为"真实参数只有 `num`"的权威佐证（见[num 参数篇](https://www.showapi.com/guides/famous-quotes-num-param-1839)）。 ## How ### 方式 A：导入 Postman 1. 打开 Postman → Import → 选择 `Link`，粘贴 `https://www.showapi.com/openapi/market/1839.yaml`。 2. 导入后自动生成请求集合，包含 `POST /1839-1`。 3. 在请求 URL 的 `appKey` 查询参数填入你的 AppKey（[控制台获取](https://www.showapi.com/console#/myApp)），Body 选 `x-www-form-urlencoded` 填 `num=3`，Send 即可。 ### 方式 B：用 Swagger UI / Swagger Editor 查看与调试 1. 打开 Swagger Editor（或任意 Swagger UI 实例）→ File → Import URL，粘贴上面的 YAML 地址。 2. 文档会渲染出 `POST /1839-1` 的定义、参数 `num` 与返回 `showapi_res_body` 结构。 3. 在 Swagger UI 的 "Try it out" 中填 `num` 与 `appKey`，直接发起调试。 ### 用文档生成 Mock（Swagger/Postman 均支持） 基于 OpenAPI schema 可一键生成示例响应，供前端在接口未联调时做 UI 占位。 ## 返回示例与解析 OpenAPI 定义的返回结构与本文一致：`showapi_res_body` 含 `ret_code`、`contentlist`（`content` 字符串数组）等。完整字段见[返回字段全解](https://www.showapi.com/guides/famous-quotes-response-fields-1839)。 ## 进阶 / 边界 - **文档即事实来源**：当你怀疑"能不能按标签筛选"时，看 OpenAPI 的 `parameters` 与 `requestBody` 最准——当前只有 `num`。 - **勿用 Apifox**：本文及全系列均不使用 Apifox；如需同类工具，请用 Postman / Swagger UI / Swagger Editor。 - **多接入点**：本接口仅 1839-1 一个接入点，文档已覆盖。 ## FAQ **Q1：OpenAPI 文档是最新的吗？** A：由易源 OpenAPI 生成器产出，是本接口能力的权威描述；以文档中的参数定义为准。 **Q2：能导入 Apifox 吗？** A：按本技能硬性要求，不使用 Apifox；请改用 Postman / Swagger UI / Swagger Editor，导入方式一致（均支持 OpenAPI YAML/JSON）。 **Q3：文档里为什么没有"标签/作者"筛选参数？** A：因为真实接口确实只提供 `num`，文档如实反映；页面描述里的"可按标签、作者、主题筛选"与真实参数不一致，使用时请以文档为准。 **Q4：导入后 appKey 怎么填？** A：在请求 URL 的 `appKey` 查询参数填入你的真实 AppKey 即可（不要提交到公开仓库）。 ## 相关能力 / 下一步阅读 - [免费名言警句：通过 MCP 在 Cherry Studio / ChatBox 直接调用](https://www.showapi.com/guides/famous-quotes-mcp-1839) - [免费名言警句：num 参数怎么用？最多 10 条与"随机返回"机制](https://www.showapi.com/guides/famous-quotes-num-param-1839) - [免费名言警句：多语言调用示例（Python / Java / Go / Node.js）](https://www.showapi.com/guides/famous-quotes-multilang-1839) - **本系列共 10 篇**：查看[免费名言警句指南总目录](https://www.showapi.com/guides/famous-quotes-guides-1839)