API Gerador de Código QR

Gere imagens de código QR anexando .qr.png a qualquer link curto Linkly. Nenhuma autenticação ou chave API necessária.

A imagem é retornada como PNG com todos os estilos de código QR salvos aplicados, incluindo cores personalizadas, padrões de pontos, estilos de olhos e logos.

Anexe .qr.png a qualquer link curto Linkly:

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

Isto retorna uma imagem PNG de 1024x1024 do código QR. Se você personalizou as cores, estilo ou logo do código QR no Linkly, esses estilos são aplicados automaticamente.

Incorpore um código QR em uma página HTML:

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

Ou use-o em um modelo de email, PDF ou qualquer sistema que suporte URLs de imagem.

Passe parâmetros de consulta para substituir os estilos QR salvos do link ou alterar o tamanho da imagem:

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

Nota: cores hex devem ser URL-codificadas — use %23 no lugar de # (por exemplo, %23ff0000 para #ff0000).

As dimensões do logo são dimensionadas automaticamente para corresponder ao tamanho da imagem solicitado.

O quietZone adiciona preenchimento de espaço em branco ao redor de todo o código QR, preenchido com bgColor. Isto é útil ao imprimir códigos QR em fundos escuros — sem ele, os olhos de posicionamento ficam encostados na borda e podem não digitalizar de forma confiável. Por exemplo, quietZone=50&bgColor=%23ffffff adiciona uma borda branca de 50 pixels.

Você pode salvar estilos de código QR para um link ao criá-lo ou atualizá-lo via API de Encurtamento de Links. Passe um objeto JSON qr_styles com qualquer uma das chaves de estilo listadas acima:

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

Uma vez salvos, esses estilos são aplicados automaticamente sempre que você solicita a imagem .qr.png — sem necessidade de parâmetros de consulta.

Os estilos de código QR são resolvidos na seguinte ordem:

1. 1Estilos padrão — Primeiro plano preto em fundo transparente, módulos quadrados, 1024px
2. 2Estilos salvos — Qualquer personalização que você fez no editor de código QR ou definiu via API de Links é armazenada com o link
3. 3Substituições de parâmetros de consulta — Substitua estilos individuais por solicitação via parâmetros de URL

Quando um logo está presente, o Linkly usa automaticamente correção de erro de alto nível (Nível H) para garantir que o código QR permaneça digitalizável.

O endpoint é limitado a 5 solicitações por segundo por endereço IP. As imagens são armazenadas em cache por 5 minutos, portanto, solicitações repetidas para o mesmo código QR são servidas rapidamente.

Uma solicitação bem-sucedida retorna status 200 com Content-Type: image/png e os dados da imagem PNG como corpo da resposta.

Respostas de erro retornam JSON:

{"error": "Rate limit exceeded"}

• Criar Códigos QR - Como criar e personalizar códigos QR no Linkly
• Adicionar um Logo a um Código QR - Crie códigos QR personalizados com seu logo da empresa
• Códigos QR em SVG - Baixe códigos QR em formato vetorial escalável
• API de Encurtamento de Links - Crie e gerencie links programaticamente
• API de Análise - Exporte dados de cliques e relatórios de tráfego