Gerar um Código QR (PNG, SVG, WebP ou GIF)

Painel
Documentação
API

gere instantaneamente um Código QR (PNG, SVG, WebP ou GIF) a partir de um URL, um texto, um wifi ou um contacto. Personalize as cores, integre o seu logótipo no centro e escolha entre módulos quadrados ou redondos

Porquê utilizar uma ferramenta de geração de QR codes?

Os QR codes são códigos de barras a duas dimensões que conseguem guardar informações legíveis por máquina. São habitualmente utilizados para codificar URL, textos, coordenadas geográficas, e muito mais. Uma ferramenta de geração de QR codes permite-lhe criar facilmente QR codes a partir de diferentes fontes de dados, facilitando assim a partilha de informações e o acesso rápido a recursos.

Características da ferramenta de geração de QR codes

Esta ferramenta recebe uma cadeia de texto (URL, conteúdo livre, dados estruturados) e produz o Código QR correspondente. Escolha o formato de saída entre PNG, SVG, WebP ou GIF, personalize as cores de primeiro plano e de fundo, e integre opcionalmente um logótipo no centro do código para os seus suportes de marca.

Como utilizar a ferramenta de geração de QR codes

Introduza a cadeia de texto a codificar e selecione o formato de saída pretendido (PNG, SVG, WebP ou GIF). Ajuste as cores de primeiro plano e de fundo através dos seletores dedicados, e envie opcionalmente um logótipo PNG, JPG ou WebP com menos de 2 MB para integrar no centro do código. Clique em «Gerar»: a ferramenta apresenta as duas variantes visuais lado a lado, módulos quadrados (QR clássico) e módulos redondos (visual moderno), para que escolha a que prefere.

Se o contraste entre as duas cores escolhidas for demasiado baixo ou invertido (clara sobre escura), surge um aviso: a legibilidade pelos leitores deixa de estar garantida.

Perguntas frequentes

Qual a quantidade máxima de texto que posso codificar?

A norma QR permite até cerca de 4 296 caracteres alfanuméricos ou 2 953 octetos brutos. Na prática, quanto maior a carga útil, mais denso é o QR e mais difícil se torna ler com um smartphone. Mantenha-se de preferência abaixo de algumas centenas de caracteres para conservar uma leitura fluida mesmo num ecrã de tamanho modesto.

Que formato de saída escolher: PNG, SVG, WebP ou GIF?

PNG é o formato versátil por defeito, perfeito para envio por e-mail e integração web clássica. SVG é vetorial: permanece nítido em qualquer tamanho, ideal para impressão em grande formato (cartaz, roll-up) ou estilização em CSS. WebP produz ficheiros ~25 % mais leves do que PNG com renderização equivalente, interessante para reduzir o peso das páginas. GIF mantém-se sobretudo útil para a retrocompatibilidade com sistemas antigos.

Posso personalizar as cores e adicionar um logótipo?

Sim. Os seletores de cor permitem definir livremente o primeiro plano (os módulos escuros) e o fundo. Pode ser integrado um logótipo PNG, JPG ou WebP (até 2 MB) no centro do QR: é automaticamente envolvido por um disco branco para uma integração limpa independentemente do seu fundo, e o nível de correção de erros é elevado para compensar a superfície ocupada. Para que o QR continue legível, mantenha um contraste forte, conserve o primeiro plano mais escuro do que o fundo (a maioria dos leitores não lê QR invertidos), e imprima ou apresente o código com uma dimensão mínima de cerca de 2 cm de lado.

Os meus dados são enviados a um serviço de terceiros?

Não. A geração é realizada pelo nosso servidor, sem chamada a um serviço externo e sem conservação após envio do resultado. O texto ou URL que codifica não sai da nossa infraestrutura e não é registado em claro nos logs aplicacionais.

É possível codificar um URL com parâmetros UTM?

Totalmente. Um URL com parâmetros como ?utm_source=cartaz&utm_medium=qr é codificado tal como está. Poderá depois acompanhar as visitas provenientes do QR no seu sistema de analytics. Tenha em conta que quanto mais longo o URL, mais denso será o QR.

Um QR code pode expirar ou ser revogado?

Não, por si só. Uma vez impresso, um QR code codifica um texto fixo e esse texto deixa de mudar. Se prevê modificar o destino posteriormente, codifique um URL curto que controla (o seu próprio redirecionador) em vez do URL final. Poderá então alterar o destino sem reimprimir o QR.

Como descodificar um QR code existente?

Utilize o nosso leitor de QR code: carregue a imagem do QR (JPEG, PNG, GIF, WebP ou BMP) e obtenha o seu conteúdo textual. É prático para verificar o que foi codificado antes da impressão, ou para descodificar um QR recebido como anexo sem usar o smartphone.

Exemplo de pedido

curl -X POST https://cdrn.fr/api/v1/tools/qr-code-encoder/execute \
  -H "Content-Type: application/json" \
  -d '{"data":"...","output_format":"png","module_style":"squares","foreground_color":"#000000","background_color":"#ffffff"}'

curl -X POST https://cdrn.fr/api/v1/tools/qr-code-encoder/execute \
  -F "data=..." \
  -F "output_format=png" \
  -F "module_style=squares" \
  -F "logo=@/path/to/file" \
  -F "foreground_color=#000000" \
  -F "background_color=#ffffff"

Esquema de entrada

Campo	Tipo	Obrigatório	Predefinição
`data`	string	✓	–
`output_format`	choice (png, svg, webp, gif)	✓	–
`module_style`	string (squares, dots, both)	–	`squares`
`logo`	file	–	–
`foreground_color`	string	–	`#000000`
`background_color`	string	–	`#ffffff`

esta ferramenta também aceita um ficheiro opcional - use Content-Type multipart/form-data para o enviar, caso contrário application/json basta

Pontos de acesso

GET https://cdrn.fr/api/v1/tools - lista todas as ferramentas disponíveis
GET https://cdrn.fr/api/v1/tools/qr-code-encoder - obtém o esquema desta ferramenta
POST https://cdrn.fr/api/v1/tools/qr-code-encoder/execute - executa esta ferramenta com um payload JSON