教材教辅管理如何用图书ISBN查询做批量入库与版次核对
# 教材教辅管理如何用图书ISBN查询做批量入库与版次核对
> 接口/接入点：图书ISBN查询（1626-1） · 是否免费：免费（有使用档次限制） · 请求方式：POST / GET · 返回格式：JSON · 适用人群：学校/机构图书管理员、教务 · 阅读时间：约 7 分钟
## TL;DR
- 教材教辅靠 ISBN 批量入库：扫号 → 补全书目 → 按 `edition`(版次) 核对是否为最新版。
- 同样为**单查同步**：批量是客户端循环调用 + 缓存，无服务端批量接入点。
- `edition` 字段用于区分同一书名的不同版次，避免发错版本。
## Why
学校、培训机构每年采购大量教材教辅，版本（版次）还常更新。手工核对手里的书和"应发版本"极易出错。用图书ISBN查询扫号入库，再比对 `edition`，能快速发现"拿的是旧版/错版"，保证发放准确。
## What
| 目标 | 做法 |
|------|------|
| 批量入库 | 逐 ISBN 调接口补全书目，落入教材库（以 ISBN 为主键） |
| 版次核对 | 取 `data.edition` 与"应发版次"比对，不一致标红 |
| 缓存控量 | 同一 ISBN 只查一次（以 ISBN 为 key 缓存） |
| 缺失兜底 | 部分字段可能为空，列表展示做空值兜底 |
## How
### 步骤 1：批量入库并标记版次
```python
def import_textbooks(isbns: list[str], expect_edition: dict[str, str]):
rows = []
for isbn in isbns:
book = lookup_book(isbn) # 带缓存
if not book:
rows.append({"isbn": isbn, "found": False})
continue
rows.append({
"isbn": isbn,
"title": book["title"],
"author": book["author"],
"publisher": book["publisher"],
"edition": book.get("edition"),
"edition_match": book.get("edition") == expect_edition.get(isbn),
})
return rows
```
### 步骤 2：版次不一致告警
```python
mismatches = [r for r in rows if r.get("found") and not r["edition_match"]]
if mismatches:
print("以下教材版次不符，请复核：", [r["isbn"] for r in mismatches])
```
## 返回示例与解析
入库行主要取 `title/author/publisher/edition`；`edition` 为空时不强行判定，转人工确认。
## 进阶 / 边界
- **无服务端批量**：批量为客户端循环 + 缓存，注意免费档位总量。
- **版次口径**：`edition` 为文档返回字段（版次），与"印次"等不同，以接口返回为准。
- **多版本并存**：同一 ISBN 对应唯一书目，不同版次通常是不同 ISBN，靠 ISBN 区分而非靠 edition。
## FAQ
**Q1：能一次导入很多 ISBN 吗？**
可以，但需在客户端逐条调用本接口（单查）并加缓存；不存在一次传多号的批量接口。
**Q2：edition 为空怎么核对版次？**
该书本就缺版次信息，转人工核对，不要假设其等于某值。
**Q3：旧版教材怎么处理？**
用 `edition` 与应发版次比对，不一致标红复核；历史版本可单独归档。
**Q4：免费档位够批量入库用吗？**
取决于总量与缓存命中；同批 ISBN 去重 + 缓存后实际调用量很低，详见缓存策略篇。
## 相关能力 / 下一步阅读
- [图书ISBN查询免费档位下如何设计缓存策略省调用额度](https://www.showapi.com/guides/isbn-book-cache-cost-1626)
- [图书ISBN查询返回字段全解：一本书的 13 个元数据字段一文读懂](https://www.showapi.com/guides/isbn-book-fields-explained-1626)
- [书店/二手书平台如何用图书ISBN查询一键补全上架信息](https://www.showapi.com/guides/isbn-book-bookstore-plan-1626)
- **本系列共 12 篇**：查看[图书ISBN查询（apiCode=1626）官方指南总目录](https://www.showapi.com/guides/isbn-book-guides-1626)
