Capacidade e correção de erros QR

Ela abrange todas as versões padrão, de 1 a 40, e os níveis L, M, Q e H. Você pode comparar limites antes de gerar um símbolo, escolher um tamanho adequado ou entender por que o mesmo conteúdo cabe em um nível de correção, mas não em outro.

Escolha primeiro a versão e o nível de correção

A versão de um código QR define as dimensões do símbolo: a versão 1 começa com 21 por 21 módulos, e cada versão seguinte acrescenta quatro módulos de cada lado até a versão 40. Mais módulos oferecem mais espaço, mas o nível de correção de erros também reserva parte dele para dados de recuperação. O nível L deixa a maior capacidade para a carga útil, enquanto M, Q e H destinam progressivamente mais palavras-código à correção. Esta consulta usa essas duas escolhas como ponto de partida fixo e apresenta três limites úteis. Selecione uma versão inteira de 1 a 40 e uma das quatro letras padrão. O resultado inclui o nível normalizado, o total disponível de palavras-código de dados e os máximos de caracteres nos modos aceitos. A ferramenta não examina o conteúdo nem escolhe uma versão automaticamente. Essa separação torna a resposta previsível ao conferir uma especificação, validar outra biblioteca de QR ou comparar configurações antes da codificação. Uma versão ou um nível desconhecido é rejeitado, sem arredondamento nem substituição silenciosa.

Entenda por que o modo altera a capacidade

As três capacidades são diferentes porque os modos QR compactam caracteres com taxas de bits distintas. O modo numérico armazena dígitos em grupos compactos e, por isso, oferece a maior contagem de caracteres, mas aceita somente os algarismos de zero a nove. O modo alfanumérico usa o alfabeto restrito de 45 caracteres do padrão QR, que inclui letras maiúsculas, dígitos, espaços e alguns sinais. O modo byte armazena unidades de oito bits e serve como referência prática para texto geral ou dados binários, portanto seu máximo é menor. O cálculo começa nas palavras-código de dados disponíveis após a correção, subtrai o indicador de modo de quatro bits e o campo de contagem dependente da versão, e encontra a maior carga que cabe. O valor em byte conta bytes, não letras percebidas. Em UTF-8, caracteres acentuados, sistemas de escrita não latinos e emojis podem ocupar vários bytes. Um codificador real ainda pode alternar modos, adicionar um indicador ECI ou incluir metadados; quando o conteúdo estiver no limite, compare o fluxo exato de bits.

Use o resultado sem prometer uma leitura perfeita

A capacidade é um limite rígido de armazenamento para o modo, a versão e o nível escolhidos; ela não garante que um símbolo impresso ou exibido será lido com confiabilidade. O tamanho físico dos módulos, a zona livre, o contraste, o foco, a deformação da superfície, defeitos de impressão e as condições da câmera continuam importantes. Primeiro meça a carga na unidade correta e confirme que ela não supera o máximo retornado. Se superar, você pode escolher uma versão maior, reduzir o nível de correção quando o ambiente permitir, encurtar a carga ou adotar um modo aplicável mais denso. Se o conteúdo couber exatamente no limite, teste o codificador e os leitores usados em produção, pois cabeçalhos de modo ou segmentos extras podem alterar o orçamento final de bits. Uma correção maior é útil em etiquetas sujeitas a riscos ou obstrução, mas reduz a capacidade sem ampliar o símbolo e pode gerar módulos físicos menores em um tamanho de impressão fixo. Cada solicitação de API custa US$ 0,002 e produz um resultado determinístico, adequado para validações, documentação e verificações de build repetíveis.