API Generador de Códigos QR

Genera imágenes de código QR añadiendo .qr.png a cualquier enlace corto de Linkly. No se requiere autenticación ni clave API.

La imagen se devuelve como PNG con todos los estilos de código QR guardados aplicados, incluyendo colores personalizados, patrones de puntos, estilos de ojos y logos.

Uso básico

Añade .qr.png a cualquier enlace corto de Linkly:

https://linkly.link/2W6Z9.qr.png

Esto devuelve una imagen PNG de 1024x1024 del código QR. Si has personalizado los colores, estilos o logo del código QR en Linkly, esos estilos se aplican automáticamente.

Ejemplo

Incrusta un código QR en una página HTML:

<img src="https://linkly.link/2W6Z9.qr.png" alt="Código QR" />

O úsalo en una plantilla de correo electrónico, un PDF, o cualquier sistema que admita URLs de imágenes.

Parámetros de estilo

Pasa parámetros de consulta para anular los estilos QR guardados del enlace o cambiar el tamaño de la imagen:

https://linkly.link/2W6Z9.qr.png?qrStyle=dots&fgColor=%23009eff&size=2048

Nota: los colores hex deben estar codificados en URL — usa %23 en lugar de # (p. ej. %23ff0000 para #ff0000).

Las dimensiones del logo se escalan automáticamente para coincidir con el tamaño de imagen solicitado.

El quietZone añade espaciado en blanco alrededor de todo el código QR, rellenado con bgColor. Esto es útil cuando se imprimen códigos QR en fondos oscuros — sin él, los ojos de posicionamiento se sienta enrasados contra el borde y pueden no escanear de manera confiable. Por ejemplo, quietZone=50&bgColor=%23ffffff añade un borde blanco de 50 píxeles.

Configurar estilos a través de la API de enlaces

Puedes guardar estilos de código QR en un enlace al crearlo o actualizarlo a través de la API de Acortamiento de Enlaces. Pasa un objeto JSON qr_styles con cualquiera de las claves de estilo listadas arriba:

{
  "api_key": "your_api_key",
  "workspace_id": 1234,
  "url": "https://example.com",
  "qr_styles": {
    "fgColor": "#009eff",
    "bgColor": "#ffffff",
    "qrStyle": "dots",
    "eyeStyle": "rounded",
    "logoImage": "https://example.com/logo.png",
    "logoWidth": 60,
    "logoHeight": 60,
    "logoPadding": 10,
    "logoStyle": "circle",
    "quietZone": 50
  }
}

Una vez guardados, estos estilos se aplican automáticamente cada vez que solicites la imagen .qr.png — no se necesitan parámetros de consulta.

Cómo se aplican los estilos

Los estilos de código QR se resuelven en el siguiente orden:

1. 1
   Estilos predeterminados — Primer plano negro sobre fondo transparente, módulos cuadrados, 1024px
2. 2
   Estilos guardados — Cualquier personalización que hayas hecho en el editor de código QR o establecido a través de la API de Enlaces se almacena con el enlace
3. 3
   Anulaciones de parámetros de consulta — Anula estilos individuales por solicitud a través de parámetros de URL

Cuando está presente un logo, Linkly utiliza automáticamente corrección de error alta (Nivel H) para asegurar que el código QR permanezca escaneable.

Límites de velocidad

El endpoint tiene un límite de velocidad de 5 solicitudes por segundo por dirección IP. Las imágenes se cachean durante 5 minutos, por lo que las solicitudes repetidas del mismo código QR se sirven rápidamente.

Respuesta

Una solicitud exitosa devuelve un estado 200 con Content-Type: image/png y los datos de imagen PNG como cuerpo de respuesta.

Las respuestas de error devuelven JSON:

{"error": "Rate limit exceeded"}

Recursos relacionados

• Crear Códigos QR - Cómo crear y personalizar códigos QR en Linkly
• Añadir un Logo a un Código QR - Crea códigos QR de marca con tu logo de empresa
• Códigos QR SVG - Descarga códigos QR en formato vectorial escalable
• API de Acortamiento de Enlaces - Crea y gestiona enlaces programáticamente
• API de Analytics - Exporta datos de clics e informes de tráfico