# 绕口令与谜语查询：官方指南总目录
> 接口编号 `1623`｜服务商：昆明秀派科技有限公司｜分类：生活服务｜免费服务（含使用档次限制）
> 一句话速览：一个轻量、免费的同步查询接口，覆盖「绕口令」与「谜语」两个内容库，支持关键词检索 + 分页，提供 MCP 与 OpenAPI 文档集成。
---
## 接口一句话速览
绕口令与谜语查询（apiCode=1623）是昆明秀派科技在 ShowAPI 上提供的**免费**生活服务类接口。它包含两个接入点：
- **接入点 1 · 绕口令（1623-1）**：按关键词（如「扁担」「八百标兵」）检索常见绕口令，返回标题与内容。
- **接入点 2 · 谜语（1623-2）**：按谜面关键词（如「云南」）检索谜语，返回谜面与谜底。
两个接入点均支持 `POST` / `GET`，返回 `JSON`，业务数据包裹在 `showapi_res_body` 中。接口为**同步查询**，免费但设有使用档次限制（防止滥用）。
---
## 分层文章目录（共 12 篇）
### 入门层
1. [绕口令与谜语查询：5 分钟快速接入（从注册到第一条结果）](https://www.showapi.com/guides/tongue-riddle-quickstart-1623) — 注册、拿 AppKey、跑通第一个调用，附可直接运行代码。
2. [绕口令与谜语查询：返回字段与 ret_code 全解（分页/错误码一文读懂）](https://www.showapi.com/guides/tongue-riddle-response-fields-1623) — 全部返回字段对照表 + 两级状态码 + 分页四字段。
### 场景实战层
3. [绕口令与谜语查询：绕口令关键词检索实战（按"扁担""八百标兵"精准查找）](https://www.showapi.com/guides/tongue-riddle-twister-query-1623) — `title` 关键词检索与分页拉取。
4. [绕口令与谜语查询：谜语关键词检索实战（搜谜面、取谜底）](https://www.showapi.com/guides/tongue-riddle-riddle-query-1623) — `question` 关键词检索，取 `question`/`answer`。
5. [绕口令与谜语查询：分页遍历指南（用 page/allPages 拉取全部数据）](https://www.showapi.com/guides/tongue-riddle-pagination-1623) — 自动翻页 + 失败重试的生产级写法。
6. [绕口令与谜语查询：语文启蒙与口才训练场景接入指南](https://www.showapi.com/guides/tongue-riddle-edu-scenario-1623) — 课堂/亲子小程序如何取料、出题、画 UI。
### 技术深挖层
7. [绕口令与谜语查询：错误处理与 ret_code 排查（0 为成功、其余为失败）](https://www.showapi.com/guides/tongue-riddle-error-handling-1623) — 系统码与业务码区分、非 0 的应对。
8. [绕口令与谜语查询：免费档位下的调用纪律与本地缓存策略](https://www.showapi.com/guides/tongue-riddle-cache-tier-1623) — 用本地缓存守住免费额度、避免被限流。
### 最佳实践层
9. [绕口令与谜语查询：做一个 H5 绕口令/谜语小游戏（全栈思路）](https://www.showapi.com/guides/tongue-riddle-h5-game-1623) — 从取数到可玩 H5 页面的完整链路。
10. [绕口令与谜语查询：前端限流与防滥用实践](https://www.showapi.com/guides/tongue-riddle-frontend-throttle-1623) — 防抖、单用户频率上限、失败兜底文案。
### 生态集成层
11. [绕口令与谜语查询：通过 MCP 在 Cherry Studio/ChatBox 中直接调用](https://www.showapi.com/guides/tongue-riddle-mcp-integration-1623) — 基于官方 MCP 配置在 AI 客户端直接使用。
12. [绕口令与谜语查询：导入 Postman / Swagger UI 管理接口（OpenAPI 文档）](https://www.showapi.com/guides/tongue-riddle-openapi-import-1623) — 下载 YAML 导入 API 工具做治理。
---
## 相关资源
| 资源 | 地址 |
|------|------|
| 接口详情页（绕口令接入点） | https://www.showapi.com/apiGateway/view/1623/1 |
| 接口详情页（谜语接入点） | https://www.showapi.com/apiGateway/view/1623/2 |
| OpenAPI YAML（覆盖全部接入点） | https://www.showapi.com/openapi/market/1623.yaml |
| OpenAPI JSON | https://www.showapi.com/openapi/market/1623.json |
| AppKey 管理控制台 | https://www.showapi.com/console#/myApp |
| 调用帮助（使用向导） | https://www.showapi.com/helpcenter/view#/3960/1 |
| 免费接口与档位说明 | https://www.showapi.com/free-api |
---
## 阅读建议
- **第一次用**：从《5 分钟快速接入》开始，跑通代码再读《返回字段全解》。
- **做业务集成**：看《绕口令关键词检索实战》《谜语关键词检索实战》《分页遍历指南》。
- **上生产前**：必读《错误处理》《免费档位下的调用纪律》《前端限流与防滥用》。
- **想玩点花样**：《H5 小游戏》《MCP 集成》《OpenAPI 导入》任选。
- 所有文章底部均有「下一步阅读」互链，可顺藤摸瓜。
