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, em todos os quatro downloads: SVG, PNG, PDF e EPS.
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 -X POST https://qr3.app/v1/codes/qr_a1b2c3d4/logo \ -H "Authorization: Bearer qr3_sk_..." \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
Todos os quatro formatos – qr.svg, qr.png, qr.pdf e qr.eps – incorporam os píxeis reais do logo de forma centrada, escalados para uma proporção fixa da área do código. Todos os quatro elevam a correção de erros para H para garantir que o código permanece legível.
Cache
Com um logo definido, todos os quatro formatos – qr.svg, qr.png, qr.pdf e
qr.eps – 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 com um dos quatro formatos atuais (
qr.svg,qr.png,qr.pdfouqr.eps) – nunca misturando ficheiros de impressão antigos e novos. - Substituir um logo não altera o padrão; uma nova impressão é então apenas uma questão da nova imagem desejada, não da legibilidade da leitura.
- Todos os quatro formatos contêm agora o logo de igual forma – qual o formato adequado para o seu próprio modelo de impressão é decidido unicamente pelo programa de paginação (vetor para PDF/EPS, raster para PNG, SVG para ambos).
- 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, e nunca misture ficheiros de versões diferentes.