免费中文分词（文本处理）：导入 Postman / Swagger UI，用 OpenAPI 文档管理你的接口

# 免费中文分词（文本处理）：导入 Postman / Swagger UI，用 OpenAPI 文档管理你的接口 > 接口：OpenAPI 3.0 文档（覆盖全部 13 接入点）｜是否免费：是（含档位限制）｜适用人群：API 治理 / 团队协作开发者｜阅读时间：约 6 分钟 ## 核心要点 - ShowAPI 为文本处理接口提供了标准 OpenAPI 3.0 文档（YAML / JSON），覆盖全部 13 个接入点。 - 下载后导入 Postman 或 Swagger UI / Swagger Editor，即可自动生成请求模板、参数说明与 Mock，便于团队协作与治理。 - 文档地址：`https://www.showapi.com/openapi/market/2663.yaml`（同路径 `.json` 为 JSON 版）。 ## Why 接了接口，团队里其他人怎么快速上手？手写接口文档又慢又容易过时。OpenAPI 是行业标准的接口描述格式，下游工具能直接消费：自动出请求示例、出 Mock Server、出参数校验。把这份 YAML 导入你常用的 API 工具，整个团队就有了一致的「接口真相源」，不用每人翻文档猜参数。 ## What **OpenAPI 文档速览** | 项 | 值 | |------|------| | 文档格式 | OpenAPI 3.0 | | YAML 地址 | `https://www.showapi.com/openapi/market/2663.yaml` | | JSON 地址 | `https://www.showapi.com/openapi/market/2663.json` | | 覆盖范围 | 全部 13 个接入点（2663-1 ~ 2663-13） | ## How **步骤 1：下载文档** ```bash curl -O https://www.showapi.com/openapi/market/2663.yaml ``` **步骤 2：导入 API 工具** - **Postman**：`Import` → 选择下载的 `2663.yaml`，Postman 会自动生成 13 个请求集合、参数与示例。 - **Swagger UI / Swagger Editor**：打开编辑器，粘贴或加载 `2663.yaml`，即可在线浏览全部接入点的参数定义并直接调试。 **步骤 3：填 AppKey 调试** 导入后，每个请求的 `appKey` query 参数填入你的真实 AppKey（[AppKey 管理](https://www.showapi.com/console#/myApp)），即可在工具内直接发请求、看返回。 ## 返回示例与解析 OpenAPI 文档本身描述的是请求/响应结构（字段名、必填、类型），例如中文分词 2663-1 的 `text` 必填、`type` 枚举等，与 [返回结构全解](https://www.showapi.com/guides/cnseg-response-2663) 互为补充：文档管「结构」，指南管「怎么用」。 ## 进阶 / 边界 - **覆盖全部接入点**：一份 YAML 含 13 个接入点定义，导入后无需逐个手动建请求。 - **与 MCP 互补**：需要让 AI 客户端直接调用，见 [MCP 集成](https://www.showapi.com/guides/cnseg-mcp-2663)。 - **档位限制仍在**：通过工具调试同样计入免费档位，见 [免费档位与调用策略](https://www.showapi.com/guides/cnseg-free-tier-2663)。 ## FAQ **Q1：YAML 和 JSON 用哪个？** 内容一致，按你用的工具偏好选；Postman / Swagger 都支持 YAML 导入。 **Q2：导入后还要自己填参数吗？** `appKey` 等运行期参数需你填入真实值；结构、枚举已由文档生成。 **Q3：能生成 Mock 吗？** Swagger UI / Swagger Editor 等支持基于 OpenAPI 的 Mock，具体以你所用工具为准。 **Q4：文档会随接口更新吗？** 以官方在线 YAML 为准，需要时重新下载最新版即可。 **Q5：免费档限制影响调试吗？** 会，调试调用同样计入档位，接口可能返回空业务数据。 ## 相关能力 / 下一步阅读 - [免费中文分词（文本处理）：通过 MCP 在 Cherry Studio / ChatBox 里直接调用](https://www.showapi.com/guides/cnseg-mcp-2663) - [免费中文分词（文本处理）：返回结构与公共字段全解](https://www.showapi.com/guides/cnseg-response-2663) - [免费中文分词（文本处理）：指南总目录](https://www.showapi.com/guides/cnseg-guides-2663) > 本系列共 14 篇：查看[免费中文分词（文本处理）API 指南总目录](https://www.showapi.com/guides/cnseg-guides-2663)