# 常见疾病查询官方指南：系列总目录
> 接口：常见疾病查询（apiCode=546）· 免费 · 请求方式 POST/GET · 返回格式 JSON · 服务商：昆明秀派科技有限公司（易源官方自营）· 适用人群：开发者 / 医疗产品 / AI Agent 开发者 · 阅读时间：约 5 分钟
## 接口一句话速览
常见疾病查询（apiCode=546）是易源 ShowAPI 的**免费官方自营**接口，覆盖「**疾病科目树 → 关键字检索 → 疾病明细**」三步查询：返回医院科室分类、疾病列表，以及含**症状 / 诊断 / 治疗 / 预防**结构化标签的疾病详情。三个接入点均为同步请求-响应，适合医院导诊、挂号系统、健康类 App 与医疗知识库搭建。
- 546-1 查询疾病科目：无参数，返回完整科室分类树（一级 `typeId` + 二级 `subId`）
- 546-2 关键字查询疾病：可选 `typeId`/`subTypeId`/`key`/`page`，返回带疾病 `id` 的列表
- 546-3 取得疾病明细：必填 `id`（取自 546-2），返回含 `tagList` 的详情
## 本系列文章（共 12 篇）
### 入门层
1. [常见疾病查询：5 分钟从注册到拿到第一篇疾病明细](https://www.showapi.com/guides/disease-query-quickstart-546) — 跑通三接入点的最小可运行链路，替换 AppKey 即跑。
2. [常见疾病查询返回字段全解：科目树、疾病列表与明细结构一文读懂](https://www.showapi.com/guides/disease-query-response-fields-546) — 三接入点返回结构与 `ret_code`（0=成功）对照表。
3. [常见疾病查询：科目树 → 关键字 → 明细 三步入诊全链路设计](https://www.showapi.com/guides/disease-query-pipeline-546) — 把三接入点串成完整导诊链路，含时序图与数据表设计。
### 场景实战层
4. [常见疾病查询：医院科室分类全量清单（含 typeId / subId 映射）](https://www.showapi.com/guides/disease-query-department-list-546) — 基于 546-1 的可独立搜索科室字典。
5. [常见疾病查询：关键字检索疾病（546-2 的 typeId/subTypeId/key/page 用法）](https://www.showapi.com/guides/disease-query-keyword-search-546) — 模糊搜与限定科室搜两种拼参实战。
6. [常见疾病查询：取得疾病明细并解析症状/诊断/治疗/预防（546-3 的 tagList）](https://www.showapi.com/guides/disease-query-detail-546) — 解析 `tagList` 的 name/content 结构化标签。
### 行业方案层
7. [医院导诊/挂号系统如何集成常见疾病查询？从症状到科室推荐](https://www.showapi.com/guides/disease-query-triage-546) — 症状关键词推荐挂号科室，附免责表述。
8. [健康类 App / 医疗知识库：用常见疾病查询搭建结构化病种库](https://www.showapi.com/guides/disease-query-health-kb-546) — 用三接入点灌病种与症状/诊断/治疗/预防内容。
### 生态集成层
9. [通过 MCP 在 Cherry Studio / ChatBox 中直接调用常见疾病查询](https://www.showapi.com/guides/disease-query-mcp-546) — 在 AI 客户端里直接查询，作为 Agent 知识工具。
10. [导入 Postman / Swagger：用 OpenAPI 文档管理常见疾病查询接口](https://www.showapi.com/guides/disease-query-openapi-546) — 导入 YAML 自动生成请求模板与 Mock。
### 最佳实践层
11. [免费接口也要缓存：常见疾病查询的静态科室树与明细缓存策略](https://www.showapi.com/guides/disease-query-cache-546) — 提升稳定性与响应，降低外部依赖。
12. [常见疾病查询常见问题与 ret_code 排查：0 为成功、非 0 即失败](https://www.showapi.com/guides/disease-query-faq-546) — 高频 FAQ 与错误排查（文档未提供细分错误码）。
## 相关资源
- 接口详情页：https://www.showapi.com/apiGateway/view/546
- 接入点：546-1 查询疾病科目 / 546-2 关键字查询疾病 / 546-3 取得疾病明细
- OpenAPI 3.0（YAML）：https://www.showapi.com/openapi/market/546.yaml
- OpenAPI 3.0（JSON）：https://www.showapi.com/openapi/market/546.json
- AppKey 管理：https://www.showapi.com/console#/myApp
- 调用帮助：https://www.showapi.com/helpcenter/view#/3960/1
## 阅读建议
- **第一次使用**：先读 ① 快速开始 → ③ 全链路，建立整体认知。
- **要落地业务**：按 ④ 科室清单 → ⑤ 关键字检索 → ⑥ 明细 拿数据，再读 ⑦/⑧ 做集成。
- **做 API 治理或接 AI**：看 ⑨ MCP / ⑩ OpenAPI / ⑪ 缓存。
- 遇到报错先看 ⑫ FAQ 与 `ret_code` 排查。
