# 古籍查询 API 指南总目录
> 接口：古籍查询（apiCode 1643）· 万维易源 / 昆明秀派科技官方自营 · **免费服务**（注册后默认可免费调用，设使用档次限制）
> 一句话：通过名称查古籍、拿到可查询古籍列表，再用 ID 拿到古籍的原文、译文、注释等明细。
本系列基于官方文档 + 真实接口实测整理。所有代码示例均可替换 `YOUR_APPKEY` 直接运行；涉及字段以实测返回为准（特别注意译文字段的键名是 `trainslation`，不是 `translation`，详见字段全解篇）。
## 系列文章（共 10 篇）
### 入门层
1. [古籍查询 API：5 分钟快速开始（获取古籍目录与明细）](https://www.showapi.com/guides/ancient-books-quickstart-1643) — 从注册到第一次调用，跑通"查目录 → 查明细"的完整链路。
2. [古籍查询 API：两个接入点怎么选？（名称目录 vs 明细）](https://www.showapi.com/guides/ancient-books-points-1643) — 讲清 1643-2（返回 218 部目录）与 1643-3（按 ID 取明细）的分工与调用顺序。
3. [古籍查询 API：可查询的 218 部古籍总目录（含 titleId）](https://www.showapi.com/guides/ancient-books-catalog-1643) — 实测得到的完整书单，每部附 titleId，可直接复制使用。
### 场景实战 / 技术深挖
4. [古籍查询 API：按 titleId 获取古籍明细（原文 / 译文 / 注释）](https://www.showapi.com/guides/ancient-books-detail-1643) — 以《论语》为例，取某篇章的原文、译文、注释。
5. [古籍查询 API 返回字段全解：trainslation 拼写坑与每个字段含义](https://www.showapi.com/guides/ancient-books-fields-1643) — 逐字段拆解，重点提示 `trainslation` 拼写坑与 `annotation` 常为空。
6. [古籍查询 API 分页机制：page / maxResult / allPages 怎么用](https://www.showapi.com/guides/ancient-books-pagination-1643) — 翻页参数含义与多语言分页循环写法。
### 生态集成
7. [通过 MCP 在 AI 客户端（Cherry Studio / ChatBox）中调用古籍查询 API](https://www.showapi.com/guides/ancient-books-mcp-1643) — 配置官方 MCP，在对话里直接查古籍。
8. [导入 Postman / Swagger：用 OpenAPI 文档管理古籍查询接口](https://www.showapi.com/guides/ancient-books-openapi-1643) — 下载 YAML，导入 API 工具自动生成请求模板。
### 行业方案 / 最佳实践
9. [古籍查询 API 在教育 / 国学场景的集成实践：读书笔记与知识库](https://www.showapi.com/guides/ancient-books-education-1643) — 原文+译文对照阅读、检索式国学知识库的最小可用设计。
10. [古籍查询 API 常见问题与避坑指南（trainslation 拼写、注释为空、分页）](https://www.showapi.com/guides/ancient-books-faq-1643) — 高频误用点集中答疑。
## 相关资源
| 资源 | 链接 |
|------|------|
| 接口详情页（参数 / 接入点） | https://www.showapi.com/apiGateway/view/1643 |
| 接入点：查询古籍名称 | https://www.showapi.com/apiGateway/view/1643/2 |
| 接入点：查询古籍明细 | https://www.showapi.com/apiGateway/view/1643/3 |
| OpenAPI 文档（YAML） | https://www.showapi.com/openapi/market/1643.yaml |
| OpenAPI 文档（JSON） | https://www.showapi.com/openapi/market/1643.json |
| AppKey 管理 | https://www.showapi.com/console#/myApp |
| 免费 API 档位说明 | https://www.showapi.com/free-api |
## 阅读建议
- 第一次用：按 1 → 2 → 5 顺序读，先跑通再理解字段。
- 要直接拿书单：看第 3 篇（218 部目录含 titleId）。
- 做系统集成：看 6（分页）+ 7（MCP）/ 8（OpenAPI）+ 9（教育场景）。
- 踩到坑：直接看第 10 篇 FAQ。
