API Gerador de Código QR

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

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

Uso básico

Anexe .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 logotipo 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, um 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 hexadecimais devem ser codificadas em URL — use %23 no lugar de # (por exemplo, %23ff0000 para #ff0000).

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

A quietZone adiciona preenchimento de espaço 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 com confiabilidade. Por exemplo, quietZone=50&bgColor=%23ffffff adiciona uma borda branca de 50 pixels.

Configurando estilos via a API de link

Você pode salvar estilos de código QR em um link ao criá-lo ou atualizá-lo via API de Encurtamento de Link. 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 — 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 — Primeiro plano preto em fundo transparente, módulos quadrados, 1024px
2. 2
   Estilos salvos — Todas as personalizações que você fez no editor de código QR ou definiu via Link API são armazenadas com o link
3. 3
   Substitui parâmetro de consulta — Substitua estilos individuais por solicitação via parâmetros de URL

Quando um logotipo está presente, 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.

Limites de taxa

O endpoint tem limite de taxa de 5 solicitações por segundo por endereço IP. As imagens são armazenadas em cache por 5 minutos, portanto, solicitações repetidas do mesmo código QR são servidas 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
• Adicione um Logotipo a um Código QR - Crie códigos QR marcados com seu logotipo de empresa
• Códigos QR em SVG - Baixe códigos QR em formato de vetor escalável
• API de Encurtamento de Link - Crie e gerencie links programaticamente
• API de Análise - Exporte dados de cliques e relatórios de tráfego