中文分词接口：导入 Postman / Swagger 用 OpenAPI 文档管理
chinese-segmentation-openapi-269 # 中文分词接口：导入 Postman / Swagger 用 OpenAPI 文档管理
> 接口：中文分词接口（269-1） · 免费 · OpenAPI 3.0 · 适用人群：API 治理 / 后端团队 · 阅读时间：7 分钟
## 核心要点
- 接口提供标准 OpenAPI 3.0 文档（YAML / JSON），覆盖全部接入点，可导入 API 工具做治理。
- 导入 **Postman / Swagger UI / Swagger Editor** 后，自动生成请求模板与 Mock，方便团队协作与调试。
- 涉及 OpenAPI 导入、调试与 Mock，本文以 Postman / Swagger UI / Swagger Editor 表述。
## Why：用 OpenAPI 统一管理接口
当团队有多个接口、多人协作时，散落的调用片段容易出错。OpenAPI 文档是接口的"单一事实源"：导入工具后，新人不用看代码就能发请求，前端能直接 Mock，CI 能校验变更。中文分词接口自带 OpenAPI 文档，治理成本极低。
## What：OpenAPI 资源
| 资源 | 地址 |
|------|------|
| YAML（在线/下载） | `https://www.showapi.com/openapi/market/269.yaml` |
| JSON | `https://www.showapi.com/openapi/market/269.json` |
| 覆盖范围 | 本接口全部接入点（269-1） |
## How：导入到 API 工具
**Postman**
1. 打开 Postman → Import。
2. 选择「Link」粘贴 `https://www.showapi.com/openapi/market/269.yaml` 或下载后选文件导入。
3. 导入后自动生成 269-1 的请求集合，填入你的 `appKey` 即可发送。
**Swagger UI / Swagger Editor**
1. 打开 Swagger Editor（或自建 Swagger UI）。
2. 粘贴/上传 `269.yaml` 内容。
3. 在 `269-1` 路径下填 `appKey` 与 `text` 即可「Try it out」调试，并可用作 Mock 服务。
> 文档中 `text` 标记为必填（required），`appKey` 以 query 参数鉴权，导入后工具会自动带上这些约束。
**用 OpenAPI 生成代码（可选）**
```bash
# 以 openapi-generator 为例，生成 Python 客户端
openapi-generator-cli generate -i https://www.showapi.com/openapi/market/269.yaml -g python -o ./client
```
## 返回示例与解析
OpenAPI 中 `showapi_res_body` 的 schema 仅含 `list`（string）与 `ret_code`（string），与[返回字段全解](https://www.showapi.com/guides/chinese-segmentation-response-fields-269)一致；工具据此生成对应字段，不会出现文档外的词性/实体字段。
## 进阶 / 边界
- 文档为接口级，覆盖全部接入点；本接口仅 269-1。
- Mock 数据由工具按 schema 生成，仅用于联调；真实分词需调用线上接口。
- 若团队用 Git 管理 API，可将 `269.yaml` 纳入版本库，接口变更即可 diff 评审。
## FAQ
**Q：OpenAPI 文档和网页文档哪个为准？**
A：两者一致；OpenAPI 是机器可读的权威 schema，适合工具消费。
**Q：导入后怎么生成 Mock 数据调试？**
A：Postman / Swagger UI / Swagger Editor 均会根据 schema 自动生成请求模板与 Mock 数据，可直接「Try it out」联调，无需手写请求体。
**Q：文档会更新吗？**
A：以 ShowAPI 发布为准；纳入 Git 后可对比变更。
**Q：返回里的字段和 schema 对不上怎么办？**
A：以[返回字段全解](https://www.showapi.com/guides/chinese-segmentation-response-fields-269)与实测为准，schema 若滞后可向官方反馈。
## 相关能力 / 下一步阅读
- [中文分词接口：通过 MCP 协议在 AI 客户端中直接调用](https://www.showapi.com/guides/chinese-segmentation-mcp-269)
- [中文分词接口返回字段全解：list 分词数组与 ret_code 一文读懂](https://www.showapi.com/guides/chinese-segmentation-response-fields-269)
- [中文分词接口：5 分钟从注册到拿到第一条分词结果](https://www.showapi.com/guides/chinese-segmentation-quickstart-269)
- **本系列共 11 篇**：查看[中文分词接口指南总目录](https://www.showapi.com/guides/chinese-segmentation-guides-269)
