# 脑筋急转弯 API 开发指南总目录
> 接口：脑筋急转弯（apiCode 1618，万维易源官方自营） · 免费服务 · POST/GET · 返回 JSON · 本页为系列索引
## 一句话速览
脑筋急转弯接口是一个**免费**的娱乐题库接口，提供两个接入点：**1618-2 查询列表**（按 `page` 分页拉题库，实测全库约 11067 条）与 **1618-3 随机生成**（按 `len` 取 1~20 条随机题）。业务数据统一包在 `showapi_res_body` 内；列表接口数组字段为 `contentlist`、随机接口为 `list`，两者不要混用解析。适合直播互动、社群破冰、小程序答题、亲子每日一题等场景。
## 分层文章目录（共 12 篇）
### 入门层
1. [脑筋急转弯 API：5 分钟从注册到拿到第一道题](https://www.showapi.com/guides/brainteaser-quickstart-1618) —— 注册、拿 AppKey、跑通两个接入点的第一个调用。
2. [脑筋急转弯 API 返回字段全解：contentlist / list / 分页字段一文读懂](https://www.showapi.com/guides/brainteaser-response-fields-1618) —— 系统级字段 + 两套业务字段对照，全系列字段速查页。
### 场景实战层
3. [直播互动如何接入脑筋急转弯 API？从弹题到观众答题的全链路设计](https://www.showapi.com/guides/brainteaser-live-interaction-1618) —— 主播端出题、观众作答、到点揭晓的全链路。
4. [用脑筋急转弯 API 做个随机出题+计分小游戏（H5/小程序）](https://www.showapi.com/guides/brainteaser-random-quiz-game-1618) —— 后端代理 + 前端逐题计分的可玩活动页。
5. [脑筋急转弯列表接口分页怎么用？page 参数与题库遍历指南](https://www.showapi.com/guides/brainteaser-pagination-1618) —— `page` 翻页与全库遍历，含分页字段说明。
### 技术深挖层
6. [脑筋急转弯两个接入点返回结构差异：contentlist 与 list 别搞混](https://www.showapi.com/guides/brainteaser-return-diff-1618) —— 最高频坑：统一适配层写法，避免空数组。
7. [免费脑筋急转弯接口的题库去重与本地缓存策略](https://www.showapi.com/guides/brainteaser-best-practice-dedup-1618) —— 随机去重 + 本地建索引，省调用守档位。
8. [脑筋急转弯免费接口的档位与限流说明：免费不等于无限](https://www.showapi.com/guides/brainteaser-free-tier-1618) —— 免费边界与 `showapi_fee_num` 计量说明。
### 行业方案层
9. [教育/亲子场景方案：用脑筋急转弯 API 做每日益智一题](https://www.showapi.com/guides/brainteaser-edu-parenting-1618) —— 定时取题、亲子互动的每日一题栏。
10. [社群运营赋能：用脑筋急转弯 API 做每日破冰与活跃度提升](https://www.showapi.com/guides/brainteaser-community-ops-1618) —— 社群机器人定时抛题、接龙揭晓。
### 生态集成层
11. [通过 MCP 在 AI 客户端里直接调用脑筋急转弯 API](https://www.showapi.com/guides/brainteaser-mcp-1618) —— 在 Cherry Studio / ChatBox 等客户端让 AI Agent 直接出题。
12. [导入 Postman / Swagger：用 OpenAPI 文档管理脑筋急转弯接口](https://www.showapi.com/guides/brainteaser-openapi-1618) —— 用 OpenAPI 3.0 文档（YAML/JSON）生成请求模板与 Mock。
## 相关资源
- 接口详情页：[脑筋急转弯（apiCode 1618）](https://www.showapi.com/apiGateway/view/1618)
- 接入点 1618-2：[查询脑筋急转弯列表](https://www.showapi.com/apiGateway/view/1618/2)
- 接入点 1618-3：[随机生成脑筋急转弯](https://www.showapi.com/apiGateway/view/1618/3)
- OpenAPI 文档：[YAML](https://www.showapi.com/openapi/market/1618.yaml) · [JSON](https://www.showapi.com/openapi/market/1618.json)
- AppKey 管理：[控制台-我的应用](https://www.showapi.com/console#/myApp)
- 免费 API 与档位说明：[free-api](https://www.showapi.com/free-api)
- 调用帮助：[helpcenter](https://www.showapi.com/helpcenter/view#/3960/1)
## 阅读建议
- 第一次接：按 **1 → 2 → 6** 顺序，先跑通再吃透字段与结构差异。
- 做业务：直播看 **3**、小程序看 **4**、要遍历题库看 **5**。
- 上线前必读：**7（去重缓存）** 与 **8（档位）**，避免重复题与超量。
- AI / 治理方向：看 **11（MCP）** 与 **12（OpenAPI）**。
- **本系列共 12 篇**：以上为[脑筋急转弯 API 指南总目录](https://www.showapi.com/guides/brainteaser-guides-1618)全部文章。
