K12 国学教育产品如何批量集成歇后语查询做文化栏目
# K12 国学教育产品如何批量集成歇后语查询做文化栏目
- **接口/接入点**：歇后语查询 · 1635-1
- **是否免费**：是
- **请求方式**：POST / GET
- **返回格式**：JSON
- **适用人群**：教育产品开发者、国学/文旅类内容运营
- **阅读时间**：约 8 分钟
## 核心要点
- 歇后语查询免费、返回 `question`+`answer`，适合 K12 国学/文化类栏目的"每日一题""文化角"。
- 接口**无分类参数**，做"动物周/人物周"等主题需用本地标签化（见分类 workaround 篇）。
- 批量集成建议后端定时拉全量、落库、前端读库，避免前端直连与超频。
## Why：K12 产品为什么用它
国学启蒙讲究"有趣有味"。歇后语比成语更口语、更有画面，适合做课间文化角、晨读一题、亲子互动。接口免费、无需分类参数之外的复杂配置，教育产品轻量接入即可。
## What：集成速览
| 项 | 值 |
|----|----|
| 接口地址 | `https://route.showapi.com/1635-1?appKey={YOUR_APPKEY}` |
| 请求参数 | `num`（选填，随机返回几条） |
| 返回 | `contentlist`：`question`+`answer` |
| 计费 | 免费（设使用档次限制） |
## How：批量集成设计
### 步骤 1 — 定时拉全量建本地题库
```python
import requests, sqlite3
def build_bank():
conn = sqlite3.connect("edu.db")
conn.execute("""CREATE TABLE IF NOT EXISTS xiehouyu(
id INTEGER PRIMARY KEY AUTOINCREMENT,
question TEXT UNIQUE, answer TEXT)""")
# 语料有限，分批 num 拉取累积
for _ in range(5):
r = requests.post("https://route.showapi.com/1635-1",
params={"appKey": "YOUR_APPKEY"},
data={"num": "10"}, timeout=15)
body = r.json()["showapi_res_body"]
if body.get("ret_code") != "0":
break
for it in body["contentlist"]:
conn.execute("INSERT OR IGNORE INTO xiehouyu(question,answer) VALUES(?,?)",
(it["question"], it["answer"]))
conn.commit(); conn.close()
```
### 步骤 2 — 多主题组织（本地标签）
接口无 `category`，主题化靠本地打标签：拉全量后按关键词规则归类（如 `question` 含"猫/狗/牛"→"动物"），再由栏目按主题抽取。
### 步骤 3 — 前端文化角卡片
展示 `question` 让孩子猜，点"揭晓"显示 `answer`，配套"收藏/错题"按钮。
## 返回示例与解析
```json
{ "showapi_res_body": {
"ret_code": "0",
"contentlist": [ { "question": "八十岁的阿婆", "answer": "老掉牙了" } ] } }
```
## 进阶 / 边界
- **适龄审核**：个别歇后语含历史/方言梗，进儿童题库前建议人工筛一遍。
- **无分类**：主题栏目靠本地标签（见分类 workaround 篇）。
- **语料有限**：`allNum` 示例 19，题库会循环；本地累积 + 去重延长周期。
## FAQ
**Q：能直接做"动物类专题"吗？**
A：接口无分类入参，需本地拉全量后按关键词打标签归类（见分类 workaround 篇）。
**Q：全校级访问会超免费档位吗？**
A：建议后端批量落库、前端读库，避免每个学生实时打接口；具体档位以官方说明为准。
**Q：题库多久更新一次？**
A：接口"定期更新"，教育产品可按周/月重新拉全量补充新条目。
**Q：能离线课堂用吗？**
A：首次联网建库后可离线使用，定期联网补新。
**Q：和成语卡片怎么统一？**
A：二者结构一致（谜面+谜底），可共用答题卡与打卡框架。
## 相关能力 / 下一步阅读
- [歇后语查询没有分类参数？本地标签化与分主题展示的 workaround](https://www.showapi.com/guides/xiehouyu-category-workaround-1635)
- [儿童教育如何用歇后语查询做"趣味国学课"？从题库到互动答题](https://www.showapi.com/guides/xiehouyu-education-1635)
- **本系列共 13 篇**：查看[歇后语查询指南总目录](https://www.showapi.com/guides/xiehouyu-guides-1635)
