API Generador de Códigos QR

Genera imágenes de códigos QR agregando .qr.png a cualquier enlace corto de Linkly. No se requiere autenticación ni clave de 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

Agrega .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, estilo o logo del código QR en Linkly, esos estilos se aplican automáticamente.

Ejemplo

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

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

El quietZone agrega relleno de espacio en blanco alrededor de todo el código QR, rellenado con bgColor. Esto es útil cuando imprimes códigos QR en fondos oscuros — sin él, los ojos de posicionamiento quedan pegados al borde y es posible que no escaneen de forma confiable. Por ejemplo, quietZone=50&bgColor=%23ffffff agrega 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 cuando lo creas o actualices a través de la API de Acortamiento de Enlaces. Pasa un objeto JSON qr_styles con cualquiera de las claves de estilo enumeradas 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 solicitas la imagen .qr.png — no se necesitan parámetros de consulta.

Cómo se Aplican los Estilos

Los estilos del 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 realizado en el editor de códigos 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 hay un logo presente, Linkly utiliza automáticamente corrección de errores alta (Nivel H) para asegurar que el código QR siga siendo escaneable.

Límites de Velocidad

El endpoint está limitado a 5 solicitudes por segundo por dirección IP. Las imágenes se almacenan en caché durante 5 minutos, por lo que las solicitudes repetidas para el 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": "Límite de velocidad excedido"}

Recursos Relacionados

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