二维码识别

接口标识: qrcodedecode 价格: 0.008 元/次 VIP免费同步响应

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

接口简介

二维码识别接口传入一张含二维码的图片，即可读出码内承载的原始内容，并自动判定这段内容是链接还是普通文本，业务侧可据此直接决定跳转还是入库，单张图片限1MB以内。适合票据与凭证核验、物料标签稽查、扫码绑定，以及在跳转前对外链内容先做一道安全检查。

详细介绍

![二维码识别接口封面](https://fujian.phpwc.com/pyapi/uploads/site/20261109/apiops_qrcodedecode__1794166699_8a32fec4ad08.png)

一张图进来，一行内容出去。本地离线检测图片中的二维码并解码，自动区分链接与文本，URL、Base64、文件ID三种传图方式随选——扫码核验、物料稽查、内容安全前置检查即接即用。

## 接口概述

二维码识别接口面向需要「从图片里把码读出来」的业务环节：传入一张含二维码的图片（公网URL、data URI Base64 或平台文件ID三选一，接口自动识别形态），本地解码引擎完成二维码定位与内容还原，返回识别出的文字或链接，并按内容自动标注类型——以 http/https 开头的判定为 url，其余为 text。全程离线完成、不调用第三方服务，同步毫秒级返回；图片限1MB以内，支持PNG、JPEG、GIF、BMP、WebP常见格式。典型用法包括：核验用户上传的票据与截图、稽查线下物料的码内容、在内容审核前置环节识别图片中隐藏的跳转链接。

## 核心能力

1. **码内容还原**：检测图片中的二维码并解码出存储的文字或链接，原样返回。
2. **类型自动判定**：按内容前缀区分 url 与 text，程序分支无需自行写正则判断。
3. **三种传图方式**：公网URL、data URI Base64、平台文件ID，一个 file 参数自动识别。
4. **多格式支持**：PNG、JPEG、GIF、BMP、WebP均可识别，1MB以内图片即传即解。
5. **输入防护**：URL输入仅限公网地址，内网与保留地址一律拒绝，平台侧更安全。

## 产品优势

- **接入简单**：POST请求、JSON返回，仅 file 一个业务参数，三种传图形态自动识别。
- **响应迅速**：本地离线解码，无上游波动与配额限制，支持高并发批量核验。
- **结果即用**：内容与类型两个字段直接驱动跳转、拦截或入库逻辑。
- **稳定可靠**：图片加载失败、格式损坏、未检测到二维码均有明确错误提示，便于分支处理。
- **降本增效**：替代自建解码服务与采集链路，图片核验流程一步到位。

## 效果展示

一句话理解：它就像手机里的「扫一扫」，但不用摄像头——把图片文件递给它，码里藏的文字或链接立刻原样读出来，还顺手告诉你是不是网址。

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

| 参数 | 本次示例值 | 说明 |
|------|-----------|------|
| file | https://fujian.phpwc.com/pyapi/uploads/api/20261107/qrcode_9f3a1c.png | 含二维码的图片，支持公网URL、data:开头的Base64、fileid_开头的文件ID |

你会拿到的结果：

| 返回内容 | 本次示例值 | 对应字段 |
|---------|-----------|---------|
| 识别出的内容 | https://www.phpwc.com | `qrcode`，码内存储的文字或链接 |
| 内容类型 | url | `type`，url=链接 / text=普通文本 |

API请求示例：

```
POST /api/v1/qrcodedecode
file=https://fujian.phpwc.com/pyapi/uploads/api/20261107/qrcode_9f3a1c.png
```

API响应示例：

```json
{
  "code": 0,
  "desc": "成功",
  "data": {
    "qrcode": "https://www.phpwc.com",
    "type": "url"
  }
}
```

响应只有两个字段：`qrcode` 是码内原始内容，`type` 已按前缀判定好类型——是链接就做跳转引导或域名白名单校验，是文本就直接入库比对，分支逻辑一行搞定。

## 应用场景

- **票据与凭证核验**：识别用户上传票据截图中的码内容，与订单信息自动比对
- **物料稽查**：巡检拍摄的线下海报、货架标签照片，批量核对码指向是否正确
- **内容安全**：审核前置环节读出图片内隐藏链接，拦截违规跳转与导流
- **扫码绑定**：网页端上传图片完成码内容解析与账号、设备绑定
- **资产管理**：设备铭牌二维码盘点，拍照上传即出资产编号

## 应用案例

- **电商平台审核团队**：用户评价图片中偶有违规导流二维码，人工逐张查看效率极低；接入后审核流水线自动读出码内容并按域名白名单拦截，违规图片漏放明显减少。
- **连锁品牌市场部**：各门店物料上的活动码是否指向正确落地页，原先靠督导逐店扫码；接入后督导拍照批量上传核对码内容，单轮巡检耗时大幅缩短。

常见问题

Q：这个接口能做什么？

A：检测并识别图片中的二维码，返回码内存储的文字或链接内容，并自动判定类型：以http/https开头的返回 type=url，其余返回 type=text。识别在平台本地离线完成，不经过第三方服务。

Q：图片怎么传？

A：file 参数三选一自动识别：公网图片URL（http/https开头）、data:开头的Base64图片（如 data:image/png;base64,…）、平台文件ID（fileid_开头）。三种形态之外的值会返回「file 参数格式无法识别」的参数错误。

Q：对图片有什么限制？

A：图片大小不超过1MB，支持PNG、JPEG、GIF、BMP、WebP格式；URL仅限公网地址。超限或加载失败返回「图片加载失败」提示，文件损坏返回「图片格式无效或已损坏」提示。

Q：一张图里有多个二维码怎么办？

A：接口返回检测到的第一个二维码内容。若需要区分多个码，建议将图片裁剪后分次识别。

Q：图片里没有二维码会怎样？

A：返回参数错误提示「未在图片中检测到二维码」（错误码40002），data为空。请确认二维码清晰完整、未被过度压缩或遮挡。

二维码识别二维码解码图片扫码码内容解析物料稽查内容安全

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

请求方式： POST

业务请求参数

参数名	类型	必填	默认值	说明
`file`	string	必填	-	文件输入（自动识别）：公网URL / Base64(data:开头) / 文件ID(fileid_开头)

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

响应参数

字段名	类型	说明
`code`	int	状态码，0=成功
`desc`	string	状态描述
`data`−	object	业务数据（成功时返回）
`qrcode`	string	二维码识别出的内容（文字或链接）
`type`	string	内容类型：url（以http/https开头的链接）或 text（普通文本）
`request_id`	string	请求追踪ID

JSON 示例：

调用成功：

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

调用失败：

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

请先登录后使用在线测试