导入 Postman / Swagger：用 OpenAPI 文档管理中文文本相似度检测接口

# 导入 Postman / Swagger：用 OpenAPI 文档管理中文文本相似度检测接口 > 元信息：接口/接入点 中文文本相似度检测接口（OpenAPI 3.0，覆盖 294/1、294/2）· 免费 · 返回格式 JSON · 适用人群 注重 API 治理的团队 · 阅读时间 约 6 分钟 ## 核心要点 - 本接口提供标准 **OpenAPI 3.0 文档**，覆盖全部接入点，可直接导入 API 工具做请求管理与 Mock。 - 推荐导入 **Postman / Swagger UI / Swagger Editor**；本篇不使用其他同类工具，避免引入文档未约定的方案。 - 文档地址：YAML `https://www.showapi.com/openapi/market/294.yaml`、JSON `https://www.showapi.com/openapi/market/294.json`。 ## Why：把接口文档变成"可点的工具" 团队接手一个新接口，最怕文档和代码对不上。OpenAPI 文档是机器可读的"单一事实源"——导入 API 工具后自动生成请求模板、参数说明和 Mock 数据，新人照着点就能调，也方便做接口契约管理与回归测试。 ## What：OpenAPI 资源速览 | 项 | 地址 | |----|------| | OpenAPI YAML | https://www.showapi.com/openapi/market/294.yaml | | OpenAPI JSON | https://www.showapi.com/openapi/market/294.json | | 覆盖范围 | 接口全部接入点（294/1、294/2） | ## How：导入并管理 ### 方式一：Swagger UI / Swagger Editor 1. 打开 Swagger Editor（在线或自建）。 2. 选择"Import File / URL"，粘贴 `https://www.showapi.com/openapi/market/294.yaml`。 3. 文档加载后，每个接入点生成可交互的请求面板，填入 `appKey`、`t1`、`t2` 即可调试，并自动产出 Mock 数据结构。 ### 方式二：Postman 1. 打开 Postman → Import。 2. 选择"Link"粘贴 YAML/JSON 地址，或直接上传下载的文件。 3. 导入后生成集合，每个接入点带预填的请求结构与参数说明，可一键发请求、建 Mock Server。 ### 验证一次调用（以接入点 1 为例） 导入后如需脚本化验证，仍可用接口直连： ```bash curl -X POST "https://route.showapi.com/294-1?appKey=YOUR_APPKEY" \ -H "content-type: application/x-www-form-urlencoded" \ -d "t1=%E8%BF%99%E6%98%AF%E6%B5%8B%E8%AF%95%E6%96%87%E6%9C%AC&t2=%E8%BF%99%E6%98%AF%E6%96%87%E6%9C%AC" ``` 返回 `showapi_res_body.like` 即相似度。 ## 返回示例与解析 字段结构以 OpenAPI 文档为准；接入点 1 返回 `like`，接入点 2 返回 `likeValue` + `mostLike`，完整定义见[《返回字段全解》](https://www.showapi.com/guides/text-similarity-response-fields-294)。 ## 进阶 / 边界 - **文档是契约**：以官方 OpenAPI 文档为权威来源，团队内部若自建封装，应定期对照文档同步，避免参数漂移。 - **仅中文**：文档与接口均明确不支持英文/数字检测，调试时请用中文样本。 - **AppKey 安全**：导入到共享工作区时注意 AppKey 不要硬编码进提交的文件。 ## FAQ **Q1：OpenAPI 文档覆盖哪些接入点？** 覆盖本接口全部接入点（294/1 文本相似度检测、294/2 批量检测）。 **Q2：导入后能用 Mock 吗？** 可以。Swagger UI / Swagger Editor 与 Postman 都能基于 OpenAPI 文档生成 Mock 数据结构与 Mock Server。 **Q3：文档地址会变吗？** 以 `https://www.showapi.com/openapi/market/294.yaml`（或 `.json`）为准，建议以官方地址为权威来源。 **Q4：能用英文样本调试吗？** 不建议。本接口仅支持中文，英文/数字不参与相似度计算，调试请使用中文文本。 ## 下一步阅读 - [通过 MCP 协议在 AI 客户端中直接调用中文文本相似度检测接口](https://www.showapi.com/guides/text-similarity-mcp-294) - [中文文本相似度检测接口返回字段全解：like / likeValue / mostLike / ret_code 一文读懂](https://www.showapi.com/guides/text-similarity-response-fields-294) - [中文文本相似度检测接口：5 分钟从注册到第一条相似度结果](https://www.showapi.com/guides/text-similarity-quickstart-294) - **本系列共 12 篇**：查看[中文文本相似度检测接口指南总目录](https://www.showapi.com/guides/text-similarity-guides-294)