546-2「关键字查询疾病」四个参数全部可选:typeId(一级科室)、subTypeId(二级科室)、key(关键词)、page(页码,每页最多 20 条)。
546-1「查询疾病科目」无业务参数,一次返回完整医院科室分类树:一级 20 类 + 二级子科目。
三个接入点天然构成「科目树(546-1) → 关键字检索(546-2) → 疾病明细(546-3)」链路,id 是串联它们的主键。
三个接入点的返回结构层级不同:546-1 是「科目树」,546-2 是「疾病列表」,546-3 是「疾病明细」。
常见疾病查询是免费官方自营接口,含 3 个接入点:科目树(546-1)、关键字检索(546-2)、疾病明细(546-3)。
常见疾病查询官方指南:系列总目录
1620-5 的 title 参数不支持模糊查询,必须传入与数据源一致的精确诗名
三个接入点是顺承关系:朝代(1620-3)→ 诗人(1620-4)→ 诗词(1620-5),靠 ID 接力
所有返回都包在 showapi_res_body 内,系统级字段(showapi_res_code 等)在它外层,业务字段在它里面
接口免费但设有使用档次(积分)限制以防滥用,高频/重复调用会消耗档位、可能触发限流
注册 ShowAPI 账号并创建应用,拿到 appKey 即可调用,接口免费(有使用档次限制)
列表类接入点(1620-4、1620-5)返回分页四件套:allPages / currentPage / allNum / maxResult
接口官方提供标准 OpenAPI 3.0 文档,覆盖全部 3 个接入点,可导入 Postman / Swagger UI 管理与调试
接口官方提供 MCP 服务,覆盖全部 3 个接入点,配置一次即可在支持 MCP 的 AI 客户端里直接调用
学习卡片的核心数据来自 1620-5 的 contentlist:每项含 original(原文)、translation(译文)、annotation(注释)
教育场景的核心是「诗人详情 + 诗词赏析」组合:1620-4 取 biography(生平),1620-5 取 contentlist(原文/译文/注释)



