翻页靠 page 参数，从 1 循环到 showapi_res_body.allPages；allNum 是总数可用于校验。

官方提供标准 OpenAPI 3.0 文档，覆盖全部接入点，可导入 Postman / Swagger UI 做请求模板与 Mock。

官方已提供接口级 MCP 配置，覆盖全部接入点（绕口令 + 谜语）。

全栈链路：后端取数（带缓存）→ 静态/接口给前端 → 前端随机出题、计时、计分 → 可分享 H5。

绕口令与谜语查询：官方指南总目录

免费接口有档次限制，前端是滥用高发地（按钮连点、轮询、多人同屏）。

返回有两层状态码：系统级 showapi_res_code（网关层）与业务级 showapi_res_body.ret_code（接口层），失败排查两个都要看。

绕口令适合「练发音、练口齿」：按关键词取一类绕口令，做每日打卡。

本接口是免费服务但设有使用档次限制（防滥用），文档未给出具体档位数字——额度以[官方档位说明](https://www.showapi.com/free-api)为准，本文不编造。

成功判定：showapi_res_code == 0（系统级）且 ret_code == 0（业务级）。文档仅定义 0=成功、非0=失败，无细分错误码表。

本接口免费，缓存的目的不是"省钱"（无按次扣费），而是提升响应速度、降低对外部接口的实时依赖、增强可用性。

常见疾病查询提供标准 OpenAPI 3.0 文档，覆盖全部 3 个接入点：YAML / JSON 双格式。

常见疾病查询提供官方 MCP 服务，覆盖全部 3 个接入点，URL：http://www.showapi.com.cn/mcp/546/{your_appKey}。

用 546-1 建科室骨架、546-2 拉疾病列表、546-3 灌症状/诊断/治疗/预防内容，三步即可搭出结构化病种库。

导诊本质是把"用户症状/病名"映射到"推荐挂号科室"，正好用 546-2（检索拿 typeId/subTypeId）实现。

546-3「取得疾病明细」必填 id，该 id 来自 546-2 关键字查询的返回，不能自造。