# 猜一猜谜语 API 指南总目录
> 官方自营 · 免费 · 生活服务类谜语接口（apiCode=151）。本文档系列覆盖随机查询、类型查询、按类型分页查询三大接入点，以及 MCP / OpenAPI 集成、字段避坑、免费频控、答案校验、营销与教育场景实战。
## 接口一句话速览
**猜一猜（免费随机查询谜语）** 是昆明秀派科技有限公司（易源官方自营）提供的免费谜语服务，集成搞笑、字谜、成语、动物、脑筋急转弯、智力问答等 26 类主题谜题，适用于社交娱乐、教育科普、营销裂变等场景。注册后默认可免费调用（防滥用设档位限制，以官方 `/free-api` 为准）。
- 接口详情页：https://www.showapi.com/apiGateway/view/151
- 接入点：① 随机查询谜语（151-2）② 谜语类型查询（151-3）③ 根据类型和关键词查询谜语（151-4）
- 请求方式：POST / GET（表单 `application/x-www-form-urlencoded`）；返回 JSON
- 集成能力：MCP 服务（覆盖全部接入点）、OpenAPI 3.0 文档（YAML / JSON）
## 全系列文章（共 13 篇）
### 入门层
1. [猜一猜谜语 API：5 分钟接入，调通你的第一条随机谜语](https://www.showapi.com/guides/riddle-quickstart-151) — 注册到第一条调用，附 Python/cURL/Node 可运行代码。
2. [猜一猜谜语 API 返回字段全解：三大接入点的 Title/Answer 与分页差异](https://www.showapi.com/guides/riddle-response-fields-151) — 跨接入点字段大小写不一致的强避坑对照表。
3. [猜一猜谜语 API 类型清单：26 类谜语 typeId 完整对照表](https://www.showapi.com/guides/riddle-typelist-151) — 从 151-3 全量枚举，可搜附录。
### 场景实战层
4. [小程序/App 怎么接猜一猜谜语 API？社交娱乐趣味模块全链路设计](https://www.showapi.com/guides/riddle-wechat-mini-151) — 出题→作答→校验的完整链路。
5. [儿童/成语教育场景：用猜一猜谜语 API 做亲子与课堂互动](https://www.showapi.com/guides/riddle-kids-education-151) — 成语/动物/儿童谜语调用与难度分级建议。
6. [营销裂变：用猜一猜谜语 API 做答题抽奖与互动游戏](https://www.showapi.com/guides/riddle-marketing-activity-151) — 活动页设计、随机抽题、防刷。
7. [按类型与分页查询谜语：151-4 接入点实战（"关键词"真相）](https://www.showapi.com/guides/riddle-search-by-type-151) — 实测澄清 151-4 仅 typeId+page，无关键词参数。
### 技术深挖层
8. [用 MCP 在 AI 客户端里直接玩猜谜：Cherry Studio / ChatBox 接入 151](https://www.showapi.com/guides/riddle-mcp-151) — 粘贴官方 MCP JSON 即可在 AI 客户端调用。
9. [导入 Postman / Swagger UI：用 OpenAPI 文档管理猜一猜谜语 API](https://www.showapi.com/guides/riddle-openapi-151) — 下载 YAML 导入，生成请求模板与 Mock。
10. [避坑：三大接入点返回字段大小写不一致，解析代码怎么写才稳](https://www.showapi.com/guides/riddle-field-case-151) — 统一解析建议，先判字段存在性再取值。
### 最佳实践层
11. [免费额度怎么用不超：猜一猜谜语 API 的调用频控与缓存建议](https://www.showapi.com/guides/riddle-rate-limit-151) — 免费档位下的缓存与频控策略。
12. [拿到谜底后怎么校验用户答案？API 不代判，需自建比对逻辑](https://www.showapi.com/guides/riddle-answer-check-151) — 去"答：/谜底："前缀 + 归一化比对。
### 行业方案层
13. [答题类社群机器人：接入猜一猜谜语 API 做"每日一题"](https://www.showapi.com/guides/riddle-cs-empower-151) — 群机器人定时推题与互动统计。
## 相关资源表
| 资源 | 链接 |
|------|------|
| 接口详情页（3 个接入点） | https://www.showapi.com/apiGateway/view/151 |
| 随机查询谜语（151-2） | https://www.showapi.com/apiGateway/view/151/2 |
| 谜语类型查询（151-3） | https://www.showapi.com/apiGateway/view/151/3 |
| 根据类型和关键词查询（151-4） | https://www.showapi.com/apiGateway/view/151/4 |
| OpenAPI YAML（覆盖全部接入点） | https://www.showapi.com/openapi/market/151.yaml |
| OpenAPI JSON | https://www.showapi.com/openapi/market/151.json |
| AppKey 管理 | https://www.showapi.com/console#/myApp |
| 免费接口档位说明 | https://www.showapi.com/free-api |
| 调用帮助 | https://www.showapi.com/helpcenter/view#/3960/1 |
## 阅读建议
- **第一次接入**：按 1 → 2 → 3 顺序，先跑通再理解字段与类型。
- **做业务**：直接跳到对应场景（4 社交娱乐 / 5 教育 / 6 营销 / 13 社群）。
- **接 AI 工具**：看 8（MCP）与 9（OpenAPI）。
- **已上线想避坑**：重点读 2、10、11、12。
> 注：本系列所有文章互链均为真实绝对链接；文中"关键词查询""12 类"等表述误差已在对应文章如实标注（见第 7 节校验清单）。
