娱乐/社交 App 集成毒鸡汤：用户互动与留存玩法
# 娱乐/社交 App 集成毒鸡汤：用户互动与留存玩法
> 接口/接入点：毒鸡汤生成（apiCode 2784，接入点 1） · 是否免费：免费（有使用档次限制） · 请求方式：POST/GET · 返回格式：JSON · 适用人群：娱乐/社交产品、增长团队 · 阅读时间：约 6 分钟
## 核心要点
- 利用"随机返回"做轻互动：摇一摇出金句、分享卡片、评论区彩蛋，都是低成本提升停留与分享的玩法。
- 后端只做一件事：触发时调用接口、取 `emposion`、返回前端；交互与排版在前端完成。
- 注意免费档位频控与去重，避免高并发场景触发限流或连发重复。
## Why：娱乐社交为什么适合毒鸡汤
毒鸡汤自带"反套路、能戳人、想转发"的属性，非常契合娱乐社交产品的调性。它不需要用户额外输入，一次点击就能产出可分享的内容，对提升互动率、分享率有帮助。但它是"调味料"，不是主菜。
## What：接口速览
| 项目 | 说明 |
|------|------|
| 接口地址 | `https://route.showapi.com/2784-1` |
| 入参 | 无（随机返回一句） |
| 返回关键字段 | `showapi_res_body.emposion` |
| 超时 | 官方 5 秒 |
| 限制 | 免费档位有频控 |
## How：三种玩法骨架
### 玩法一：摇一摇 / 点击出金句
```python
import requests
def shake_quote(app_key):
body = requests.post(
"https://route.showapi.com/2784-1",
params={"appKey": app_key},
headers={"content-type": "application/x-www-form-urlencoded"},
timeout=5,
).json().get("showapi_res_body", {})
if body.get("ret_code") == 0:
return body.get("emposion", "")
return "鸡汤洒了，摇摇再来～"
```
### 玩法二：分享卡片
后端取句 → 前端把句子渲染进卡片模板（你自己的图像/海报工具生成图，接口只给文字）→ 调起系统分享。
### 玩法三：评论区/动态彩蛋
在评论区置顶或动态页加一个"来句毒鸡汤"入口，命中即调用返回，作为破冰话题。
## 返回示例
```json
{ "showapi_res_body": { "ret_code": 0, "remark": "", "emposion": "你不是不够好，是这个世界太会挑刺。" } }
```
## 进阶/边界
- **频控**：摇一摇/彩蛋易被高频触发，务必加前端节流 + 后端限流，参考《免费档位下如何控制频次与成本？》。
- **去重**：同一用户连点可能撞句，做本地/Redis 去重，参考《随机返回的毒鸡汤如何避免重复？》。
- **不可按主题**：无法"给这个用户推职场向"，主题化需调用方过滤。
- **合规**：对外内容请确认平台合规要求，接口不对生成内容的权属/适宜性做承诺。
## FAQ
**Q1：高并发摇一摇会限流吗？**
免费接口有使用档次限制，具体额度见[官方档位说明](https://www.showapi.com/free-api)。高并发场景务必做限流与本地兜底。
**Q2：能不能给不同用户推不同"类型"的毒鸡汤？**
不能按类型筛选。只能多次取句后用关键词/标签做调用方过滤，或自建话题库命中用户画像。
**Q3：分享卡片的图谁来生成？**
接口只返回文字 `emposion`，图片由你自己的设计/图像工具生成，本接口不提供图。
## 相关能力 / 下一步阅读
- [聊天机器人如何接入毒鸡汤？](https://www.showapi.com/guides/poison-soup-chatbot-2784) —— 另一种触发式交互
- [随机返回的毒鸡汤如何避免重复？](https://www.showapi.com/guides/poison-soup-dedup-2784) —— 高并发去重
- [免费档位下，如何控制毒鸡汤调用频次与成本？](https://www.showapi.com/guides/poison-soup-free-tier-2784) —— 频控与额度
- **本系列共 14 篇**：查看[毒鸡汤生成接口官方指南总目录](https://www.showapi.com/guides/poison-soup-guides-2784)
