Documentación QR API

Bienvenido a la documentación oficial de LosPerris QR API. Genera códigos QR personalizados dinámicamente para tus aplicaciones, correos o sitios web de forma sencilla.

Generar QR

Tip: usa el endpoint con width 500 e image/jpeg para mejor compresión.

Genera una imagen QR (PNG, JPG o WEBP) directamente desde una URL. No devuelve JSON, sino el archivo de imagen (blob).

GET /api/qr/generate

Parámetros

Parámetro	Tipo	Descripción
`text`	String	(Requerido) El contenido o URL del QR.
`width`	Number	Tamaño de la imagen en px (Default: 300).
`type`	String	Formato: `png`, `jpg`, `webp`.
`darkColor`	Hex	Color de los puntos (ej. #000000).
`lightColor`, `dotStyle`	String	Opciones de estilo adicionales.

Ejemplos de Uso

                        curl -X POST /api/qr/generate \
  -H "Content-Type: application/json" \
  -d '{ "text": "https://google.com", "width": 500 }' \
  --output qr.png
                    

                        const response = await fetch('/api/qr/generate', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({ text: 'Hola Mundo', width: 500 })
});
const blob = await response.blob();
// document.getElementById('img').src = URL.createObjectURL(blob);
                    

                        import requests

res = requests.post("/api/qr/generate", 
    json={"text": "Hola", "width": 500})

with open("qr.png", "wb") as f:
    f.write(res.content)
                    

Respuesta

La API retorna directamente el archivo de imagen (Binary Blob) con Content-Type image/png (u otro formato solicitado).

Códigos de Error

Código	Significado	Descripción
400	Bad Request	Falta el parámetro `text` o es demasiado largo.
500	Server Error	Error interno al generar el gráfico.