二维码生成

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

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

接口简介

二维码生成接口输入一段文本、网址或JSON即可生成二维码图片，内容最长2000字符。图片尺寸50~2000像素可调，前景色与背景色按十六进制色值自定义，四周留白可设；提供7%、15%、25%、30%四档纠错等级，等级越高越耐污损与遮挡；还可在码中央嵌入Logo并单独设定Logo宽度。适合支付收款、活动推广、电子名片与商品标签。

详细介绍

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

一行文本进，一张二维码出。支持自定义尺寸、颜色、四档纠错与中心Logo嵌入，一次调用同时拿到Base64与临时图片URL——支付收款、活动推广、电子名片、商品标签，扫码入口即接即有。

## 接口概述

二维码生成接口面向需要把网址、文本、JSON等内容快速转成扫码入口的业务：传入 text 内容（最大2000字符），按需指定图片尺寸、前景背景色、纠错等级与Logo，接口在本地离线完成编码与绘图，一次性返回三种图片形态——纯Base64、含 data URI 前缀的Base64（可直接作为 img 标签 src）与平台临时图片URL，并附图片字节数。生成过程不调用任何第三方服务，同步毫秒级返回；Logo 支持公网URL、data URI 或 Base64 传入，加载失败时自动降级为无Logo版本，不影响出图。适合嵌入收银台、营销页、名片生成器与商品打标流程。

## 核心能力

1. **内容即码**：网址、文本、JSON均可编码，最大2000字符，自动选择二维码版本。
2. **样式自定义**：尺寸50-2000像素、前景背景色任意十六进制配色，贴合品牌视觉。
3. **四档纠错**：l/m/q/h对应约7%/15%/25%/30%容错，印刷、覆膜场景可抗磨损。
4. **Logo嵌入**：中心嵌入品牌Logo并可控宽度，配合高纠错档保证扫码成功率。
5. **多形态返回**：Base64、data URI、临时URL一次拿全，前端展示与后端存储两相宜。

## 产品优势

- **接入简单**：POST请求、JSON返回，必填参数只有 text 一个，其余全部可选。
- **响应迅速**：本地离线生成，无上游波动与配额限制，支持高并发批量出码。
- **稳定可靠**：Logo加载失败自动降级、图片存储上传失败不影响Base64返回，出图链路有兜底。
- **形态齐全**：三种图片形态覆盖前端直显、下载转存、后台落库等全部用法。
- **降本增效**：替代自建二维码渲染服务与配色调试，营销物料即调即出。

## 效果展示

一句话理解：它就像一台随叫随到的「制码机」——把网址或文字递进去，按你指定的尺寸、配色和Logo，吐出一张可直接印刷展示的二维码图片。

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

| 参数 | 本次示例值 | 说明 |
|------|-----------|------|
| text | https://www.phpwc.com | 二维码内容，必填，最大2000字符 |
| w | 300 | 图片边长（像素），范围50-2000 |
| el | h | 纠错等级，l/m/q/h四档，印刷与嵌Logo建议h |
| fgcolor | 1a73e8 | 前景色（十六进制、不含#），缺省为黑色000000 |

你会拿到的结果：

| 返回内容 | 本次示例值 | 对应字段 |
|---------|-----------|---------|
| 纯Base64图片 | iVBORw0KGgo…（截断） | `qr_base64`，自行落库或转存 |
| 可直接显示的图 | data:image/png;base64,iVBOR…（截断） | `qr_data_base64`，直接赋给 img 标签 src |
| 临时图片URL | https://fujian.phpwc.com/pyapi/uploads/api/20261107/qrcode_9f3a1c.png | `qr_url`，产物转存失败时该字段为空字符串，`qr_base64` 等其余字段照常返回 |
| 图片大小 | 12345 字节 | `qr_size` |

API请求示例：

```
POST /api/v1/qrcode
text=https://www.phpwc.com&w=300&el=h&fgcolor=1a73e8
```

API响应示例：

```json
{
  "code": 0,
  "desc": "成功",
  "data": {
    "qr_base64": "iVBORw0KGgoAAAANSUhEUgAAA...",
    "qr_data_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAA...",
    "qr_url": "https://fujian.phpwc.com/pyapi/uploads/api/20261107/qrcode_9f3a1c.png",
    "qr_size": 12345
  }
}
```

