部分字段（如 produce、paper）可能为空，展示端务必空值兜底，不要写死。

收货/盘点时扫 ISBN → 自动补全书名、作者、出版社、定价、封面 → 标准化上架，省去手工录入。

教材教辅靠 ISBN 批量入库：扫号 → 补全书目 → 按 edition(版次) 核对是否为最新版。

两级成功标志都要判：系统级 showapi_res_code=0 且业务级 ret_code=0 才是真正成功。

图书信息变化慢，"同一 ISBN 短期内重复查"完全可避免：以 isbn 为缓存 key，命中即不调接口。

返回 data.img 是封面图下载链接（如 http://static1.showapi.com/app2/isbn/imgs/...jpg），可能为空。

接口支持 978 开头的 ISBN-13 及部分 10 位 ISBN；以 isbn 参数传入即可。

典型链路：扫码枪/输入框取 ISBN → 调图书ISBN查询补全书目 → 落库 → 前端展示藏书卡片。

业务数据在 showapi_res_body 内；系统级字段 showapi_res_code=0 表示整体成功。

图书ISBN查询是免费接口：传 ISBN 即可拿到书名、作者、出版社、定价、封面图等 13 个字段。

图书ISBN查询（apiCode=1626）官方指南总目录

节假日查询提供标准 OpenAPI 3.0 文档，覆盖全部 3 个接入点。

节假日查询已提供官方 MCP 服务，覆盖全部 3 个接入点。

文档点名节假日查询适用于"证券投资"场景——用它判定法定节假日的休市日很合适。

数据层：894-4 拿全年放假 + 894-7 拿补班，合并成"日期 → 类型"映射表。

894-6、894-7 明确只支持 2018 年（含）起的数据；更早年份查不到。