# 条码生成与识别 API 指南总目录
> **接口速览**：条码生成与识别（apiCode 1129）是 ShowAPI 视觉处理类的**免费**接口，一个接口覆盖「条码生成」与「条码识别」两类能力——生成 13 种条码并返回图片链接，识别可返回条码中的文字内容。共 4 个接入点：生成 `1129-1`、上传图片识别 `1129-2`、图片链接识别 `1129-3`、Base64 识别 `1129-4`，均为免费、同步请求-响应（无批量、无订阅推送）。
本目录汇总全系列 12 篇指南，按「入门 → 场景 → 技术深挖 → 行业 → 生态」分层，帮助你从第一次调用到生产落地。
## 入门层
1. [条码生成与识别：5 分钟接入，从注册到生成第一条条码与识别第一张图](https://www.showapi.com/guides/barcode-quickstart-1129) — 跑通「生成 + 识别」最小闭环，复制代码替换 AppKey 即可运行。
2. [条码生成与识别：13 种条码格式（formatType）对照与选型指南](https://www.showapi.com/guides/barcode-format-types-1129) — EAN_8 到 CODABAR 共 13 种格式，告诉你每种适用什么场景。
## 场景实战层
3. [条码识别三种传图方式怎么选：上传图片 / 图片链接 / Base64 实战对比](https://www.showapi.com/guides/barcode-three-input-modes-1129) — 1129-2/3/4 三接入点差异、选型决策表与代码。
4. [零售与仓储如何用条码生成接口做商品条码与价签](https://www.showapi.com/guides/barcode-generate-retail-1129) — SKU 映射、批量生成与图片落盘。
5. [仓储入库如何用条码识别接口做扫码核验（含三种传图方案）](https://www.showapi.com/guides/barcode-recognize-wms-1129) — PDA/摄像头取图 → 识别 → 与 WMS 比对核验。
## 技术深挖层
6. [条码生成与识别：返回字段全解（imgUrl / retText / ret_code / msg）](https://www.showapi.com/guides/barcode-response-fields-1129) — 四个接入点返回结构对照速查表，全系列复用的基线。
7. [条码生成与识别：ret_code 非 0 与识别失败排查指南](https://www.showapi.com/guides/barcode-error-handling-1129) — 文档仅定义「0 成功/其他失败」，给出通用兜底与常见失败原因。
8. [条码生成图片 12 小时过期：缓存与本地落盘保存策略](https://www.showapi.com/guides/barcode-image-expiry-1129) — 生成接口图片每 12h 删除，三种保存方案与代码。
## 行业方案层
9. [图书与档案管理：ISBN 条码生成与扫码借还方案](https://www.showapi.com/guides/barcode-library-books-1129) — ISBN（EAN_13）书标生成 + 借还扫码核验。
10. [物流与质量追溯：一物一码条码生成与扫码核验方案](https://www.showapi.com/guides/barcode-logistics-trace-1129) — 一物一码生成 + 出入库扫码闭环。
## 生态集成层
11. [通过 MCP 协议在 AI 客户端直接调用条码生成与识别](https://www.showapi.com/guides/barcode-mcp-integration-1129) — 在 Cherry Studio / ChatBox 配置 `showapi-mcp-1129` 对话式调用。
12. [导入 Postman / Swagger：用 OpenAPI 文档管理条码接口](https://www.showapi.com/guides/barcode-openapi-import-1129) — 下载 `1129.yaml` 导入 Postman / Swagger UI 做 API 治理。
## 相关资源
- 接口详情页：[条码生成与识别 apiCode=1129](https://www.showapi.com/apiGateway/view/1129)
- 4 个接入点：[生成 1129-1](https://www.showapi.com/apiGateway/view/1129/1) · [上传图片识别 1129-2](https://www.showapi.com/apiGateway/view/1129/2) · [图片链接识别 1129-3](https://www.showapi.com/apiGateway/view/1129/3) · [Base64 识别 1129-4](https://www.showapi.com/apiGateway/view/1129/4)
- OpenAPI 文档：[YAML](https://www.showapi.com/openapi/market/1129.yaml) · [JSON](https://www.showapi.com/openapi/market/1129.json)（覆盖全部接入点）
- AppKey 管理：[控制台](https://www.showapi.com/console#/myApp)
- 免费档位说明：[积分与档位](https://www.showapi.com/free-api)
## 阅读建议
- 第一次用：从 **[5 分钟接入](https://www.showapi.com/guides/barcode-quickstart-1129)** 开始，先跑通闭环。
- 做生成：看 **[13 种格式对照](https://www.showapi.com/guides/barcode-format-types-1129)** 与 **[12 小时过期策略](https://www.showapi.com/guides/barcode-image-expiry-1129)**。
- 做识别：看 **[三种传图对比](https://www.showapi.com/guides/barcode-three-input-modes-1129)** 与 **[返回字段全解](https://www.showapi.com/guides/barcode-response-fields-1129)**。
- 接工具链：用 **[MCP](https://www.showapi.com/guides/barcode-mcp-integration-1129)** 或 **[OpenAPI](https://www.showapi.com/guides/barcode-openapi-import-1129)** 集成。
