# 歇后语查询 API 官方指南总目录
> 歇后语查询（apiCode=1635）是易源 ShowAPI 的**免费**生活服务接口：输入 `num` 即可随机返回若干条经典歇后语（前为描述/谜面 `question`，后为解释/谜底 `answer`），覆盖节气、季节、动物、人物、谐音等题材，适合教育、娱乐、内容创作等场景。本目录汇总全系列 13 篇官方指南，由浅入深帮你从"第一次调用"到"生产级集成"。
## 接口一句话速览
| 项 | 值 |
|----|----|
| 接口名称 | 歇后语查询（查询歇后语） |
| 接入点 | 1635-1（默认分组，仅 1 个接入点） |
| 接口地址 | `https://route.showapi.com/1635-1?appKey={your_appKey}` |
| 请求方式 | POST / GET |
| 请求参数 | `num`（选填，String，随机返回几条） |
| 返回格式 | JSON（业务数据位于 `showapi_res_body`） |
| 计费 | **免费服务**，注册默认可免费调用，设使用档次限制 |
| 集成能力 | MCP 服务、OpenAPI(YAML/JSON) 文档、多语言示例 |
## 分层文章全列
### 入门层
1. [歇后语查询：5 分钟从注册到第一条结果](https://www.showapi.com/guides/xiehouyu-quickstart-1635) — 注册、拿 AppKey、跑通第一次调用并解析 contentlist。
2. [歇后语查询返回字段全解：contentlist / ret_code / 分页字段一文读懂](https://www.showapi.com/guides/xiehouyu-response-fields-1635) — 系统包裹、业务体、数组项三层结构拆解。
### 场景实战层
3. [歇后语查询实战：用 num 参数做"每日一语"小程序全链路设计](https://www.showapi.com/guides/xiehouyu-daily-1635) — 定时拉取、落库、推送与去重。
4. [儿童教育如何用歇后语查询做"趣味国学课"？从题库到互动答题](https://www.showapi.com/guides/xiehouyu-education-1635) — 面向 6–9 岁儿童的"看前半猜后半"答题卡。
5. [歇后语查询实战：文案 / 海报怎么自动配一句贴切歇后语](https://www.showapi.com/guides/xiehouyu-copywriting-1635) — 营销文案、海报、短视频脚本点睛。
6. [歇后语查询实战：做一个"看前半猜后半"的填空小游戏](https://www.showapi.com/guides/xiehouyu-guess-game-1635) — 前端随机取题、隐藏答案、即时校验计分。
### 技术深挖层
7. [歇后语查询 num 参数详解：随机条数、maxResult 与返回上限](https://www.showapi.com/guides/xiehouyu-num-param-1635) — `num` 的真实作用与底层有限语料库。
8. [免费接口也要稳：歇后语查询本地缓存与去重策略](https://www.showapi.com/guides/xiehouyu-cache-dedup-1635) — 缓存 key 设计与按日去重。
9. [歇后语查询错误处理：ret_code / showapi_res_code 与重试指南](https://www.showapi.com/guides/xiehouyu-error-handling-1635) — 0/非0 判定、超时与指数退避。
### 行业方案层
10. [K12 国学教育产品如何批量集成歇后语查询做文化栏目](https://www.showapi.com/guides/xiehouyu-k12-plan-1635) — 教育类产品多主题内容组织与轻量接入。
### 最佳实践层
11. [歇后语查询没有分类参数？本地标签化与分主题展示的 workaround](https://www.showapi.com/guides/xiehouyu-category-workaround-1635) — 文档无 category 入参时的工程化应对。
### 生态集成层
12. [通过 MCP 在 Cherry Studio / ChatBox 中直接调用歇后语查询](https://www.showapi.com/guides/xiehouyu-mcp-integration-1635) — AI 客户端零代码调用。
13. [导入 Postman / Swagger UI：用 OpenAPI 文档管理歇后语查询接口](https://www.showapi.com/guides/xiehouyu-openapi-import-1635) — 下载 YAML、导入工具、生成请求模板与 Mock。
## 相关资源
| 资源 | 链接 |
|------|------|
| 接口详情页 | https://www.showapi.com/apiGateway/view/1635 |
| 接入点说明 | https://www.showapi.com/apiGateway/view/1635/1 |
| OpenAPI YAML | https://www.showapi.com/openapi/market/1635.yaml |
| OpenAPI JSON | https://www.showapi.com/openapi/market/1635.json |
| AppKey 管理 | https://www.showapi.com/console#/myApp |
| 档位说明 | https://www.showapi.com/free-api |
| 多语言示例 | https://www.showapi.com/apitest/market/1635/1 |
## 阅读建议
- **第一次用**：从《5 分钟从注册到第一条结果》开始，10 分钟内跑通。
- **做产品**：按「每日一语 → 缓存去重 → 错误处理」顺序补齐生产级能力。
- **用 AI 客户端**：直接看 MCP 集成篇，无需写代码。
- **做 API 治理**：OpenAPI 导入篇帮你把接口纳入 Postman / Swagger UI。
