儿童/成语教育场景:用猜一猜谜语 API 做亲子与课堂互动
# 儿童/成语教育场景:用猜一猜谜语 API 做亲子与课堂互动
> 接口/接入点:猜一猜谜语 API(151-2 / 151-4) · 免费 · 适用人群:教师、教育机构、亲子类 App 开发者 · 阅读时间:约 6 分钟
## 核心要点
- 适合教育的类型:`cymy` 成语谜语、`dwmy` 动物谜语、`etmy` 儿童谜语、`zwmy` 植物谜语、`dimmy` 地名谜语等。
- 接口**不返回难度字段**,难度分级需你按 `typeId` 自行归类(如低龄用 `etmy`、成语用 `cymy`)。
- 答案文本带"答:/谜底:"前缀,课堂揭晓前需做展示清洗(见 [答案校验](https://www.showapi.com/guides/riddle-answer-check-151))。
## Why:这跟我有什么关系
语文老师想做"成语猜猜看"课堂互动,家长想给孩子来点益智谜语,都不想自己攒题库。猜一猜谜语 API 免费、按类型取,直接对接课堂大屏或亲子小程序。
## What:接口速览
| 项 | 内容 |
|----|------|
| 推荐接入点 | 151-2 随机(传 `typeId=cymy` 等)/ 151-4 按类型分页 |
| 教育向 typeId | `cymy` 成语、`dwmy` 动物、`etmy` 儿童、`zwmy` 植物、`dimmy` 地名、`ry` 用语 |
| 难度 | 接口无难度字段,按 typeId 归类 |
## How:课堂/亲子出题
### 步骤 1 — 取一道成语谜语
```bash
curl -X POST "https://route.showapi.com/151-2?appKey=YOUR_APPKEY" \
-H "content-type: application/x-www-form-urlencoded" \
-d "typeId=cymy"
```
### 步骤 2 — 前端只展示谜面,揭晓时清洗答案
```python
def reveal(answer_raw):
# 去掉"谜底:"前缀,课堂展示更干净
return answer_raw.replace("谜底:", "").replace("答:", "").strip()
```
### 步骤 3 — 难度分级映射(自建)
```python
LEVEL = {
"etmy": "低龄",
"dwmy": "低龄",
"cymy": "小学以上",
"zwmy": "小学以上",
"dimmy": "小学以上",
}
```
## 返回示例与解析
151-2 返回 `Title`(谜面)/`Answer`(谜底)/`typeName`。完整字段见 [返回字段全解](https://www.showapi.com/guides/riddle-response-fields-151)。
## 进阶/边界
- **无难度字段**:不要向用户承诺"按年龄自动匹配难度",用 `typeId` 做粗分级即可。
- **答案前缀**:教学展示前清洗"答:/谜底:",避免孩子直接看到答案词。
- **题库重复**:151-2 每次 20 条,可缓存建"本周成语题池",减少调用(见 [频控与缓存](https://www.showapi.com/guides/riddle-rate-limit-151))。
- **合规**:面向未成年人场景注意内容适宜性,建议先用 `etmy`/`cymy` 等温和类型。
## FAQ
**Q1:接口能按"小学三年级"难度出题吗?**
不能,接口没有年级/难度字段。按 `typeId` 粗分(`etmy` 儿童、`cymy` 成语等)是可行近似。
**Q2:成语谜语返回的是成语本身还是解释?**
返回的是谜面 + 谜底(成语)。如"刺绣(打一成语)"→"谜底:锦上添花"。
**Q3:答案里的"谜底:"能去掉吗?**
接口原样返回,需你在展示前清洗(见上方 `reveal`)。
**Q4:免费额度够课堂用吗?**
注册后免费调用,设档位限制。课堂集中使用建议缓存题池,避免瞬时高频,额度以官方 /free-api 为准。
**Q5:还有哪些适合科普的类型?**
`dwmy` 动物、`zwmy` 植物、`dimmy` 地名、`ypmy` 药品、`yymy` 音乐,详见 [类型清单](https://www.showapi.com/guides/riddle-typelist-151)。
## 相关能力 / 下一步阅读
- [拿到谜底后怎么校验用户答案?API 不代判,需自建比对逻辑](https://www.showapi.com/guides/riddle-answer-check-151)
- [免费额度怎么用不超:猜一猜谜语 API 的调用频控与缓存建议](https://www.showapi.com/guides/riddle-rate-limit-151)
- [猜一猜谜语 API 类型清单:26 类谜语 typeId 完整对照表](https://www.showapi.com/guides/riddle-typelist-151)
- **本系列共 13 篇**:查看[猜一猜谜语 API 指南总目录](https://www.showapi.com/guides/riddle-guides-151)