API do Gerador de Códigos QR

Gere imagens de códigos QR adicionando .qr.png a qualquer link curto do 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.

Adicione .qr.png a qualquer link curto do Linkly:

https://your-domain.com/ABC123.qr.png

Isso retorna uma imagem PNG de 1024x1024 do código QR. Se você personalizou as cores, o estilo ou o 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://your-domain.com/ABC123.qr.png" alt="Código QR" />

Ou use-o em um modelo de e-mail, um PDF ou qualquer sistema que suporte URLs de imagens.

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

https://your-domain.com/ABC123.qr.png?qrStyle=dots&fgColor=%23009eff&size=2048

Nota: cores hex devem ser codificadas na URL — use %23 no lugar de # (ex. %23ff0000 para #ff0000).

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

Você pode salvar estilos de código QR em um link ao criá-lo ou atualizá-lo via a 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"
  }
}

Uma vez salvos, esses estilos são aplicados automaticamente sempre que você solicitar a imagem .qr.png — nenhum parâmetro de consulta necessário.

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

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

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

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

Uma solicitação bem-sucedida retorna um 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 de marca com o logo da sua empresa
• Códigos QR 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