Skip to main content
GET
Descarga una imagen renderizada de un código QR en el host de la API de gestión (api.scanova.io), autenticado con tu clave sin procesar de la API de gestión.
​
string
requerido
El qrid del código QR, p. ej. QR7K9M2XN.
La ruta antigua /qrcode/{qrid}/download/ también sigue siendo accesible, por compatibilidad con versiones anteriores — misma vista, mismo comportamiento.

​
Parámetros de consulta

​
string
predeterminado:"png"
Formato de salida: png, jpg, jpeg, svg, pdf, eps o ps.
​
integer
predeterminado:"300"
Tamaño de la imagen en píxeles, de 10 a 2400.
​
boolean
predeterminado:"false"
Cuando es true, devuelve un PDF listo para imprimir generado localmente (no a través del servicio generador de imágenes) e ignora file.
​
string
Anulación opcional de la carga útil precodificada. Los códigos QR dinámicos no necesitan esto — existe para los códigos QR estáticos, ya que este backend no reproduce de forma independiente la lógica de codificación de datos del lado del cliente del frontend para los tipos estáticos.

​
Respuesta

Una solicitud exitosa devuelve la imagen como una descarga de archivo binario (Content-Disposition: attachment), con un nombre de archivo derivado del nombre del código QR (o su qrid si no tiene nombre).

​
Errores

​
Se devuelve cuando size está fuera del rango 10–2400, o file no es uno de los formatos admitidos.
​
El qrid no existe, o no pertenece a la cuenta a la que pertenece la clave.
​
El servicio ascendente generador de imágenes no está disponible. Esto no es un error del cliente — vuelve a intentarlo, y contacta con soporte si persiste.

​
Relacionado

Autorizaciones

​
Authorization
string
header
requerido

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.

Parámetros de ruta

​
qrid
string
requerido

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

Parámetros de consulta

​
size
integer
predeterminado:300

Output size in pixels, from 10 to 2400.

​
for_print
boolean
predeterminado:false

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

​
file
enum<string>

Output format.

Opciones disponibles:
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.

Respuesta

The rendered image, as a binary attachment.