导入 Postman / Swagger：用 OpenAPI 3.0 文档管理经典语句 API
免费经典语句APIOpenAPIPostmanSwagger # 导入 Postman / Swagger：用 OpenAPI 3.0 文档管理经典语句 API
> 元信息：接口 1646-2 · 免费 · OpenAPI 3.0 · 返回 JSON · 适用人群 API 治理团队/开发者 · 阅读时间 5 分钟
## 核心要点
- 免费经典语句 API 提供标准 **OpenAPI 3.0** 文档（YAML/JSON），覆盖全部接入点，可导入 API 工具做治理。
- 下载 YAML 后导入 **Postman / Swagger UI / Swagger Editor**，自动生成请求模板与 Mock，无需手敲参数。
- 接口文档规范、可机器消费，也方便 AI Agent 直接读取。
## Why：为什么要用 OpenAPI 文档
团队接入多了，接口散落各处容易失真。OpenAPI 文档是接口的"单一事实源"：导入工具即可调试、生成 Mock、做契约测试，新人也能照文档快速上手。
## What：OpenAPI 资源
| 资源 | 链接 |
|------|------|
| OpenAPI YAML（在线/下载） | https://www.showapi.com/openapi/market/1646.yaml |
| OpenAPI JSON | https://www.showapi.com/openapi/market/1646.json |
> 说明：以上为官方提供的标准 OpenAPI 3.0 文档，覆盖本接口全部接入点（1646-2）。
## How：导入 Postman
**步骤 1 — 下载 YAML**
```bash
curl -O "https://www.showapi.com/openapi/market/1646.yaml"
```
**步骤 2 — 导入**
打开 Postman → Import → 选择下载的 `1646.yaml` → 自动生成请求集合（含 `appKey`、可选 `tag` 等参数与示例）。
**步骤 3 — 填 AppKey 调试**
在生成请求的 `appKey` 参数处填入你的 AppKey（[控制台](https://www.showapi.com/console#/myApp) 获取），Send 即可看到返回。
## How：用 Swagger UI / Swagger Editor
- **Swagger UI**：将 YAML 内容粘贴到 Swagger UI 的编辑区，页面即渲染出可交互的接口文档，可直接 Try it out。
- **Swagger Editor**：打开 https://editor.swagger.io/ 或本地 Swagger Editor，粘贴 YAML，获得实时校验与 Mock Server 地址。
```bash
# 也可直接用 curl 拉 JSON 版
curl -O "https://www.showapi.com/openapi/market/1646.json"
```
## 返回示例与解析
导入后调试返回结构与文档一致：
```json
{
"showapi_res_code": 0,
"showapi_res_body": {
"body": "书山有路勤为径，学海无涯苦作舟。",
"author": "韩愈",
"ret_code": 0,
"name": "古今贤文"
}
}
```
字段含义见 [返回字段全解](https://www.showapi.com/guides/classic-quotes-fields-1646)。
## 进阶 / 边界
- **文档即契约**：以官方 OpenAPI 为准，团队内部二次封装不要偏离字段定义。
- **Mock 调试**：Swagger Editor 的 Mock Server 可在无 AppKey 时联调前端字段映射。
- **AI 消费**：OpenAPI 可被 AI Agent 直接读取生成调用代码，降低接入门槛。
## FAQ
**Q：YAML 和 JSON 选哪个？**
内容一致，格式不同；Postman 多接受 YAML/JSON，Swagger 系工具对两者都支持，按团队习惯选。
**Q：导入后参数不全怎么办？**
以官方 OpenAPI 实际内容为准；若发现与文档页差异，以接口实际返回为准并反馈官方。
**Q：能用它生成 Mock 数据吗？**
可以。Swagger Editor / 部分网关支持基于 OpenAPI 起 Mock Server，用于前端联调。
**Q：AppKey 要写进 OpenAPI 吗？**
不要。AppKey 是鉴权凭据，应在工具的环境变量/请求参数中单独填入，不要硬编码进文档文件。
**Q：OpenAPI 覆盖所有接入点吗？**
官方说明该文档覆盖本接口全部接入点（本接口仅 1646-2 一个接入点）。
## 相关能力 / 下一步阅读
- [通过 MCP 在 Cherry Studio / ChatBox 中直接调用免费经典语句 API](https://www.showapi.com/guides/classic-quotes-mcp-integration-1646) — 另一种集成
- [5 分钟接入免费经典语句 API](https://www.showapi.com/guides/classic-quotes-quickstart-1646) — 代码方式
- [免费经典语句 API 返回字段全解](https://www.showapi.com/guides/classic-quotes-fields-1646) — 字段对照
- **本系列共 11 篇**：查看[免费经典语句 API 开发指南总目录](https://www.showapi.com/guides/classic-quotes-guides-1646)
