唐诗宋词元曲查询指南总目录

# 唐诗宋词元曲查询指南总目录 > 接口：唐诗宋词元曲等诗词查询（apiCode=1620）· 免费 · 3 个接入点 · 官方自营（昆明秀派科技有限公司） ## 核心要点 - 一个接口覆盖「查朝代 → 查诗人 → 查诗词」三类查询，诗词返回含**原文 / 译文 / 注释**三件套 - 注册即免费调用（有使用档次限制，防止滥用），同时支持 **MCP 协议**与 **OpenAPI 3.0** 文档 - 本目录汇总 12 篇指南，按「入门 → 场景实战 → 技术深挖 → 行业方案 → 生态集成」五层递进 ## 接口一句话速览 唐诗宋词元曲等诗词查询（apiCode=1620）是 ShowAPI 官方自营的古典文学数据接口，集成唐诗、宋词、元曲等，提供 3 个接入点： - **查询朝代列表**（1620-3）：返回全部朝代及 `dynastyId`，如宋代、唐代、南北朝等 - **人名或朝代查询诗人**（1620-4）：按 `dynastyId` 或诗人名（如「苏轼」）检索诗人，返回生平简介 `biography` 等 - **名称查询诗词列表**（1620-5）：按 `poetId` 或诗词名称（`title`）检索诗词，返回 `contentlist`（原文/译文/注释） 调用方式 POST/GET，返回 JSON，业务数据均在 `showapi_res_body` 内。注册后免费调用（有使用档次限制）。 ## 分层文章目录（共 12 篇） ### 入门层 1. [唐诗宋词元曲查询：5 分钟从注册到查出第一个朝代列表](https://www.showapi.com/guides/poem-quickstart-1620) — 注册、拿 AppKey、第一次调用 1620-3，跑通闭环 2. [唐诗宋词元曲查询返回结构全解：ret_code、dynastyInfo、poemInfo 一文读懂](https://www.showapi.com/guides/poem-response-fields-1620) — 三接入点字段对照表与数组结构说明 ### 场景实战层 3. [唐诗宋词元曲查询：从「朝代」到「诗人」到「诗词」三步全链路串联](https://www.showapi.com/guides/poem-three-step-flow-1620) — 用 1620-3→1620-4→1620-5 串成完整查询链路 4. [唐诗宋词元曲查询：搭一个带原文/译文/注释的古诗文学习卡片](https://www.showapi.com/guides/poem-learning-card-1620) — 用 1620-5 的 contentlist 渲染国学学习组件 5. [唐诗宋词元曲查询：title 名称查询为什么不支持模糊匹配？正确用法与避坑](https://www.showapi.com/guides/poem-title-exact-1620) — 讲清 1620-5 的 title 精确匹配约束 ### 技术深挖层 6. [唐诗宋词元曲查询：page 与 maxResult=20 分页翻页拉取全部诗词](https://www.showapi.com/guides/poem-pagination-1620) — allPages/currentPage/allNum 翻页实战 7. [唐诗宋词元曲查询：免费也有档次限制，如何用本地缓存避免触发限流？](https://www.showapi.com/guides/poem-rate-limit-cache-1620) — 免费接口的缓存与限流应对策略 8. [唐诗宋词元曲查询：原文/译文/注释三件套结构解读与前端排版建议](https://www.showapi.com/guides/poem-contentlist-1620) — contentlist 数组结构与生僻字注音展示 ### 行业方案层 9. [唐诗宋词元曲查询：国学/教育类 App 集成方案，一键查诗人自动生成赏析](https://www.showapi.com/guides/poem-edu-solution-1620) — 教育场景的组合调用与异常兜底 10. [唐诗宋词元曲查询：国风文案/内容创作如何自动引用诗词并配图](https://www.showapi.com/guides/poem-copywriting-1620) — 内容创作场景的自动引用 ### 生态集成层 11. [唐诗宋词元曲查询：通过 MCP 协议在 Cherry Studio / ChatBox 中直接查诗词](https://www.showapi.com/guides/poem-mcp-1620) — 在支持 MCP 的 AI 客户端中直接调用 12. [唐诗宋词元曲查询：导入 Postman / Swagger 用 OpenAPI 文档管理接口](https://www.showapi.com/guides/poem-openapi-import-1620) — 用 OpenAPI 3.0 文档做 API 治理 ## 相关资源 | 资源 | 地址 | |------|------| | 接口详情页 | https://www.showapi.com/apiGateway/view/1620 | | 接入点 1 · 查询朝代列表 | https://www.showapi.com/apiGateway/view/1620/3 | | 接入点 2 · 人名或朝代查询诗人 | https://www.showapi.com/apiGateway/view/1620/4 | | 接入点 3 · 名称查询诗词列表 | https://www.showapi.com/apiGateway/view/1620/5 | | OpenAPI 文档（YAML） | https://www.showapi.com/openapi/market/1620.yaml | | OpenAPI 文档（JSON） | https://www.showapi.com/openapi/market/1620.json | | AppKey 管理 | https://www.showapi.com/console#/myApp | | 积分与档位说明 | https://www.showapi.com/free-api | ## 阅读建议 - **第一次接触**：从《5 分钟从注册到查出第一个朝代列表》开始，再读《返回结构全解》，建立字段认知。 - **要串起完整查询**：直接看《三步全链路串联》，把三个接入点连成一条数据链。 - **做产品 / 写代码**：按需跳到分页、限流缓存、原文译文注释排版；做教育/文案类应用看行业方案层。 - **接 AI / 做治理**：MCP 与 OpenAPI 两篇覆盖了 AI 客户端调用与 API 文档管理两条生态路径。