Logo no QR Code

Um código pode conter um logo opcional no seu centro – a sua própria marca em vez de um simples padrão de QR Code. O logo é incorporado como píxeis reais nos downloads em SVG e PNG; os formatos PDF e EPS nunca o contêm.

No Dashboard

Abra a página de detalhes de um código. Ao lado da pré-visualização do QR Code e dos botões de download, encontra-se o cartão Logo no QR Code.

Clique em Selecionar logo e escolha um ficheiro PNG, JPEG ou WebP (no máximo 1 MB – formatos maiores ou diferentes, incluindo SVG, são rejeitados antes mesmo do carregamento).
Uma pré-visualização do ficheiro selecionado aparece juntamente com um aviso:
- Ainda sem logo definido – a adição altera o padrão de pontos do código. Marque a caixa de confirmação e clique em Carregar logo.
- Já existe um logo definido – a substituição apenas troca a imagem no centro, o padrão permanece o mesmo. Clique em Substituir logo; não é necessária confirmação.
Para remover, clique em Remover logo, confirme a caixa de aviso (a remoção também altera o padrão) e confirme a remoção uma segunda vez.

Via API

Carregar ou substituir logo

POST /v1/codes/{id}/logo – pedido multipart, campo file.

cURL

curl -X POST https://qr3.app/v1/codes/qr_a1b2c3d4/logo \
  -H "Authorization: Bearer qr3_sk_..." \
  -F "[email protected]"

Resposta (HTTP 201): o código atualizado, com o logo_file_id definido.

O ficheiro é verificado com base nos seus magic bytes, e não pela extensão ou pelo Content-Type. É normalizado para um PNG transparente com 512 × 512 px (mantendo a proporção). Um logo existente é substituído – existe sempre apenas um logo por código.

Remover logo

DELETE /v1/codes/{id}/logo – sem corpo (body).

curl -X DELETE https://qr3.app/v1/codes/qr_a1b2c3d4/logo \
  -H "Authorization: Bearer qr3_sk_..."

Resposta (HTTP 200): o código atualizado, com logo_file_id redefinido para null. Idempotente – uma chamada sem um logo existente continua a retornar 200 e não altera nada.

Erros

Estado	Quando
403	A função da chave de API é `viewer`
404	Código não encontrado no Workspace
413	O ficheiro é maior do que 1 MB
422	O campo `file` está em falta, ou formato diferente de PNG/JPEG/WebP (incluindo SVG)

O que muda no código

qr.svg e qr.png incorporam os píxeis reais do logo de forma centrada, escalados para uma proporção fixa da área do código. Ambos elevam a correção de erros para H para garantir que o código permanece legível. qr.pdf e qr.eps não são afetados pelo logo – nunca incorporam nenhum e mantêm o padrão que teriam mesmo sem o logo.

Cache

Com um logo definido, qr.svg/qr.png são servidos com Cache-Control: public, max-age=300 (5 minutos) em vez do habitual public, max-age=86400, immutable (24 horas). Assim, um URL de imagem incorporado noutro local – numa página, num e-mail, num documento – reflete a alteração do logo num prazo de até 5 minutos. Uma cópia que tenha sido armazenada em cache antes de o código ter tido um logo pode demorar até 24 horas completas, uma vez que foi guardada com o tempo de vida mais longo e imutável.

Impressão

Um código já impresso continua a funcionar, independentemente de um logo ser adicionado, substituído ou removido – o destino codificado nunca depende do logo.
Adicionar ou remover um logo altera o padrão de pontos. Se o próprio logo deve aparecer no material impresso, imprima novamente utilizando o qr.svg ou qr.png atual – nunca misture ficheiros de impressão antigos e novos.
Substituir um logo não altera o padrão; uma nova impressão é apenas uma questão de obter a nova imagem desejada, não afetando a legibilidade da leitura.
Os ficheiros qr.pdf e qr.eps nunca contêm um logo. Para modelos de impressão que devem mostrar o logo, descarregue o qr.svg ou qr.png.
Antes de uma tiragem de impressão completa, faça sempre uma leitura de teste no material real, especialmente após uma alteração no padrão.