童话故事集 API 指南总目录

# 童话故事集 API 指南总目录 > 童话故事集 API（apiCode=1700）是万维易源（ShowAPI）官方自营的免费接口，汇集安徒生童话、格林童话、成语故事、寓言故事、民间故事等经典儿童故事，覆盖「故事分类 → 故事列表 → 故事详情」三个接入点，适合家长向应用、儿童绘本/小程序、故事分享平台与 AI 客户端调用。本目录汇总全部官方指南，按阅读顺序分层排列。 ## 一句话速览 - **产品**：童话故事集 API（免费服务，官方自营，服务商=昆明秀派科技有限公司） - **接入点**：故事分类(1700-1)、故事列表(1700-2)、故事详情(1700-3) - **请求方式**：POST / GET，返回 JSON - **计费**：免费（注册后默认可调用，受官方使用档次限制） - **集成**：支持 MCP 服务、OpenAPI 3.0 文档；无订阅推送/批量接入点 ## 入门层 1. [童话故事集 API：5 分钟接入，从注册到读出第一篇故事](https://www.showapi.com/guides/child-story-quickstart-1700) — 注册、取 AppKey、三接入点串起来跑通的最小可运行示例。 2. [童话故事集 API 返回字段全解：storylist / contentlist / 分页字段一文读懂](https://www.showapi.com/guides/child-story-fields-1700) — 系统级封装说明与三接入点返回字段对照表，重点澄清 storylist 与 contentlist 命名差异。 ## 场景实战层 3. [童话故事集 API：故事分类接入点（1700-1）怎么用？含 10 类对照](https://www.showapi.com/guides/child-story-classify-guide-1700) — 取全部分类并拿到 classifyId，喂给下游列表查询。 4. [童话故事集 API：故事列表搜索与分页实战（1700-2，classifyId + keyword）](https://www.showapi.com/guides/child-story-list-guide-1700) — classifyId + keyword 的正确组合，分页字段用法与 keyword 必填边界。 5. [童话故事集 API：故事详情接入点（1700-3）怎么用？用 id 取全文](https://www.showapi.com/guides/child-story-detail-guide-1700) — 用列表返回的 id 拉取故事正文 content。 6. [儿童故事小程序如何集成童话故事集 API？从分类到详情的全链路设计](https://www.showapi.com/guides/child-story-list-integration-1700) — 数据表设计、三接入点调用时序、三级页面落地。 ## 技术深挖层 7. [免费接口也别乱调用：童话故事集 API 内容缓存与分页拉取策略](https://www.showapi.com/guides/child-story-cache-1700) — 正文低变化率下的缓存与按 allPages 翻页的落地写法。 8. [童话故事集 API 免费档位说明：免费≠无限，如何避免超限？](https://www.showapi.com/guides/child-story-free-tier-1700) — 免费服务的档次限制与规避建议。 ## 行业方案层 9. [按年龄给孩子挑故事：用童话故事集 API 分类做适龄内容推荐](https://www.showapi.com/guides/child-story-age-guide-1700) — 用 10 类故事做栏目化适龄推荐。 10. [故事分享平台如何接入童话故事集 API？内容聚合与展示实践](https://www.showapi.com/guides/child-story-platform-guide-1700) — 多分类聚合、详情排版与内容安全。 ## 生态集成层 11. [通过 MCP 在 AI 客户端里直接调用童话故事集 API（Cherry Studio / ChatBox）](https://www.showapi.com/guides/child-story-mcp-1700) — 用官方 MCP 配置在 AI 对话里直接讲/搜故事。 12. [导入 Postman / Swagger：用 OpenAPI 文档管理童话故事集 API](https://www.showapi.com/guides/child-story-openapi-1700) — 下载 YAML 导入 Postman / Swagger UI 自动生成请求模板。 ## 相关资源 | 资源 | 链接 | |------|------| | 接口详情页（apiCode=1700） | https://www.showapi.com/apiGateway/view/1700 | | 故事分类接入点（1700-1） | https://www.showapi.com/apiGateway/view/1700/1 | | 故事列表接入点（1700-2） | https://www.showapi.com/apiGateway/view/1700/2 | | 故事详情接入点（1700-3） | https://www.showapi.com/apiGateway/view/1700/3 | | OpenAPI YAML | https://www.showapi.com/openapi/market/1700.yaml | | OpenAPI JSON | https://www.showapi.com/openapi/market/1700.json | | AppKey 管理 | https://www.showapi.com/console#/myApp | | 免费 API 档位说明 | https://www.showapi.com/free-api | ## 阅读建议 - 第一次用：先读第 1 篇（5 分钟接入）跑通调用，再看第 2 篇（字段全解）理解返回结构。 - 做产品：第 3~6 篇讲清三个接入点怎么组合，第 6 篇给出全链路设计。 - 上线前：第 7 篇（缓存/分页）和第 8 篇（档位）能帮你避开高频调用的坑。 - 用 AI：第 11、12 篇分别讲 MCP 与 OpenAPI 两种集成方式。