API Generador de Códigos QR

Genera imágenes de código QR añadiendo .qr.png a cualquier enlace acortado 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, incluidos colores personalizados, patrones de puntos, estilos de ojos y logos.

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

https://linkly.link/2W6Z9.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.

Incrustar 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 imagen.

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 # (por ejemplo, %23ff0000 para #ff0000).

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

El quietZone añade relleno de espacio en blanco alrededor de todo el código QR, rellenado con bgColor. Esto es útil al imprimir códigos QR sobre fondos oscuros — sin él, los ojos de posicionamiento quedan pegados al borde y pueden no escanear de manera confiable. Por ejemplo, quietZone=50&bgColor=%23ffffff añade un borde blanco de 50 píxeles.

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.

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

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

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

El endpoint está limitado a 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.

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 - Crear códigos QR de marca con tu logo de empresa
• Códigos QR SVG - Descargar códigos QR en formato vectorial escalable
• API de Acortamiento de Enlaces - Crear y gestionar enlaces programáticamente
• API de Analítica - Exportar datos de clics e informes de tráfico