导入 Postman / Swagger：用 OpenAPI 文档管理脑筋急转弯接口
# 导入 Postman / Swagger：用 OpenAPI 文档管理脑筋急转弯接口
> 接口/接入点：脑筋急转弯（1618，OpenAPI 3.0 覆盖全部接入点） · 免费服务 · 返回 JSON · 适用人群：注重 API 治理的团队 · 阅读时间约 6 分钟
## 核心要点
- 接口提供标准 OpenAPI 3.0 文档（YAML/JSON），覆盖 1618-2 与 1618-3 全部接入点。
- 可导入 Postman / Swagger UI（或 Swagger Editor）自动生成请求模板与 Mock 数据，便于团队管理与调试。
- 文档地址：`https://www.showapi.com/openapi/market/1618.yaml`（亦可下载/查看 JSON）。
## Why：为什么用 OpenAPI 管理
团队接多个接口时，散落的 curl 片段难维护。用 OpenAPI 文档统一描述脑筋急转弯接口，可一键导入 API 工具生成可调试模板、生成 Mock、做版本管理——尤其适合多人协作与接口治理。
## What：资源与前置
| 项目 | 说明 |
|------|------|
| OpenAPI 文档 | YAML：`https://www.showapi.com/openapi/market/1618.yaml`；JSON：`https://www.showapi.com/openapi/market/1618.json` |
| 适配工具 | Postman / Swagger UI / Swagger Editor |
| 前置 | 有效 AppKey（调试时填入 `appKey` 参数） |
## How：下载并导入
1. 下载文档：
```bash
curl -s -o brainteaser-1618.yaml "https://www.showapi.com/openapi/market/1618.yaml"
```
2. 导入 Postman：Postman → Import → 选择 `brainteaser-1618.yaml` → 自动生成 1618-2 / 1618-3 两个请求模板。
3. 或在线查看：打开 Swagger UI / Swagger Editor，粘贴 YAML 内容，即可交互调试并生成 Mock。
4. 调试时把 `appKey` 参数替换为你的真实 AppKey（占位符 `YOUR_APPKEY`）。
Python（用 OpenAPI 描述的地址直接验证）：
```python
import requests
# 地址与参数均来自 OpenAPI 文档
r = requests.get("https://route.showapi.com/1618-2",
params={"appKey": "YOUR_APPKEY", "page": "1"}, timeout=10)
print(r.json()["showapi_res_body"]["contentlist"][0])
```
## 返回示例与解析
导入后请求返回标准结构（列表用 `contentlist`、随机用 `list`，见字段全解）。OpenAPI 文档已描述字段，团队按文档对接即可，无需反复翻网页。
## 进阶 / 边界
- 两个接入点结构不同（contentlist vs list），在 OpenAPI/Postman 里分别查看 1618-2 与 1618-3 的定义，避免套错示例。
- Mock 数据仅供联调，真实题目以接口返回为准。
- 推荐使用 Postman / Swagger UI 管理接口，便于团队标准化。
## FAQ
**Q1：OpenAPI 文档覆盖两个接入点吗？** 覆盖 1618-2 与 1618-3 全部接入点。
**Q2：导入后怎么填 AppKey？** 在请求参数 `appKey` 处填真实 AppKey（替换占位符）。
**Q3：能生成 Mock 吗？** 可以，Swagger UI / Postman 均支持基于文档生成 Mock。
**Q4：为什么用 Postman / Swagger UI 而不是其他工具？** 本文统一使用 Postman / Swagger UI 管理接口，便于团队标准化与协作。
## 相关能力 / 下一步阅读
- [通过 MCP 在 AI 客户端里直接调用脑筋急转弯 API](https://www.showapi.com/guides/brainteaser-mcp-1618)
- [脑筋急转弯 API：5 分钟从注册到拿到第一道题](https://www.showapi.com/guides/brainteaser-quickstart-1618)
- [脑筋急转弯 API 返回字段全解：contentlist / list / 分页字段一文读懂](https://www.showapi.com/guides/brainteaser-response-fields-1618)
- **本系列共 12 篇**：查看[脑筋急转弯 API 指南总目录](https://www.showapi.com/guides/brainteaser-guides-1618)
