Command Palette

Search for a command to run...

Gerador de código QR: como fazer códigos QR que realmente digitalizam (e nunca expiram)

Gerador de código QR: como fazer códigos QR que realmente digitalizam (e nunca expiram)

T
Toolz Team
|Jul 16, 2026|22 min ler

Parte da coleção QR e códigos de barras

O símbolo em si é padronizado como ISO/IEC 18004, que é de onde vêm os quatro níveis de correção de erros e os quarenta tamanhos de versão.

O primeiro código QR que EU já imprimi não funcionou Foi para um cliente & #39; s embalagem do produto - um link para um vídeo de configuração - ea equipe de design tinha feito parecer bonito: marca roxa em um cinza um pouco mais escuro, sem margem branca, dobrado ordenadamente em um canto em cerca de 12 mm quadrado Ele escaneou bem no monitor designer & #39; s. Na caixa impressa, sob iluminação do armazém, com um telefone Android de dois anos de idade, escaneou aproximadamente nunca. Nós reimprimimos 4.000 caixas.

Esse erro me ensinou mais sobre códigos QR do que qualquer documentação fazia Um código QR não é um logotipo; é um formato de dados com requisitos físicos Contraste, zona silenciosa, tamanho do módulo e correção de erros não são preferências estéticas - eles são a diferença entre um código que lê em 200 milissegundos e um código que faz um cliente desistir Eu construo [Toolz.dev] (/, então quando EU precisava de um gerador QR em que EU pudesse confiar, EU escrevi o codificador sozinho em vez de incorporar um widget de terceiros, e enviei-o como o Gerador de código QR.

tl;dr: Um código QR armazena dados diretamente na imagem, portanto, um estático O código nunca expira. A maioria dos geradores online gratuitos oferecem um dinâmico código que aponta secretamente para o seu link curto - que eles podem desativar, medir ou monetizar mais tarde. O Gerador de código QR Codifica URLs, Wi-Fi, vCards, e-mail, SMS e números de telefone inteiramente em seu navegador, em qualquer um dos quatro níveis de correção de erros e exporta SVG para impressão e PNG para telas. Nada é carregado, nada expira e não há conta.

O que é um código QR, realmente?

Um código QR é um código de barras bidimensional que armazena bytes em uma grade de quadrados pretos e brancos chamados módulos, Ele foi projetado por Denso Wave em 1994 para rastrear peças de automóveis, padronizado como ISO/IEC 18004, e é genuinamente livre de royalties - a patente existe, mas Denso Wave optou por não aplicá-la, razão pela qual os códigos QR aparecem em tudo, desde menus de restaurantes até sistemas de pagamento do banco central.

A estrutura é mais organizada do que parece. Os três grandes quadrados nos cantos são Padrões de Localizador, e eles são o que um scanner localiza primeiro para descobrir onde está o código e como ele é girado. As linhas pontilhadas que correm entre eles são Padrões de temporização, que informam ao scanner a largura de um módulo. Os quadrados menores espalhados pelo corpo são padrões de alinhamento, usado para corrigir a perspectiva quando você fotografa o código em um ângulo. Todo o resto são dados, bytes de correção de erros ou informações de formato que descrevem qual nível de correção de erros e padrão de máscara foram usados.

Essa última peça - mascaramento - é a parte que a maioria das pessoas nunca ouve falar Dados codificados brutos geralmente produzem grandes áreas em branco ou padrões que se parecem com quadrados de localizador, e ambos confundem os scanners Então o codificador XORs a região de dados contra um dos oito padrões de máscara geométrica, pontua cada resultado contra quatro regras de penalidade da especificação, e mantém o de menor pontuação É uma pequena otimização que silenciosamente faz a diferença entre um código que varre instantaneamente e um que caça Qualquer gerador que valha a pena usar faz isso; o Gerador de código QR Implementa todas as oito máscaras com pontuação adequada, exatamente como o padrão descreve.

A conclusão prática: um código QR é uma estrutura de dados independente. A informação vive dentro da imagem. Depois de impresso, nenhum servidor na Terra está envolvido na decodificação.

Qual é a diferença entre códigos QR estáticos e dinâmicos?

Esta é a coisa mais importante a ser entendida antes de usar qualquer gerador de QR gratuito, e quase nenhum deles explica isso.

um Código QR estático Codifica seus dados diretamente. Se você codificar https://toolz.dev/tools/qr-generator, os módulos literalmente soletram esse url. Um scanner lê os bytes e abre o link. Não há intermediário, nem conta e nenhuma maneira de ninguém desligá-lo. Funciona em 2026 e funcionará em 2046.

um Código QR dinâmico codifica um link curto pertencente ao gerador - algo como https://qr-svc.example/x7Kp2 - que redirecciona para o seu destino real O pitch é que você pode alterar o destino mais tarde e ver a análise de digitalização O problema é que o seu código impresso agora depende permanentemente de um terceiro & #39; s servidor ficar online, ficar livre, e permanecer no negócio Muitas pessoas descobriram isso da maneira mais difícil: o & quot; free" código que eles imprimiram em 10.000 folhetos começa a mostrar um & quot; sua avaliação expirou, atualize para reativar" página, e a única correção é uma reimpressão Esse modelo de negócios existe especificamente porque seu código é refém.

Veja como os dois se comparam sobre as coisas que realmente importam:

Código QR estático Código QR dinâmico
Onde os dados moram dentro da imagem No servidor do provedor
expira nunca Quando o provedor diz isso
Destino editável após a impressão não sim
Análise de digitalização nenhum Sim, através do provedor
requer uma conta não quase sempre
privacidade O scanner vê apenas seu url O provedor registra cada varredura
densidade de código Depende do comprimento da carga útil Sempre curto (o link curto)
Funciona se o provedor desaparecer sim não

Os códigos dinâmicos têm uma vantagem legítima: para uma campanha física em que o destino pode mudar genuinamente, a edição vale algo. Mas você deve obter isso de um redirecionamento você controle - um caminho curto em seu próprio domínio que você pode repoint à vontade - não de um serviço gratuito que pode mantê-lo resgate Codificar yoursite.com/go/menu Como um código estático, e você tem editabilidade e independência ao mesmo tempo.

Tudo produzido pelo Gerador de código QR é estático, por design. Não há servidor no loop para expirar nada.

Como faço um código QR que digitalize de forma confiável?

Cinco coisas determinam se um código é lido na primeira tentativa. Na ordem grosseira de quantas vezes eles são maltratados:

contraste. Os módulos escuros devem ser genuinamente escuros contra um fundo genuinamente claro Os scanners binarizam a imagem antes da decodificação - cada pixel se torna preto ou branco - e os pares de cores de baixo contraste pousam ambiguamente Marinha escura no branco é segura Cinza médio no cinza claro não Se você precisar marcar o código, mande o sombrio módulos e manter o fundo branco ou quase branco.

Não inverta. Os módulos de luz em um fundo escuro funcionam em cerca de 70% dos aplicativos do scanner e falham no resto, porque muitos decodificadores assumem luz-a-luz e nunca tentam o inverso. Parece ótimo em uma maquete de modo escuro e decepciona no mundo real.

Zona tranquila. A especificação requer uma margem leve de quatro módulos em todos os lados. Isso não é decoração; é como o scanner distingue o código da obra de arte ao redor. Corte-o bem contra uma foto ou um painel colorido e as taxas de detecção caem de um penhasco. o Gerador de código QR O padrão é uma margem de quatro módulos e permite que você a amplie.

Tamanho físico. A regra geral da indústria é que a largura do código deve ser de pelo menos um décimo da distância de varredura pretendida. Digitalizar a partir de 30 cm (um menu em uma mesa) significa pelo menos 3 cm de código. Um cartaz lido de 3 metros precisa de 30 cm. Abaixo de aproximadamente 2 cm, os módulos de câmera baratos e baratos lutam, independentemente de quão bom seja seu codificador.

Comprimento da carga útil. Cada caractere extra adiciona módulos Um URL de 30 caracteres pode produzir uma grade de 29×29; um balões de 300 caracteres para 69×69, e cada módulo fica minúsculo no mesmo tamanho físico Encurtar seus URLs Tirar os parâmetros UTM, ou movê-los atrás de um redirecionamento Esta é a mais barata vitória de confiabilidade disponível, e é livre - use o Slug Gerador Para manter o caminho do URL curto e limpo.

Teste em pelo menos três telefones, incluindo um Android barato e barato, antes de se comprometer a imprimir. Os testes de tela não são testes de impressão.

Qual nível de correção de erros devo escolher?

Os códigos QR carregam bytes de correção de erros Reed-Solomon, que permitem que um scanner reconstrua a carga útil mesmo quando parte do código é ilegível - manchado, rasgado, ofuscado ou coberto. Você escolhe quanta redundância incluir:

nivelar recupera cerca de bom para
L (baixa) 7% Limpar o display digital, dados máximos em módulos mínimos
m (médio) 15% O padrão sensato: telas e impressão limpa
Q (quartil) 25% Industrial, ao ar livre, curvo ou letras pequenas
H (alto) 30% Códigos com um logotipo no topo ou ambientes agressivos

O trade-off é densidade Bytes redundantes ocupam espaço, então em uma carga fixa, o nível H precisa de mais módulos do que o nível L - o que significa um código impresso maior ou módulos menores. Enrolar cada código para H & quot; para safety" pode sair pela culatra: você acaba com um código mais denso que é mais difícil Para digitalizar no mesmo tamanho físico.

O único caso em que H não é negociável é um logotipo no meio. Esse truque funciona precisamente porque a correção de erros pode reconstruir os módulos que seu logotipo cobre. Mantenha o logotipo centralizado, mantenha-o em aproximadamente 25 a 30% da área de código e nunca deixe que ele toque nos padrões do localizador nos cantos. Exporte o SVG do Gerador de código QR no nível H, coloque seu logotipo em cima em uma ferramenta de design e, em seguida - esta parte é obrigatória - digitalize o composto com vários telefones antes de enviá-lo.

O que você pode codificar além de um URL?

Um código QR contém bytes e as câmeras do telefone reconhecem vários formatos de texto convencionais e agem sobre eles. Os formatos são simples; o escape é onde as pessoas tropeçam.

Credenciais de Wi-Fi. a carga parece WIFI:T:WPA;S:MyNetwork;P:mypassword;;. Digitalize-o e o telefone se oferece para entrar na rede - não digite uma senha de 24 caracteres em voz alta para um convidado O gotcha está escapando: se o seu SSID ou senha contém ponto e vírgula, vírgula, dois pontos, citação ou barra invertida, esses caracteres devem ser escapados na barra invertida ou a carga útil analisa errado e a junção falha silenciosamente Gerador de código QR Lida com essa fuga automaticamente, o que é mais do que pode ser dito para muitos geradores que apenas concatenam sua entrada.

Cartões de contato. uma carga vcard (várrico) (BEGIN:VCARD … END:VCARD) coloca o seu nome, empresa, telefone, e-mail e site em um código, e uma digitalização oferece para salvar o contato É a coisa mais próxima de um cartão de visita que ainda faz sentido, e ao contrário de um & quot; smart" cartão NFC não há conta de fornecedor por trás dele vCards executar por muito tempo, então espere um código mais denso - imprimi-lo maior do que você pensa.

E-mail, SMS e telefone. mailto:, SMSTO:, e tel: Cargas úteis preenchem uma mensagem ou disque um número. Útil para suportes e sinalização de eventos, onde você deseja remover o atrito de digitar um endereço corretamente.

texto simples. Números de série, códigos de cupom, tags de ativos, instruções de convidados WiFi, uma nota curta Nenhum esquema, nenhuma ação - o telefone apenas mostra o texto.

Se você estiver codificando seus próprios dados estruturados, lembre-se de que o codificador grava bytes UTF-8, então caracteres acentuados, scripts não latinos e emojis sobrevivem intactos. Eles custam mais bytes do que ASCII: um emoji é de quatro bytes, onde uma letra é uma. Se você está curioso para saber como funciona esse Byte Math, o tradutor binário Mostra a codificação UTF-8 de qualquer string diretamente.

Devo exportar SVG ou PNG?

usar VG para qualquer coisa que seja impressa. É um vetor: os módulos são descritos como formas, não pixels, então o código permanece perfeitamente nítido, quer pousar em um cartão de visita ou em um ônibus. As impressoras preferem, os designers podem soltar um logotipo e nunca mostrar o desfoque suave que mata a confiabilidade da digitalização quando um raster de baixa resolução é ampliado.

usar png para telas - sites, decks de slides, e-mails, documentação Exporte em um tamanho generoso (512 px ou mais) e deixe o layout reduzi-lo; um código que é upsampled de 128 px terá bordas de módulo difusas, e bordas difusas são exatamente o que os scanners lutam para binarizar.

Um detalhe de renderização é importante em ambos os formatos: desligue o anti-aliasing ou a suavização de imagem, se tiver a opção. Módulos quadrados e afiados decodificam melhor do que os de mistura suave. O VSG Gerador de código QR emite conjuntos shape-rendering="crispEdges" Por esse motivo, e sua exportação PNG desativa a suavização de imagens de tela.

Quantos dados cabem em um código QR?

O máximo teórico no modo byte é de 2.953 bytes na versão 40 com nível de correção de erros L - cerca de 2.900 caracteres de ASCII simples. Você quase nunca vai querer chegar perto disso.

Os códigos QR vêm em 40 versões, de 21×21 módulos (versão 1) até 177×177 (versão 40), crescendo em 4 módulos por lado cada passo A versão é escolhida automaticamente a partir do seu comprimento de carga útil e nível de correção de erros; você nunca escolhe diretamente O que você sente é a consequência: uma URL de 20 caracteres no nível M pousa na versão 2 ou 3 - uma grade robusta e indulgente que varre uma sala Uma carga útil de 500 caracteres no nível H pousa em algum lugar nos anos vinte, produzindo um matagal denso de módulos que precisa de excelente qualidade de impressão e uma câmera próxima e constante.

Portanto, o teto prático não é de 2.953 bytes; no entanto, muitos dados ainda deixam módulos grandes o suficiente para fotografar à distância pretendida. Minha regra de trabalho: manter cargas úteis de URL abaixo de 100 caracteres e, se um vCard ultrapassar 300, imprima-o com pelo menos 4 cm de largura. o Gerador de código QR Mostra a versão escolhida, a contagem de módulos e quão completo o código é como uma porcentagem, para que você possa observar a densidade subir enquanto digita e corta a carga antes que se torne um problema.

Por que um código QR não consegue digitalizar?

Quando alguém me diz um código "não funciona", quase sempre é um deles, nesta ordem:

  1. Nenhuma zona tranquila. O código foi cortado em contraste com obras de arte ou um fundo colorido.
  2. Contraste ou inversão ruim. Cores da marca escolhidas para a aparência ou um esquema claro no escuro.
  3. Impresso muito pequeno Para a distância, as pessoas estão realmente de pé.
  4. densidade muito alta - um URL longo com parâmetros de rastreamento ou um vCard sobrecarregado.
  5. brilho ou curvatura - menus e frascos laminados refletem a luz diretamente na lente Acabamentos foscos e maior ajuda na correção de erros.
  6. Um logotipo que comeu o padrão do localizador. Os cantos não são negociáveis.

Observe que nenhum deles é "O codificador produziu um código inválido". A geração é um problema resolvido; as falhas são físicas. É por isso que o teste em hardware real, em tamanho real, sob iluminação real, vale mais do que qualquer cuidado no gerador.

É seguro usar um gerador de QR online gratuito?

Depende inteiramente do que você está codificando e onde a codificação acontece.

Pense no que acontece em um código QR WiFi: seu nome de rede e sua senha, em texto simples. Se o gerador enviar isso para um servidor para renderizar a imagem, você acabou de enviar sua senha do WiFi para um estranho. O mesmo se aplica a um vCard com um número de telefone pessoal ou a um URL para um documento interno não listado. A maioria dos sites QR gratuitos faz o lado do servidor de codificação, e suas políticas de privacidade são geralmente vagas quanto à retenção.

o Gerador de código QR executa todo o codificador - conversão UTF-8, correção de erros Reed-Solomon, seleção de máscara, renderização - em JavaScript no seu navegador Não há upload, nenhuma solicitação, nada para registrar Abra a guia de rede e assista: depois que a página carrega, gerar um código faz zero solicitações Carregue a página uma vez e você pode puxar o cabo de rede e ainda funciona Esse é o mesmo princípio por trás de cada ferramenta no site, e é todo o argumento em Por que as ferramentas baseadas em navegador são mais seguras do que as baseadas em upload.

A segunda questão de segurança segue a outra direção: como um varredor, tratar códigos QR como links de estranhos, porque é isso que eles são. "Quishing" - códigos maliciosos presos sobre os legítimos em parquímetros, mesas de restaurante e carregadores EV - agora é comum o suficiente para que a FTC emitiu avisos do consumidor sobre isso Verifique o URL que seu telefone visualiza antes de tocar, e desconfie de qualquer código que leva direto a um login ou formulário de pagamento.

Casos de uso comuns

Menus de restaurantes e locais. Código estático, nível M, impresso em 3 a 4 cm em um cartão fosco. Aponte para uma página que você controla, não para um URL do serviço de hospedagem de menus que pode mudar.

Wi-Fi para hóspedes e escritórios. Imprima o código WiFi em um pequeno cartão perto da porta Gire a senha e reimprima - leva dois minutos e significa que você nunca mais diz uma senha em voz alta.

Emblemas de conferência e cartões de visita. As cargas úteis do VCard no nível Q ou H. As pessoas escaneiam o selo e o contato chega em seu telefone sem digitação e sem aplicativo.

Embalagem de produtos e manuais. Link para vídeos de configuração, registro de garantia ou documentação É aqui que a confiabilidade é mais importante porque a reimpressão é cara - vá para o nível Q, deixe uma zona de silêncio generosa e teste em telefones antigos.

Ferramentas internas. Etiquetas de ativos, etiquetas de rack de servidor, links de runbook de implantação. Texto simples ou um pequeno URL interno, impresso em uma etiqueta. Barato, permanente e nenhum fornecedor envolvido.

Bilhetes para eventos e check-in. Codifique um ID opaco, não dados pessoais. O código deve ser uma chave que seu sistema procura, não uma carga útil que vaza um nome e um e-mail para qualquer pessoa que o digitalize na mão de alguém.

Se você está montando um kit geral de ferramentas baseadas em navegador para trabalhar assim, eu escrevi aquelas em que mantenho fixadas O kit de ferramentas do desenvolvedor web - o gerador QR fica ao lado do gerador de uuid e o Gerador de meta tags na mesma rotação diária.

FAQ

Os códigos QR expiram?

Os códigos QR estáticos nunca expiram Os dados são codificados diretamente na imagem, portanto, não há nenhum servidor no loop que possa parar de responder Os códigos QR dinâmicos - o tipo que a maioria dos geradores gratuitos produz - codificam um link curto de propriedade do provedor, e aqueles podem e param de funcionar quando um teste termina ou uma empresa desliga Cada código do Gerador de código QR é estático.

Que nível de correção de erros devo usar para um código QR impresso?

O nível M é o padrão correto para impressão e telas limpas. Mova-se para Q para obter letras pequenas, superfícies curvas, exposição externa ou qualquer coisa que possa ser arranhada. Use H somente quando estiver colocando um logotipo sobre o centro do código, pois a redundância extra é o que permite que os módulos cobertos sejam reconstruídos. Níveis mais altos tornam o código mais denso, portanto, não aumente o nível sem dar mais espaço físico ao código.

Como faço para criar um código QR WiFi?

Escolha a predefinição WiFi, insira o nome da rede (SSID) e a senha e escolha o tipo de segurança - WPA/WPA2 para quase todas as redes modernas. A ferramenta constrói o padrão WIFI: Payload e escapa qualquer ponto e vírgula, vírgulas ou cotações em suas credenciais, onde geralmente as cargas feitas à mão são quebradas. Os hóspedes apontam sua câmera para ela e recebem um prompt para entrar na rede sem digitar nada.

Posso colocar um logotipo no meio de um código QR?

Sim, se você gerar no nível de correção de erros H e manter o logotipo centralizado e em aproximadamente 25 a 30% da área do código. Nunca deixe que ele se sobreponha aos três quadrados do localizador nos cantos, pois é isso que o scanner usa para localizar o código. Exporte o SVG, compile seu logotipo em uma ferramenta de design e teste o resultado em vários telefones diferentes antes de imprimir qualquer coisa.

Quantos dados um código QR pode conter?

O máximo é de 2.953 bytes no modo byte no nível de correção de erros L, que é de cerca de 2.900 caracteres ASCII. Na prática, você deseja muito menos: cargas mais longas produzem mais módulos e mais módulos significam que cada um é fisicamente menor com o mesmo tamanho de impressão, o que torna o código mais difícil de digitalizar à distância. Manter os URLs com cerca de 100 caracteres mantém o código confortavelmente legível.

Por que não digitalizará meu código QR?

As causas usuais são físicas, não técnicas: muito pouco contraste entre os módulos escuro e claro, um esquema de cores claro sobre escuro invertido, uma zona silenciosa ausente ou cortada (a margem de luz de quatro módulos), impressão muito pequena para a distância de onde as pessoas escaneiam ou uma carga útil tão longa que os módulos ficaram minúsculos. Corrija-os nessa ordem - eles representam quase todas as varreduras com falha que já depurei.

É SVG ou PNG para códigos QR?

SVG é melhor para qualquer coisa impressa, porque é um vetor e permanece perfeitamente afiado em qualquer tamanho, de um cartão de visita a um outdoor PNG é mais conveniente para telas - sites, slide decks, e-mail - onde uma imagem de pixel fixo é mais fácil de exportar o PNG em um tamanho generoso e reduzi-lo em vez de subir, uma vez que upscaling borra as bordas do módulo que os scanners dependem.

Os códigos QR são gratuitos para uso comercial?

Sim. O padrão QR Code é publicado como ISO/IEC 18004 e é livre de royalties na prática - Denso Wave detém a patente original, mas nunca a aplicou, e é exatamente por isso que o formato se tornou universal Os códigos gerados aqui não carregam marca d'água, nenhum requisito de atribuição e nenhum limite de uso, para que você possa colocá-los em produtos, embalagens, menus e publicidade livremente.

Minha senha do WiFi é carregada quando gero o código?

Não. Todo o codificador é executado em JavaScript no seu navegador - conversão UTF-8, correção de erros Reed-Solomon, seleção de máscara e renderização, tudo acontece localmente. Nada é transmitido para um servidor, nada é registrado e, uma vez carregada a página, a ferramenta continua trabalhando com a rede desconectada. Isso é mais importante para códigos WiFi e vCard, que contêm credenciais e dados pessoais em texto simples.


Comments

0 comments

0/2000 characters

No comments yet. Be the first to share your thoughts!