成语词典（apiCode=2964）官方指南总目录
# 成语词典（apiCode=2964）官方指南总目录
成语词典（apiCode=2964）是万维易源（ShowAPI）提供的**免费**成语查询接口，支持按关键字搜索成语、查询单条成语的拼音/解释/出处/示例，以及随机获取一条成语。本目录汇总了覆盖「入门上手 → 场景实战 → 技术深挖 → 行业方案 → 生态集成」全链路的 15 篇官方指南，帮助你从第一次调用到生产级集成。
## 一句话速览
- **三大接入点**：搜索成语（2964-1）、成语详情（2964-2）、随机成语（2964-3）。
- **关键架构**：搜索只返回成语名与 id，要拿到解释/出处/示例必须再调「成语详情」——这是绝大多数查词应用的主链路。
- **免费服务**：无需购买资源包，控制台获取 AppKey 即可调用；支持 MCP 与 OpenAPI 3.0 集成。
## 分层文章索引
### 入门层（降低首次调用成本）
1. [成语词典：5 分钟接入，从注册到第一条搜索结果](https://www.showapi.com/guides/idiom-dictionary-quickstart-2964) —— 注册、拿 AppKey、第一次调用搜索接口并打印成语名。
2. [成语词典返回字段全解：showapi_res_body 与 ret_code 一文读懂](https://www.showapi.com/guides/idiom-dictionary-response-codes-2964) —— 统一返回包裹结构与三接入点业务字段对照表。
3. [成语词典三大接入点怎么选：搜索 / 详情 / 随机一篇说清](https://www.showapi.com/guides/idiom-dictionary-access-points-2964) —— 三个接入点的适用边界与选型决策表。
### 场景实战层（解决具体业务问题）
4. [成语词典：从搜索到释义的两步流，搭建查词功能](https://www.showapi.com/guides/idiom-search-detail-flow-2964) —— 搜索只给 id/word，如何用 id 再查详情拿完整释义。
5. [随机成语能怎么玩？每日一成语 / 打卡 / 小游戏集成](https://www.showapi.com/guides/idiom-random-usage-2964) —— 2964-3 无参即用，做每日一句与成语小游戏。
6. [成语搜索关键词怎么写才准？部分匹配 / 分页技巧](https://www.showapi.com/guides/idiom-search-keyword-tips-2964) —— keyword 部分匹配、page 分页与 allPages 用法。
7. [成语详情：用 id 还是 word 查询？参数用法与避坑](https://www.showapi.com/guides/idiom-detail-id-or-word-2964) —— 2964-2 的 id/word 二选一与同名歧义处理。
### 技术深挖层（建立专业壁垒）
8. [免费接口下如何设计分页缓存，减少重复调用？](https://www.showapi.com/guides/idiom-pagination-cache-2964) —— 用 allPages/allNum 驱动本地缓存，降延迟防限流。
9. [成语详情字段详解：拼音 / 解释 / 出处 / 示例如何呈现给用户](https://www.showapi.com/guides/idiom-detail-fields-2964) —— 五字段含义与前端展示模板。
10. [成语词典是免费服务意味着什么？showapi_fee_num 与配额说明](https://www.showapi.com/guides/idiom-free-api-cost-2964) —— 免费的定义、fee_num 字段与限流注意。
### 行业方案层（垂直领域渗透）
11. [儿童成语学习 App 接入指南：查词 + 每日一句 + 测验](https://www.showapi.com/guides/idiom-edu-app-guide-2964) —— 面向 6-9 岁学习场景的功能组合。
12. [语文教育 / 内容创作类 AI 助手如何调用成语词典？](https://www.showapi.com/guides/idiom-chatbot-guide-2964) —— 用真实数据替代模型幻觉，结合 MCP 让 Agent 自助调用。
### 生态集成层（扩大技术影响力）
13. [通过 MCP 在 Cherry Studio / ChatBox 中直接用成语词典](https://www.showapi.com/guides/idiom-mcp-integration-2964) —— 基于官方 MCP JSON 在 AI 客户端直接调用。
14. [导入 Postman / Swagger：用 OpenAPI 文档管理成语词典接口](https://www.showapi.com/guides/idiom-openapi-import-2964) —— 下载 YAML 导入 API 工具，生成请求模板。
## 相关资源
| 资源 | 链接 |
|------|------|
| 接口详情页（apiCode=2964） | https://www.showapi.com/apiGateway/view/2964 |
| 接入点 1 · 搜索成语 | https://www.showapi.com/apiGateway/view/2964/1 |
| 接入点 2 · 成语详情 | https://www.showapi.com/apiGateway/view/2964/2 |
| 接入点 3 · 随机成语 | https://www.showapi.com/apiGateway/view/2964/3 |
| OpenAPI YAML | https://www.showapi.com/openapi/market/2964.yaml |
| OpenAPI JSON | https://www.showapi.com/openapi/market/2964.json |
| AppKey 管理 | https://www.showapi.com/console#/myApp |
## 阅读建议
- **第一次接触**：按顺序读 1 → 2 → 3，先跑通调用、看懂返回、弄清三个接入点。
- **要做查词功能**：重点读 4（两步流）和 6（关键词/分页）、7（详情参数）。
- **要做教育/内容产品**：读 11（儿童 App）和 12（AI 助手）。
- **要接 AI 工具链**：读 13（MCP）和 14（OpenAPI 导入）。
- **关心成本与稳定性**：读 8（缓存）和 10（免费与配额）。
