# 绕口令与谜语查询：语文启蒙与口才训练场景接入指南
**接口**：绕口令与谜语查询（apiCode=1623）· 接入点 1623-1 / 1623-2｜**是否免费**：免费（含使用档次限制）｜**请求方式**：POST/GET｜**返回格式**：JSON｜**适用人群**：语文教师、家长、教育类小程序开发者｜**阅读时间**：约 7 分钟
## 核心要点
- 绕口令适合「练发音、练口齿」：按关键词取一类绕口令，做每日打卡。
- 谜语适合「练思维、练联想」：取谜面藏谜底，做成「猜一猜」互动。
- 数据来自免费接口，建议**前端取一次、本地缓存**，避免课堂/活动高峰频繁打接口。
## Why：免费语料，直接进课堂
识字卡片、口才打卡、班级猜谜活动，过去要老师自己收集整理。现在一个免费接口就能按主题取绕口令和谜语，配合简单的页面，几分钟搭出可玩的练习工具。
## What：两个内容库怎么用
| 内容库 | 接入点 | 取数参数 | 返回 | 典型用法 |
|------|------|------|------|------|
| 绕口令 | 1623-1 | `title`（如「扁担」） | `title`+`content` | 跟读、录音打卡、发音对比 |
| 谜语 | 1623-2 | `question`（如「云南」） | `question`+`answer` | 猜谜、抢答、亲子互动 |
## How：一个最小「今日练习」思路
1. **取料**：活动开始前，后端/脚本拉一批绕口令与谜语，落库或写静态 JSON（[分页遍历](https://www.showapi.com/guides/tongue-riddle-pagination-1623) 可用）。
2. **出题**：前端随机抽一条，绕口令显示 `content` 让用户跟读；谜语先显示 `question`，用户作答后揭示 `answer`。
3. **计分/打卡**：本地记录完成天数与正确数，纯前端即可，无需每次调接口。
4. **防刷**：课堂大屏多人用时加[前端限流](https://www.showapi.com/guides/tongue-riddle-frontend-throttle-1623)，避免免费档位被瞬间打满。
**取一条绕口令（Python 示例）**
```python
import requests
APP_KEY = "YOUR_APPKEY"
resp = requests.post(
"https://route.showapi.com/1623-1",
params={"appKey": APP_KEY},
data={"title": "", "page": "1"}, # 空关键词取默认列表
timeout=5,
)
body = resp.json()["showapi_res_body"]
if body["ret_code"] == "0" and body["contentlist"]:
item = body["contentlist"][0]
print("今日绕口令：", item["title"], "\n", item["content"])
```
## 返回示例与解析
```json
{
"showapi_res_body": {
"ret_code": "0",
"contentlist": [
{ "title": "板凳与扁担", "content": "板凳宽，扁担长。扁担没有板凳宽，板凳没有扁担长。" }
]
}
}
```
字段含义见[返回字段全解](https://www.showapi.com/guides/tongue-riddle-response-fields-1623)。
## 进阶 / 边界
- **主题化分组**：用 `title`/`question` 关键词把语料按「爆破音 b/p」「地名谜」「动物谜」分主题，练习更有针对性。
- **缓存优先**：课堂场景网络不稳定，取数后写入本地/静态资源，活动时只读缓存。
- **免费档位**：全班同时刷新会快速消耗额度，务必前端节流 + 服务端缓存，详见[本地缓存策略](https://www.showapi.com/guides/tongue-riddle-cache-tier-1623)。
- 想做成可分享小游戏，见[H5 小游戏全栈思路](https://www.showapi.com/guides/tongue-riddle-h5-game-1623)。
## FAQ
**Q1：没有后端能直接用吗？**
A：可以。浏览器前端用 `fetch` 直接调（注意 AppKey 暴露风险，建议经自有后端中转）。示例见[快速接入](https://www.showapi.com/guides/tongue-riddle-quickstart-1623)。
**Q2：绕口令和谜语能混排练习吗？**
A：可以，两个接入点独立取数后在前端随机混排即可。
**Q3：课堂大屏多人用会超限吗？**
A：免费接口有档次限制，建议「课前取数 + 本地缓存 + 前端限流」，不要每人每次实时打接口。
**Q4：适合几岁的孩子？**
A：绕口令偏发音训练、谜语偏思维训练，具体难度以实际返回内容为准，建议教师先抽样评估再布置。
**Q5：能商用吗？**
A：以[官方档位与授权说明](https://www.showapi.com/free-api)为准，本文不对其授权范围做判断。
## 下一步阅读
- [绕口令与谜语查询：绕口令关键词检索实战](https://www.showapi.com/guides/tongue-riddle-twister-query-1623)
- [绕口令与谜语查询：谜语关键词检索实战](https://www.showapi.com/guides/tongue-riddle-riddle-query-1623)
- [绕口令与谜语查询：做一个 H5 绕口令/谜语小游戏](https://www.showapi.com/guides/tongue-riddle-h5-game-1623)
- **本系列共 12 篇**：查看[绕口令与谜语查询指南总目录](https://www.showapi.com/guides/tongue-riddle-guides-1623)
