ForHosting KIT · Documenti e PDF

Capacità e correzione degli errori QR

Questo strumento di consultazione della capacità e della correzione degli errori dei codici QR restituisce il numero massimo di caratteri ammessi nei modi numerico, alfanumerico e byte per una versione e un livello specifici di QR Code Model 2.

● BetaGratis · nel tuo browser
Usalo da WebAPIEmailTelegramApp presto

Copre tutte le versioni standard da 1 a 40 e i livelli L, M, Q e H. Può usarlo per confrontare i limiti prima di generare un simbolo, scegliere una dimensione adatta o capire perché lo stesso contenuto entra con un livello di correzione ma non con un altro.

Scelga prima la versione e il livello di correzione

La versione di un codice QR definisce le dimensioni del simbolo: la versione 1 parte da 21 per 21 moduli e ogni versione successiva aggiunge quattro moduli per lato, fino alla versione 40. Più moduli offrono più spazio, ma il livello di correzione degli errori ne riserva una parte per i dati di recupero. Il livello L lascia la capacità utile maggiore, mentre M, Q e H destinano progressivamente più parole di codice alla correzione. Questo strumento considera fisse queste due scelte e restituisce tre limiti utili. Selezioni una versione intera da 1 a 40 e una delle quattro lettere standard. Il risultato comprende il livello normalizzato, il numero di parole di codice disponibili per i dati e il massimo di caratteri per ciascuna modalità supportata. Non analizza il contenuto e non sceglie automaticamente una versione. La risposta resta quindi prevedibile quando Lei verifica una specifica, convalida un’altra libreria QR o confronta più configurazioni prima della codifica. Una versione o un livello sconosciuti vengono rifiutati, senza arrotondamenti né sostituzioni silenziose.

Capisca perché la modalità cambia la capacità

Le tre capacità sono diverse perché le modalità QR comprimono i caratteri con densità di bit differenti. La modalità numerica memorizza le cifre in gruppi compatti e offre il numero più alto di caratteri, ma accetta soltanto le cifre da zero a nove. La modalità alfanumerica usa l’alfabeto limitato di 45 caratteri dello standard QR, composto da lettere maiuscole, cifre, spazi e pochi segni. La modalità byte memorizza unità di otto bit ed è il riferimento pratico per testo generico o dati binari, quindi ha un massimo inferiore. Il calcolo parte dalle parole di codice dati disponibili dopo la correzione, sottrae l’indicatore di modalità di quattro bit e il campo di conteggio dipendente dalla versione, quindi trova il carico massimo compatibile. Il valore byte conta byte, non lettere percepite. In UTF-8, caratteri accentati, scritture non latine ed emoji possono richiedere più byte. Un codificatore reale può anche alternare modalità, aggiungere un indicatore ECI o includere metadati: quando il contenuto è al limite, ne confronti l’esatto flusso di bit.

Usi il risultato senza promettere una lettura perfetta

La capacità è un limite rigido di memorizzazione per modalità, versione e livello selezionati; non garantisce che un simbolo stampato o visualizzato venga letto in modo affidabile. Le dimensioni fisiche dei moduli, la zona libera, il contrasto, la messa a fuoco, la deformazione della superficie, i difetti di stampa e le condizioni della fotocamera restano importanti. Misuri prima il carico nell’unità corretta e verifichi che non superi il massimo restituito. Se lo supera, può scegliere una versione maggiore, ridurre il livello di correzione quando l’ambiente lo consente, accorciare il carico o adottare una modalità applicabile più densa. Se entra esattamente al limite, provi il codificatore e i lettori usati in produzione, poiché intestazioni di modalità o segmenti aggiuntivi possono cambiare il budget finale di bit. Una correzione più elevata aiuta sulle etichette esposte a graffi o coperture, ma riduce la capacità senza ingrandire il simbolo e può produrre moduli fisici più piccoli a parità di stampa. Ogni richiesta API costa $0.002 e produce un risultato deterministico, adatto a convalide, documentazione e controlli di build ripetibili.

Convalidare i limiti del carico

Rifiuti i contenuti che non entrano nella versione, nel livello di correzione e nella modalità richiesti dalla specifica del prodotto.

Confrontare configurazioni QR

Valuti la variazione di capacità tra L, M, Q e H prima di scegliere le dimensioni del simbolo.

Documentare i vincoli di integrazione

Pubblichi limiti precisi per i modi numerico, alfanumerico e byte di un dispositivo, un’etichetta o un codificatore.

Quali versioni QR sono supportate?

Sono supportate tutte le versioni di QR Code Model 2, da 1 a 40.

Quali livelli di correzione degli errori posso usare?

Usi L, M, Q o H. Lo strumento rifiuta qualsiasi livello non riconosciuto.

La capacità in byte equivale al numero di caratteri?

Solo se ogni carattere occupa un byte. I caratteri UTF-8 possono richiederne diversi, quindi misuri la lunghezza codificata.

Perché una correzione maggiore riduce la capacità?

Più parole di codice vengono riservate alle informazioni di recupero e ne restano meno per il carico utile.

Il massimo comprende l’overhead della modalità?

Sì. Il calcolo considera l’indicatore di modalità di quattro bit e il campo di conteggio che dipende dalla versione.

Quanto costa una richiesta API?

Ogni richiesta API costa $0.002. Il calcolo è deterministico e non usa servizi esterni.

Tutto quello che vedi in questa pagina è disponibile anche via API. Questa sezione è per i team che vogliono integrarlo nei propri sistemi; chi non ne ha bisogno può semplicemente usare lo strumento qui sopra.

POSThttps://api.kit.forhosting.com/doc/qr-code-error-correction-capacity

Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.

curl -X POST https://api.kit.forhosting.com/doc/qr-code-error-correction-capacity \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"version":10,"level":"Q"}'
{
  "version": 10,
  "level": "Q"
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "doc.qr_code_error_correction_capacity",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

L'API è asincrona: ricevi subito un task_id e puoi fare polling fino a 1 richiesta al secondo.

per richiesta$0.002

Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.

max_mb25
max_pages200
HTTPCodiceSignificato
401unauthorizedChiave API mancante o non valida: controlla l'header Authorization.
402insufficient_balanceCredito esaurito: ricarica per continuare a eseguire attività.
404unknown_typeTipo di attività sconosciuto: controlla il campo type della richiesta.
429rate_limitedTroppe richieste in poco tempo: rallenta e riprova tra qualche secondo.

Leggi la documentazione completa del KIT →