API de Gerador de Código QR

Gere imagens de código QR adicionando .qr.png a qualquer link curto 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 olhos e logos.

Uso básico

Adicione .qr.png a qualquer link curto Linkly:

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

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

Exemplo

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

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

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

Parâmetros de estilo

Passe parâmetros de query para sobrescrever 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 automaticamente dimensionadas para corresponder ao tamanho da imagem solicitada.

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 flush contra a borda e podem não digitalizar 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 automaticamente aplicados sempre que você solicita a imagem .qr.png — nenhum parâmetro de query 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 — Qualquer personalização que você tenha feito no editor de código QR ou definido via API de Link são armazenadas com o link
3. 3
   Sobrescrita de parâmetros de query — Sobrescreva estilos individuais por solicitação via parâmetros de URL

Quando um logo está presente, o Linkly automaticamente usa 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 solicitações por segundo por endereço IP. As imagens são em cache por 5 minutos, então solicitações repetidas pelo 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
• Adicionar um Logo a um Código QR - Crie códigos QR de marca com seu logo da empresa
• Códigos QR 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