条码识别

接口标识: barcodedecode 价格: 0.08 元/次同步响应

接口介绍
接口文档
在线测试

接口简介

条码识别接口对一张图片自动检测并解码其中全部条码，常见一维条码与二维码都能识别，无需预改制式；每条码返回内容、制式与在图中的位置包围盒，一图多码一次全部给出，未检测到条码时明确提示。单图最大 20MB，支持 PNG、JPEG、GIF、BMP、WebP、TIFF 等格式。适合仓储盘点、电商签收、支付核销与影像档案信息提取等场景。

详细介绍

![条码识别接口封面](https://fujian.phpwc.com/pyapi/uploads/site/20261111/apiops_barcodedecode__1794363346_349380a0cb28.png)

仓储盘点、电商签收、影像归档都要读取图片里的条码信息，人工逐个扫码既慢又容易漏。条码识别接口一次解码一张图片中的全部条码，内容与位置一起返回。

## 接口概述
面向物流仓储、电商、支付核销与影像资料管理等场景，上传一张含条码的图片，接口自动检测图中全部一维条码与二维码并逐一解码，返回列表：每条包含条码内容、制式名称与条码在图中的位置包围盒，一图多码一次全部返回；未检测到条码时给出明确提示。识别结果可直接写入库存系统、签收流程与档案索引，无需自建解码环境。

## 核心能力
1. **一维二维通吃**：常见一维条码与二维码自动检测解码，无需预先指定制式。
2. **多码批量输出**：一张图含多个条码时一次全部返回，并给出条码数量便于核对。
3. **位置定位**：每条码附包围盒坐标 [x, y, width, height]，可用于裁剪复核与画面标注。
4. **制式回传**：每条结果带制式名称（如 EAN13、QRCode），便于分类归档与业务分流。
5. **格式广泛**：支持 PNG、JPEG、GIF、BMP、WebP、TIFF 等常见图片格式，单图最大 20MB。

## 产品优势
1. **接入简单**：一次 POST 传一张图片即得识别结果，无回调、无轮询。
2. **响应迅速**：解码在平台服务器本地完成，无需等待第三方服务。
3. **稳定可靠**：解码内核随服务内置，无外部依赖即无上游抖动风险。
4. **准确规范**：内容之外同时返回制式与位置信息，便于业务系统二次校验与定位溯源。
5. **降本增效**：省去自建开源解码方案的部署与系统依赖维护。
6. **生态开放**：与平台其余接口共用同一套签名与响应结构，接入一次处处复用。

## 效果展示
一句话理解：它就像一台能认多码的扫描仪，你把图片交给它，它把图里所有条码的内容、类型和所在位置逐条列给你。

以一次真实调用为例，你要传的参数：

| 参数 | 本次示例值 | 说明 |
|------|-----------|------|
| file | https://example.com/demo/package_label.jpg | 含条码的图片，支持公网URL、Base64（data:开头）与平台文件ID（fileid_开头），单图不超过 20MB |

你会拿到的结果：

| 返回内容 | 本次示例值 | 对应字段 |
|---------|-----------|---------|
| 条码列表 | 下方两条结果 | `codes`，每条含内容、制式、位置三项 |
| 第一条码内容 | `"6901234567892"` | `codes[0].content`，解码出的原始文本 |
| 第一条码制式 | `"EAN13"` | `codes[0].format`，条码制式名称 |
| 第一条码位置 | [120, 340, 560, 180] | `codes[0].rect`，包围盒 [x, y, 宽, 高]，取不到时为 null |
| 第二条码内容 | `"https://example.com/p/1001"` | `codes[1].content`，二维码常为网址或文本 |
| 识别到的条码数量 | 2 | `count`，与 codes 条数一致 |

API请求示例：

```text
POST /api/barcodedecode
file=https://example.com/demo/package_label.jpg
```

API响应示例：

```json
{
  "code": 0,
  "desc": "成功",
  "data": {
    "codes": [
      {"content": "6901234567892", "format": "EAN13", "rect": [120, 340, 560, 180]},
      {"content": "https://example.com/p/1001", "format": "QRCode", "rect": [760, 90, 150, 150]}
    ],
    "count": 2
  },
  "request_id": "req-barcodedecode-demo-001"
}
```

本例一张图上同时印有 EAN13 商品条码与一枚二维码，一次调用全部识别；count 与 codes 条数一致，可直接用于判断识别是否完整；图中没有条码时会返回参数错误并提示未检测到。

## 应用场景
1. **仓储盘点**：箱标拍照批量读取箱码与运单号，替代扫码枪逐件扫描。
2. **电商签收**：从签收照片中提取条码信息，自动核对订单与包裹。
3. **支付核销**：解析付款码、优惠券码内容，完成核销与对账。
4. **影像归档**：批量提取档案照片中的条码信息，建立可检索索引。
5. **质检复核**：产线贴标后抽样拍照，确认条码内容与工单一致。

## 应用案例
一家中型电商仓库此前用扫码枪逐件扫描出库箱标，高峰期排队严重；改为拍照后调用接口识别，箱码与运单二维码一次读出，包围盒坐标还能裁剪条码区域随单存档，出库效率明显改善。

一家展会票务系统需要核验用户回传票券截图上的二维码与条码，此前靠人工肉眼比对；接入接口后上传即自动解码并与订单库比对，核验流程从人工处理变为秒级自动完成。

一家食品厂品控部门在标签印制上线后做读回验证：拍摄印制样张调用接口解码，与工单编码逐位比对，不一致立即停线调整，避免了整批标签报废的损失。

常见问题

Q：能识别哪些条码制式？

A：自动检测图中全部常见一维条码（EAN、UPC、CODE、ITF 系列等）与二维码，无需预改制式，每条结果的 format 字段会标明具体制式名称。

Q：图片里没有条码会返回什么？

A：未检测到条码时返回参数错误并提示「未在图片中检测到条码」，不会返回空列表，便于调用方直接区分处理。

Q：rect 字段是什么？

A：rect 是条码在图片中的位置包围盒，格式为 [x, y, width, height]（像素），可用于裁剪条码区域或在画面上做标注；个别情况下取不到位置时为 null。

Q：支持多大的图片？

A：单图最大 20MB，支持 PNG、JPEG、GIF、BMP、WebP、TIFF 格式；超限、损坏或无法加载的图片会返回参数错误。

条码识别二维码解码扫码仓储盘点图片识别

接口地址： https://www.phpwc.cn/api/barcodedecode

请求方式： POST

业务请求参数

参数名	类型	必填	默认值	说明
`file`	file	必填	-	图片/文件，支持三形态：公网URL / data:image;base64编码 / file_id(fileid_开头)

查看签名算法查看调用示例

响应参数

字段名	类型	说明
`code`	int	状态码，0=成功
`desc`	string	状态描述
`data`−	object	业务数据（成功时返回）
`codes`−	array	识别到的条码列表
`content`	string	条码内容
`format`	string	条码制式
`rect`	array	位置包围盒 [x, y, width, height]（取不到时为 null）
`count`	int	识别到的条码数量
`request_id`	string	请求追踪ID

JSON 示例：

调用成功：

{
  "code": 0,
  "desc": "success",
  "data": { ... },
  "request_id": "abc123..."
}

调用失败：

{
  "code": 999,
  "desc": "错误描述",
  "request_id": "abc123..."
}

请先登录后使用在线测试