Skip to main content
GET
Management API 主机(management.scanova.io)上下载渲染好的二维码图片,使用您的原始 Management API 密钥进行身份验证。
string
必填
该二维码的 qrid,例如 QR7K9M2XN
也可以通过 /qr/{qrid}/download/ 访问——同一个视图,行为相同。

查询参数

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

响应

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

错误

size 超出 102400 范围,或 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: 401f7ac837da42b97f613d789819ff93537bee6a. 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. management.scanova.io) — the same key sent to the regular API host will not authenticate.

路径参数

qrid
string
必填

响应

200

QR image binary