Skip to main content
GET
Descarga una imagen renderizada de un código QR en el host de la API de gestión (management.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.
También accesible en /qr/{qrid}/download/ — 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 102400, 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: 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.

Parámetros de ruta

qrid
string
requerido

Respuesta

200

QR image binary