# 免费名言警句 官方指南总目录
> 接口速览：免费名言警句（apiCode=1839，接入点 1839-1）是易源官方自营的免费接口，调用即可获取名人名言、哲理智慧、励志格言等，适用于网站、应用、教育平台的"每日一句"、随机激励等场景。注册后默认可免费调用（有使用档位限制）。支持 POST/GET，返回 JSON；提供 MCP 服务与 OpenAPI 3.0 文档。
## 接口一句话速览
| 项 | 值 |
|----|----|
| 接口名 | 名言警句（免费名言警句） |
| apiCode | 1839（接入点 1839-1） |
| 请求地址 | `https://route.showapi.com/1839-1?appKey={your_appKey}` |
| 请求方式 | POST / GET |
| 返回格式 | JSON（业务数据位于 `showapi_res_body`） |
| 计费 | 免费（注册后默认可用，有使用档位限制） |
| 核心参数 | `num`（最多 10 条，非必填） |
| 集成能力 | MCP 服务、OpenAPI 3.0 文档 |
| 服务商 | 昆明秀派科技有限公司（易源官方） |
## 全系列文章（共 10 篇）
### 入门层
1. [免费名言警句：5 分钟接入，从注册到第一条名言](https://www.showapi.com/guides/famous-quotes-quickstart-1839) — 注册、拿 AppKey、第一次调用并解析返回。
2. [免费名言警句：返回字段全解（contentlist / ret_code / allNum）](https://www.showapi.com/guides/famous-quotes-response-fields-1839) — 字段对照表与成功/失败判断。
### 场景实战层
3. [免费名言警句：在教育平台 / 网站 / App 中集成"每日一句"](https://www.showapi.com/guides/famous-quotes-app-integration-1839) — 从触发到前端卡片的全链路设计。
4. [免费名言警句：num 参数怎么用？最多 10 条与"随机返回"机制](https://www.showapi.com/guides/famous-quotes-num-param-1839) — `num` 用法与"不支持按分类筛选"的事实澄清。
### 技术深挖层
5. [免费名言警句：多语言调用示例（Python / Java / Go / Node.js）](https://www.showapi.com/guides/famous-quotes-multilang-1839) — 四种语言完整可运行代码。
6. [免费名言警句：如何设计缓存策略，避免重复调用浪费免费档位](https://www.showapi.com/guides/famous-quotes-cache-1839) — Redis 缓存设计与刷新周期。
### 生态集成层
7. [免费名言警句：通过 MCP 在 Cherry Studio / ChatBox 直接调用](https://www.showapi.com/guides/famous-quotes-mcp-1839) — 在 AI 客户端配置并自然语言调用。
8. [免费名言警句：导入 Postman / Swagger UI 用 OpenAPI 文档管理接口](https://www.showapi.com/guides/famous-quotes-openapi-1839) — 下载 YAML 导入 API 工具做治理。
### 最佳实践层
9. [免费名言警句：常见问题与排查（ret_code 非 0 / 返回为空 / 免费档位限制）](https://www.showapi.com/guides/famous-quotes-faq-1839) — 高频误用与报错排查。
10. [免费名言警句：内容使用与合规建议（仅供参考 / 作者署名 / 避免断章取义）](https://www.showapi.com/guides/famous-quotes-content-usage-1839) — 合规与使用注意。
## 相关资源
- 接口详情页：https://www.showapi.com/apiGateway/view/1839
- 接入点说明：https://www.showapi.com/apiGateway/view/1839/1
- OpenAPI 文档（YAML）：https://www.showapi.com/openapi/market/1839.yaml
- OpenAPI 文档（JSON）：https://www.showapi.com/openapi/market/1839.json
- AppKey 管理：https://www.showapi.com/console#/myApp
- 免费 API 与档位说明：https://www.showapi.com/free-api
- 调用帮助：https://www.showapi.com/helpcenter/view#/3960/1
## 阅读建议
- **第一次使用**：先读 ① → ② → ④（快速跑通 + 看懂返回 + 弄清随机返回机制）。
- **要上线到产品**：补读 ③（场景集成）+ ⑥（缓存省钱）。
- **用 AI 客户端 / 做 API 治理**：读 ⑦（MCP）+ ⑧（OpenAPI）。
- **排查问题**：直接看 ⑨（FAQ）。