一次调用即拿到三种图片形态：网页端直接用 `qr_data_base64` 展示，需要落存储的取 `qr_base64` 或尽快转存 `qr_url`，`qr_size` 可用于预估带宽与存储占用。

## 应用场景

- **支付收款**：收银台与账单页动态生成收款码，链接即传即出
- **活动推广**：海报、易拉宝物料嵌入品牌配色的活动跳转码
- **电子名片**：名片生成器一键输出含头像Logo的名片码
- **商品标签**：批量为商品生成溯源、详情页跳转标签码
- **会议签到**：邀请函与工单上的入场码、签到码快速出图

## 应用案例

- **连锁餐饮收银**：接入前收款码为静态贴纸，活动跳转靠口头引导；接入后小票与桌贴按活动动态出码，品牌色与Logo统一，扫码进活动的转化明显提升。
- **名片SaaS平台**：用户自助换配色与Logo生成名片码，原先依赖前端画布导出、清晰度不稳；接入后统一由接口输出300像素以上的高清图，印刷相关投诉显著减少。

常见问题

Q：这个接口能做什么？

A：把任意文本、网址或JSON内容（最大2000字符）生成为二维码PNG图片，支持自定义尺寸、前景背景色、纠错等级与中心Logo，一次返回Base64编码与临时图片URL，前端可直接展示或下载。

Q：返回的图片有几种形态？

A：三种：qr_base64（纯Base64，自行拼接使用）、qr_data_base64（含 data:image/png;base64, 前缀，可直接赋给 img 标签的 src）、qr_url（平台生成的临时图片URL，建议尽快转存到自己的存储；若存储上传失败该字段为空字符串，不影响Base64字段）。qr_size 为图片字节数。

Q：Logo怎么传？传错了会怎样？

A：logo 参数支持公网图片URL、data URI 或纯Base64三种写法（URL需urlencode，且仅限公网地址）；lw 控制Logo宽度（默认60像素，范围10-500）。Logo加载失败时接口不报错，自动降级生成不含Logo的二维码；嵌入Logo建议搭配 h 级纠错保证扫码成功率。

Q：纠错等级怎么选？

A：el 支持 l/m/q/h 四档，容错率分别约7%/15%/25%/30%，默认m。二维码会被印刷磨损、覆膜或嵌入Logo时，建议选 q 或 h 档。

Q：哪些情况会返回错误？

A：text 为空返回「缺少 text 参数」；超过2000字符返回「text 内容过长，最大支持2000字符」；el 传入 l/m/q/h 之外的值返回「el 参数无效」，以上均为参数错误（错误码40002）；其余生成异常返回错误码50206「二维码生成失败，请稍后重试」。

二维码生成二维码制作 QR码 Logo二维码 Base64图片收款码

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

请求方式： POST

业务请求参数

参数名	类型	必填	默认值	说明
`text`	string	必填	-	二维码内容，如网址、文本、JSON等，最大2000字符
`el`	string	选填	`m`	纠错等级：l(7%)/m(15%)/q(25%)/h(30%)，默认 m
`w`	int	选填	`300`	图片尺寸(像素)，宽高相同，默认 300，范围 50-2000
`m`	int	选填	`2`	边距大小(像素)，默认 10，范围 0-50
`bgcolor`	string	选填	`ffffff`	背景色(十六进制，不含#号)，默认 ffffff
`fgcolor`	string	选填	`000000`	前景色(十六进制，不含#号)，默认 000000
`logo`	string	选填	-	Logo图片URL或base64编码内容，需urlencode
`lw`	int	选填	`60`	Logo宽度(像素)，默认 60，范围 10-500

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

响应参数

字段名	类型	说明
`code`	int	状态码，0=成功
`desc`	string	状态描述
`data`−	object	业务数据（成功时返回）
`qr_base64`	string	图像纯base64编码，不含data URI前缀
`qr_data_base64`	string	含data URI前缀的图像base64编码
`qr_url`	string	临时图像URL，请尽快转存；若附件存储上传失败则返回空字符串（此时仍可用 qr_base64 / qr_data_base64）
`qr_size`	int	生成的二维码图像大小(字节)
`request_id`	string	请求追踪ID

JSON 示例：

调用成功：

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

调用失败：

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

请先登录后使用在线测试