文本关键词抽取：导入 Postman / Swagger UI 管理 OpenAPI 文档

# 文本关键词抽取：导入 Postman / Swagger UI 管理 OpenAPI 文档 - **接口 / 接入点**：文本关键词抽取（apiCode 941）· 接入点 `941-1` - **是否免费**：是 ｜ **请求方式**：POST / GET ｜ **返回格式**：JSON - **适用人群**：API 治理团队、注重接口规范的开发者 - **阅读时间**：约 7 分钟 ## 核心要点 - 官方提供标准 OpenAPI 3.0 文档（YAML），覆盖全部接入点。 - 可导入 Postman / Swagger UI（或 Swagger Editor）自动生成请求模板与 Mock。 - 适合把接口纳管进团队 API 平台，统一调试与协作。 ## Why：把接口纳管进 API 平台 零散的 curl 命令难维护、难协作。OpenAPI 文档是接口的「标准说明书」，导入 Postman / Swagger UI 后能自动生成可调试的请求模板、参数说明与 Mock 数据，团队一眼看懂、直接试，减少对接成本。 ## What：OpenAPI 文档地址 官方提供的接口级 OpenAPI 3.0 文档（覆盖全部接入点）： - YAML：`https://www.showapi.com/openapi/market/941.yaml` - JSON：同路径 `.json`（页面「查看 JSON」入口） 文档含路由 `https://route.showapi.com/941-1`、`text` / `num` 参数定义与返回结构，可直接消费，也供 AI Agent 读取。 ## How：导入到 Postman / Swagger UI ### 方式 A · 导入 Postman 1. 打开 Postman，选择「Import（导入）」。 2. 粘贴或上传上面的 YAML 地址 / 文件。 3. Postman 自动生成请求集合：`941-1` 的 POST 请求、`text` / `num` 参数与示例。 4. 在 `appKey` 处填你的真实 AppKey（https://www.showapi.com/console#/userCenter），点 Send 即可调试。 ### 方式 B · 用 Swagger UI / Swagger Editor 查看与 Mock 1. 打开 Swagger UI 或 Swagger Editor。 2. 粘贴 YAML 地址或内容，界面即渲染出交互式文档。 3. 在文档里直接填参数、「Try it out」发起调用，或导出 Mock Server 供前端联调。 ```bash # 也可先用 curl 把文档拉到本地再导入 curl -L "https://www.showapi.com/openapi/market/941.yaml" -o text-keyword-941.yaml ``` ## 返回示例与解析 导入后调试的返回与[返回结构全解](https://www.showapi.com/guides/text-keyword-response-codes-941)一致：`showapi_res_body.list` 为关键词数组，`ret_code` 为 `"0"` 成功。 ## 进阶 / 边界 - 文档为接口级，覆盖 `941` 全部接入点（本接口仅 `941-1`）。 - 文档随官方更新，建议从官方地址拉取最新版，不要长期用本地快照。 - 仅做文档导入与调试；批量/限流见对应文章。 ## FAQ **Q1：OpenAPI 文档和直接调接口有什么关系？** A1：文档是接口的标准化描述，导入工具后自动生成可调式的请求模板与 Mock，省去手敲参数。 **Q2：appKey 在哪里填？** A2：在生成的请求里作为 `appKey` 参数（query）填入你的真实 AppKey；切勿把真实 key 写进共享文档。 **Q3：文档会过期吗？** A3：以官方地址的最新版为准；本地副本仅供临时使用，正式协作从官方地址拉取。 **Q4：除了 Postman / Swagger UI 还能接什么？** A4：任何兼容 OpenAPI 3.0 的工具都可消费该 YAML；也支持 MCP 方式在 AI 客户端调用（见[MCP 指南](https://www.showapi.com/guides/text-keyword-mcp-941)）。 **Q5：能直接给 AI Agent 用吗？** A5：可以，OpenAPI 文档可被 AI Agent 直接读取以理解接口并调用。 ## 相关能力 / 下一步阅读 - [文本关键词抽取：通过 MCP 在 Cherry Studio / ChatBox 中直接调用](https://www.showapi.com/guides/text-keyword-mcp-941) —— 另一条 AI 集成路线 - [文本关键词抽取：5 分钟快速接入指南（Python / cURL / JS）](https://www.showapi.com/guides/text-keyword-quickstart-941) —— 跑通最小闭环 - **本系列共 10 篇**：查看[文本关键词抽取指南总目录](https://www.showapi.com/guides/text-keyword-guides-941)