书店/二手书平台如何用图书ISBN查询一键补全上架信息
# 书店/二手书平台如何用图书ISBN查询一键补全上架信息
> 接口/接入点：图书ISBN查询（1626-1） · 是否免费：免费（有使用档次限制） · 请求方式：POST / GET · 返回格式：JSON · 适用人群：书店/二手书运营、电商从业者 · 阅读时间：约 7 分钟
## TL;DR
- 收货/盘点时扫 ISBN → 自动补全书名、作者、出版社、定价、封面 → 标准化上架，省去手工录入。
- 本接口是**单查同步**："批量上架"在客户端循环调用 + 缓存实现，不虚构服务端批量能力。
- 部分字段（如 `produce`）可能为空，上架表单需做空值兜底与人工补录。
## Why
书店、二手书平台每天要上架大量书。让店员一本本手敲书名出版社，既慢又易错。接上图书ISBN查询，扫一下条码就出标准书目，店员只需核对价格/品相，上架效率与数据质量同时提升。
## What
| 环节 | 做法 |
|------|------|
| 取号 | 扫码枪/手机扫书背 ISBN 条码，得到原始号 |
| 补全 | 归一化后调接口，取 `data` 13 字段 |
| 上架 | 映射到商品表（标题/作者/出版社/定价/封面/版次/装帧） |
| 兜底 | `produce`/`paper` 等空字段展示为"—"，支持人工补录 |
| 省额度 | 以 ISBN 为 key 缓存，重复书不重复查（见缓存策略篇） |
## How
### 步骤 1：扫码 → 补全 → 上架（伪代码）
```
ISBN = 扫码枪读取() # 如 "9787208061644"
book = lookup_book(ISBN) # 带缓存的查询封装
if book is None:
提示"未查询到，转人工录入"
else:
商品.标题 = book.title
商品.作者 = book.author
商品.出版社 = book.publisher
商品.定价 = book.price
商品.封面 = save_cover(ISBN, book.img) # 下载到自有存储
商品.版次 = book.edition
商品.装帧 = book.binding
上架(商品)
```
### 步骤 2：批量收货（客户端循环）
```python
def batch_listing(isbns: list[str]):
results = []
for isbn in isbns:
book = lookup_book(isbn) # 内部含缓存，重复号不重复查
results.append(book or {"isbn": isbn, "found": False})
return results
```
> 说明：接口本身无"批量查询"接入点，批量是客户端逐条调用 + 缓存；请勿声称存在服务端批量能力。
## 返回示例与解析
补全后商品记录主要取 `title/author/publisher/price/img/edition/binding`；空字段以占位符展示，保留人工补录入口。
## 进阶 / 边界
- **无服务端批量**：所有"批量"均为客户端循环调用，注意免费档位总量，配合缓存控量。
- **价格口径**：返回的 `price` 为定价（标价），二手/实际售价由你的业务决定，不要直接当售价。
- **版次核对**：用 `edition`(版次) 区分同一书名的不同版本，避免上架错版。
- **封面缺失**：`img` 为空时商品页用占位图。
## FAQ
**Q1：接口支持一次传多个 ISBN 批量查吗？**
不支持。本接口为单 ISBN 查询；批量上架请在客户端循环调用并加缓存。
**Q2：返回的 price 是我该卖的价格吗？**
不是。`price` 是图书定价，你的售价按自身策略设定。
**Q3：有些书查不到怎么办？**
转人工录入，留存 ISBN 便于后续补查；不要阻塞整批上架。
**Q4：字段缺失影响上架吗？**
不影响。`produce` 等空字段展示为"—"并支持人工补录即可。
## 相关能力 / 下一步阅读
- [图书管理系统如何集成图书ISBN查询：从扫码录入到藏书档案](https://www.showapi.com/guides/isbn-book-library-system-1626)
- [图书ISBN查询免费档位下如何设计缓存策略省调用额度](https://www.showapi.com/guides/isbn-book-cache-cost-1626)
- [图书ISBN查询返回字段全解：一本书的 13 个元数据字段一文读懂](https://www.showapi.com/guides/isbn-book-fields-explained-1626)
- **本系列共 12 篇**：查看[图书ISBN查询（apiCode=1626）官方指南总目录](https://www.showapi.com/guides/isbn-book-guides-1626)
