Skip to main content
GET
在 Management API 主机(api.scanova.io)上下载渲染好的二维码图片,使用您的原始 Management API 密钥进行身份验证。
string
必填
该二维码的 qrid,例如 QR7K9M2XN。
旧路径 /qrcode/{qrid}/download/ 出于向后兼容目的仍然可用——同一个视图,行为相同。

查询参数

string
默认值:"png"
输出格式:png、jpg、jpeg、svg、pdf、eps 或 ps。
integer
默认值:"300"
图片尺寸(像素),范围从 10 到 2400。
boolean
默认值:"false"
为 true 时,返回一份在本地生成(而非通过图像生成服务)的可打印 PDF,并忽略 file 参数。
string
可选的预编码负载覆盖值。动态二维码不需要此参数——它是为静态二维码而存在的,因为该后端并不会独立复现前端针对静态类型的客户端数据编码逻辑。

响应

成功的请求会以二进制文件下载的形式返回图片(Content-Disposition: attachment),文件名取自该二维码的名称(若未命名则取其 qrid)。

错误

当 size 超出 10–2400 范围,或 file 不是受支持的格式之一时返回。
该 qrid 不存在,或不属于该密钥所属的账户。
上游图像生成服务不可访问。这不是客户端错误——请重试,如果持续出现请联系支持团队。

相关内容

授权

Authorization
string
header
必填

Send your Management API key as the raw value of the Authorization header — no "Bearer " or "Token " prefix, and no other characters. Example: Authorization: YOUR_API_KEY. A header containing more than one space-separated part is rejected outright. Requests also require the request's Host header to be the management API host (e.g. api.scanova.io) — the same key sent to the regular API host will not authenticate.

路径参数

qrid
string
必填

The QR code's qrid — the opaque public identifier returned by the list endpoint, not the numeric id.

查询参数

size
integer
默认值:300

Output size in pixels, from 10 to 2400.

for_print
boolean
默认值:false

Return a print-ready PDF, generated locally rather than via the generator service.

file
enum<string>

Output format.

可用选项:
png,
jpg,
jpeg,
svg,
pdf,
eps,
ps
info
string

Pre-computed encode payload override, for static categories whose client-side encoding the backend does not reproduce.

响应

The rendered image, as a binary attachment.