# 渣男语录指南总目录
> 免费渣男语录（apiCode=2962）是 ShowAPI 生活服务分类下的官方自营娱乐接口：随机返回一条"渣男"风格用语，含戏谑和土味情话，**仅供娱乐**。本目录汇总全部官方指南，帮你从注册调用到 AI 客户端集成一站打通。
## 接口一句话速览
| 项 | 值 |
|----|----|
| 接口名称 | 免费渣男语录（渣男语录） |
| 接口编号 | 2962（接入点 1） |
| 计费 | 免费（注册后默认可调用，有使用档位限制） |
| 请求方式 | POST / GET |
| 返回格式 | JSON |
| 核心返回 | `showapi_res_body.text`：一条"渣男"用语 |
| 集成能力 | MCP 服务、OpenAPI 3.0 文档、多语言在线示例 |
| 服务商 | 昆明秀派科技有限公司（易源官方自营） |
## 全部文章（按阅读顺序）
1. **[渣男语录：5 分钟接入，从注册到第一条土味情话](https://www.showapi.com/guides/zhanan-quotes-quickstart-2962)**
注册、取 AppKey、第一次调用、解析返回，三段可直接运行的代码。
2. **[渣男语录返回字段全解：ret_code / text / remark 一文读懂](https://www.showapi.com/guides/zhanan-quotes-response-fields-2962)**
系统信封与业务体字段对照，`ret_code` 0/-1 含义，`remark` 何时非空。
3. **[聊天机器人如何接入渣男语录？从调用到展示的全链路设计](https://www.showapi.com/guides/zhanan-quotes-chatbot-integration-2962)**
触发词、调用封装、结果渲染、失败兜底（`ret_code=-1` 重试）。
4. **[通过 MCP 协议在 AI 客户端中直接调用渣男语录](https://www.showapi.com/guides/zhanan-quotes-mcp-integration-2962)**
在 Cherry Studio / ChatBox 等支持 MCP 的客户端里直接调用本接口。
5. **[导入 Postman / Swagger：用 OpenAPI 文档管理渣男语录接口](https://www.showapi.com/guides/zhanan-quotes-openapi-import-2962)**
下载 YAML → 导入 Postman / Swagger UI → 自动生成请求模板与 Mock。
6. **[渣男语录使用档位与频率限制：如何避免触发限流](https://www.showapi.com/guides/zhanan-quotes-rate-limit-2962)**
免费但有档位限制，客户端节流与缓存去重的最佳实践。
7. **[渣男语录内容合规与娱乐边界：仅供娱乐的正确姿势](https://www.showapi.com/guides/zhanan-quotes-content-compliance-2962)**
文档明示"仅供娱乐"，讲清内容定位、使用边界与风险提示。
## 相关资源
| 资源 | 链接 |
|------|------|
| 接口详情页 | https://www.showapi.com/apiGateway/view/2962 |
| 接入点（2962-1） | https://www.showapi.com/apiGateway/view/2962/1 |
| AppKey 管理 | https://www.showapi.com/console#/myApp |
| 免费 API 档位说明 | https://www.showapi.com/free-api |
| OpenAPI YAML | https://www.showapi.com/openapi/market/2962.yaml |
| OpenAPI JSON | https://www.showapi.com/openapi/market/2962.json |
| 多语言在线示例 | https://www.showapi.com/apitest/market/2962/1 |
| 调用帮助 | https://www.showapi.com/helpcenter/view#/3960/1 |
## 阅读建议
- **第一次用**：从《5 分钟接入》开始，跑通第一段代码即可拿到第一条语录。
- **要读懂返回**：看《返回字段全解》，分清系统信封与业务字段。
- **做 AI / 聊天集成**：依次看《MCP 集成》《聊天机器人全链路》《OpenAPI 导入》。
- **上线前必读**：《档位与频率限制》《内容合规与娱乐边界》帮你避坑。
