API del Generador de Códigos QR

Genera imágenes de códigos 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.

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

https://your-domain.com/ABC123.qr.png

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

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

<img src="https://your-domain.com/ABC123.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.

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

https://your-domain.com/ABC123.qr.png?qrStyle=dots&fgColor=%23009eff&size=2048

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

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

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"
  }
}

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

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

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

Cuando hay un logo presente, Linkly utiliza automáticamente corrección de errores alta (Nivel H) para garantizar que el código QR siga siendo escaneable.

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

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

Las respuestas de error devuelven JSON:

{"error": "Rate limit exceeded"}

• 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 el logo de tu 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 Análisis - Exporta datos de clics e informes de tráfico