图即

Appearance

码形占位 API ​

本组接口生成外观类似二维码或条形码的 SVG / 位图，用于结账页、物流单、卡片等 UI 占位。

生成结果不是有效编码，不能扫描，请勿用于支付、登录、核销或物流追踪。响应头 X-DevImage-Pseudo-Code 标明类型。

使用规范见 使用规范。

在线试玩 ​

伪 QR · demo · 128×128

图案不可扫描，仅作 UI 占位

配色（可选）

https://cdn.devimg.cn/qr/demo/128

伪 QR · GET /qr/:seed/:size ​

正方形码形。

参数约束说明
seed非空，≤ 50 字符标识，如 demo、checkout
size10–4000边长（px）

矩形 · GET /qr/:seed/:w/:h ​

非正方形时，矩阵居中并留边，适合横幅或卡片内嵌。

html
<img src="https://cdn.devimg.cn/qr/demo/320/80" alt="banner qr mock" width="320" height="80" />

伪 QR Query ​

参数说明
fg模块深色 hex（不含 #）
bg背景浅色 hex
accent少量强调模块 hex
variantmatrix（默认，含定位符）| minimal | dots
radius模块圆角 0–50（占模块边长百分比；dots 忽略）
html
<img src="https://cdn.devimg.cn/qr/demo/128" alt="pseudo qr" width="128" height="128" />
<img src="https://cdn.devimg.cn/qr/checkout/256?fg=111111&bg=f5f5f5&variant=dots" alt="dots" />
<img src="https://cdn.devimg.cn/qr/demo/128.webp" width="128" height="128" alt="webp" />

响应头：X-DevImage-Pseudo-Code: qr

伪条码 · GET /barcode/:seed/:w/:h ​

参数约束说明
seed非空，≤ 50 字符如 sku-mock
w10–4000宽度（px）
h10–4000高度（px）

伪条码 Query ​

参数说明
fg条纹 hex
bg背景 hex
variantcode128（默认）或 ean13（外形接近 EAN-13，仍不可扫）
html
<img src="https://cdn.devimg.cn/barcode/sku-mock/320/80" alt="pseudo barcode" width="320" height="80" />
<img src="https://cdn.devimg.cn/barcode/demo/320/80?variant=ean13&fg=1a1a1a&bg=fafafa" alt="ean13 mock" />

响应头：X-DevImage-Pseudo-Code: barcode

GET /code/styles ​

返回伪 QR / 伪条码可用的 variant 与 query 说明（JSON）。

bash
curl https://cdn.devimg.cn/code/styles

栅格与缓存 ​

默认 SVG。路径后缀 .webp / .png；栅格单边上限 1024，限流 60 次/分钟/IP。

Header伪 QR伪条码
Cache-Controlpublic, max-age=31536000, immutable同左
X-DevImage-Pseudo-Codeqrbarcode

与头像 devimg-matrix 的区别 ​

项/qr/:seed/:size/avatar/devimg-matrix/:seed/:size
用途独立码形占位头像风格之一
默认裁剪方形圆形
响应头X-DevImage-Pseudo-Code: qr头像通用头