中文近义词反义词 API：导入 Postman / Swagger 用 OpenAPI 文档管理
中文近义词API中文反义词API免费接口ShowAPI # 中文近义词反义词 API：导入 Postman / Swagger 用 OpenAPI 文档管理
> 接口：免费近义词 - 中文近义词和反义词（apiCode=1624）· 免费服务 · OpenAPI 3.0 文档 · 适用人群：API 治理 / 后端团队 · 阅读时间：约 5 分钟
## 核心要点
- 接口提供标准 OpenAPI 3.0 文档（YAML / JSON），覆盖全部接入点。
- 可导入 **Postman / Swagger UI / Swagger Editor** 自动生成请求模板与 Mock，便于团队协作与接口治理。
- 文档地址：`https://www.showapi.com/openapi/market/1624.yaml`（YAML）、`https://www.showapi.com/openapi/market/1624.json`（JSON）。
> 注：本文使用 Postman / Swagger 系列工具管理接口；不涉及其他 API 调试工具。
## Why：这跟你有什么关系
团队接入接口时，与其在聊天里传来传去 curl 片段，不如把 OpenAPI 文档导入你们已有的 API 工具，自动生成带鉴权参数的请求模板，新人照着填 `keyWords` 就能发请求，还能用 Mock 做前端联调。
## What：OpenAPI 资源
| 资源 | 地址 |
|------|------|
| OpenAPI YAML | https://www.showapi.com/openapi/market/1624.yaml |
| OpenAPI JSON | https://www.showapi.com/openapi/market/1624.json |
| 覆盖范围 | 本接口全部接入点（1624-1 / 1624-2） |
## How：导入并生成请求模板
### 方式一：Postman
1. 打开 Postman → 顶部 `Import`。
2. 粘贴 YAML 地址 `https://www.showapi.com/openapi/market/1624.yaml`，或下载后选择文件导入。
3. 导入后自动生成请求集合，含近义词/反义词接入点。
4. 在请求 URL 的 `appKey` 参数填入你的 AppKey，Body 的 `keyWords` 填入要查的词，发送即可。
### 方式二：Swagger UI / Swagger Editor
1. 打开 Swagger UI 或 Swagger Editor。
2. 通过 `File → Import URL` 粘贴 YAML 地址 `https://www.showapi.com/openapi/market/1624.yaml`。
3. 文档加载后可展开各接入点，直接在页面 `Try it out` 填参调试，或导出为其他格式。
> 导入后用 `keyWords=残酷`（近义词接入点）或 `keyWords=热情`（反义词接入点）做冒烟测试。返回结构与[返回结构全解](https://www.showapi.com/guides/chinese-synonym-antonym-response-codes-1624)一致。
## 返回示例与解析（真实返回，已精简）
```json
{
"showapi_res_code": 0,
"showapi_fee_num": 1,
"showapi_res_body": {
"ret_code": 0,
"result": [
{"words": "严酷", "wordsDetail": "[ yán kù ] （形）①严厉；严格：～的教训。②残酷；冷酷：～的剥削。"}
]
}
}
```
| 字段 | 说明 |
|------|------|
| `showapi_res_body.result` | 数组，元素 `{words, wordsDetail}` |
| `wordsDetail` | 拼音+词性+释义 |
## 进阶 / 边界
- Mock 联调：Swagger UI 等工具可基于 OpenAPI 生成 Mock，前端无需等后端真实接入即可联调卡片渲染。
- 文档即契约：把 OpenAPI 文档纳入仓库，接口字段变更时同步更新，避免前后端字段理解不一致。
- 两个接入点：OpenAPI 文档同时描述 `1624-1` 与 `1624-2`，导入后集合中会包含两者。
## FAQ
**Q1：OpenAPI 文档覆盖两个接入点吗？**
A：覆盖。文档为接口级，包含近义词（1624-1）与反义词（1624-2）两个接入点。
**Q2：导入后还要自己填鉴权吗？**
A：需要。导入生成的是请求模板，记得在 `appKey` 参数填入你自己的 AppKey。
**Q3：可以用 OpenAPI 生成代码或 SDK 吗？**
A：OpenAPI 3.0 文档可被多种代码生成器消费（如 openapi-generator），具体生成方式取决于你选用的工具链。
**Q4：文档地址会随接口更新吗？**
A：文档标注"数据持续更新中"，建议以官网 OpenAPI 地址为准，必要时重新导入最新版。
## 相关能力 / 下一步阅读
- [中文近义词反义词 API：通过 MCP 在 AI 客户端中直接调用](https://www.showapi.com/guides/chinese-synonym-antonym-mcp-1624)
- [中文近义词反义词 API：返回结构全解（ret_code 与 result 数组）](https://www.showapi.com/guides/chinese-synonym-antonym-response-codes-1624)
- **本系列共 8 篇**：查看[中文近义词反义词 API 使用指南总目录](https://www.showapi.com/guides/chinese-synonym-antonym-guides-1624)
