# 渣男语录：5 分钟接入，从注册到第一条土味情话
- **接口/接入点**：免费渣男语录（apiCode=2962，接入点 1） · **是否免费**：免费（有档位限制） · **请求方式**：POST/GET · **返回格式**：JSON · **适用人群**：新注册用户、初级开发者、想玩梗的普通用户 · **阅读时间**：约 5 分钟
## 核心要点
- 渣男语录是**单一接入点、免费**的娱乐接口，鉴权只需一个 `appKey`，**没有业务必填参数**。
- 一次请求返回一个 `text` 字段，里面就是一条"渣男"风格用语。
- 下面三段代码**替换 AppKey 即可运行**，无需任何额外依赖配置。
## Why：这跟我有什么关系
- 想给社群机器人、社交 APP、表情包小工具加一点"梗"？这个接口一条请求就能吐出一句土味情话/戏谑用语，零成本。
- 免费、官方自营、稳定，适合做原型验证、彩蛋功能、互动小游戏。
- 文档明确标注"仅供娱乐"，拿来做轻松互动正好，别用在不当时场合即可。
## What：前置条件与接口速览
| 项 | 值 |
|----|----|
| 接口地址 | `https://route.showapi.com/2962-1?appKey={your_appKey}` |
| 接入点 | 1（渣男语录） |
| 请求方式 | POST / GET |
| 鉴权 | `appKey`（query 参数，必填） |
| 业务必填参数 | 无 |
| 计费 | 免费（注册后默认可调用，有使用档位限制） |
| 返回格式 | JSON |
| 集成能力 | MCP 服务、OpenAPI 3.0、多语言在线示例 |
**前置条件**：① 已在 ShowAPI 注册；② 在控制台拿到 AppKey（[AppKey 管理](https://www.showapi.com/console#/myApp)）。
## How：三步跑通
### 步骤 1 · 获取 AppKey
登录后进入 [AppKey 管理](https://www.showapi.com/console#/myApp)，复制你的 AppKey（形如 `xxxxxxxxxxxxxxxx`）。后续代码中的 `YOUR_APPKEY` 全部替换为它。
### 步骤 2 · 发起第一次调用
下面三种写法任选其一，**替换 `YOUR_APPKEY` 后直接运行**。
**Python（requests）**
```python
import requests
url = "https://route.showapi.com/2962-1"
params = {"appKey": "YOUR_APPKEY"} # 仅鉴权用，无业务参数
try:
resp = requests.post(url, params=params, timeout=10)
resp.raise_for_status()
data = resp.json()
body = data.get("showapi_res_body", {})
if body.get("ret_code") == 0:
print("语录：", body.get("text"))
else:
print("接口未就绪（ret_code=-1）：", body.get("remark"))
except requests.RequestException as e:
print("请求失败：", e)
```
**cURL**
```bash
curl -X POST "https://route.showapi.com/2962-1?appKey=YOUR_APPKEY"
```
**Node.js（fetch，Node 18+）**
```javascript
const url = "https://route.showapi.com/2962-1?appKey=YOUR_APPKEY";
try {
const resp = await fetch(url, { method: "POST", timeout: 10000 });
const data = await resp.json();
const body = data.showapi_res_body || {};
if (body.ret_code === 0) {
console.log("语录：", body.text);
} else {
console.log("接口未就绪（ret_code=-1）：", body.remark);
}
} catch (e) {
console.error("请求失败：", e);
}
```
### 步骤 3 · 解析并返回
成功时 `showapi_res_body.ret_code == 0`，取 `text` 字段即可展示；若 `ret_code == -1`（接口准备中），稍后重试。详见 [《渣男语录返回字段全解》](https://www.showapi.com/guides/zhanan-quotes-response-fields-2962)。
## 返回示例与解析
```json
{
"showapi_res_id": "",
"showapi_res_error": "",
"showapi_res_code": 0,
"showapi_res_body": {
"ret_code": 0,
"text": "你不要闹了，她只是我的小学同学。",
"remark": ""
}
}
```
| 字段 | 类型 | 说明 |
|------|------|------|
| `showapi_res_code` | 整数 | 系统信封状态码（统一包裹） |
| `showapi_res_body.ret_code` | 数字 | 业务状态码：`0`=成功，`-1`=接口准备中 |
| `showapi_res_body.text` | 字符串 | 返回的"渣男"用语（你要的就是它） |
| `showapi_res_body.remark` | 字符串 | 错误信息，成功时为空 |
## 进阶 / 边界
- **没有业务参数**：本接口不需要传任何业务参数，只有 `appKey` 鉴权。不要自造 `phone`/`com` 等参数。
- **免费但有档位**：为防止滥用设有使用档次限制，高频调用请参考 [《档位与频率限制》](https://www.showapi.com/guides/zhanan-quotes-rate-limit-2962)。
- **仅供娱乐**：内容含戏谑/土味情话，使用边界见 [《内容合规与娱乐边界》](https://www.showapi.com/guides/zhanan-quotes-content-compliance-2962)。
## FAQ
- **Q：调用需要传哪些参数？** A：只需要 `appKey` 鉴权，没有业务必填参数。
- **Q：返回空或没有 text？** A：先检查 `showapi_res_body.ret_code`；若为 `-1` 是接口准备中，稍后重试；若为 `0` 但仍异常，检查 `remark` 字段。
- **Q：这个接口收费吗？** A：免费，注册后默认可调用，但有使用档位限制（具体档位见官方档位说明）。
- **Q：支持 GET 吗？** A：支持，POST/GET 均可，鉴权都走 `appKey` query 参数。
- **Q：返回内容可以商用吗？** A：文档标注"仅供娱乐，使用风险自担"，请按 [《内容合规与娱乐边界》](https://www.showapi.com/guides/zhanan-quotes-content-compliance-2962) 把握使用场景。
## 相关能力 / 下一步阅读
- [渣男语录返回字段全解：ret_code / text / remark 一文读懂](https://www.showapi.com/guides/zhanan-quotes-response-fields-2962)
- [聊天机器人如何接入渣男语录？从调用到展示的全链路设计](https://www.showapi.com/guides/zhanan-quotes-chatbot-integration-2962)
- [渣男语录使用档位与频率限制：如何避免触发限流](https://www.showapi.com/guides/zhanan-quotes-rate-limit-2962)
- **本系列共 7 篇**：查看[渣男语录指南总目录](https://www.showapi.com/guides/zhanan-quotes-guides-2962)
