API Gerador de Código QR

Gere imagens de código QR adicionando .qr.png a qualquer link encurtado Linkly. Nenhuma autenticação ou chave de 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 olho e logos.

Uso Básico

Adicione .qr.png a qualquer link encurtado Linkly:

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

Isso 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.

Exemplo

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.

Parâmetros de Estilo

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 codificadas em URL — use %23 em vez de # (por exemplo, %23ff0000 para #ff0000).

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

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

Configurar Estilos via Link API

Você pode salvar estilos de código QR em um link ao criá-lo ou atualizá-lo via Link Shortening API. 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 automaticamente aplicados sempre que você solicita a imagem .qr.png — nenhum parâmetro de consulta necessário.

Como os Estilos são Aplicados

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

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

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

Limites de Taxa

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

Resposta

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

As respostas de erro retornam JSON:

{"error": "Rate limit exceeded"}

Recursos Relacionados

• 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 marcados com seu logo da empresa
• Códigos QR em SVG - Baixe códigos QR em formato vetorial escalável
• Link Shortening API - Crie e gerencie links de forma programática
• Analytics API - Exporte dados de cliques e relatórios de tráfego