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.
Esegui gratis nel browser
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.
Casi d'uso
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.
Domande frequenti
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.
Per sviluppatori — accesso via API
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.
Endpoint
Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.
Chiamala dal tuo stack
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"}'const res = await fetch("https://api.kit.forhosting.com/doc/qr-code-error-correction-capacity", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"version": 10,
"level": "Q"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/doc/qr-code-error-correction-capacity",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"version": 10,
"level": "Q"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/doc/qr-code-error-correction-capacity", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"version":10,"level":"Q"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"version":10,"level":"Q"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/doc/qr-code-error-correction-capacity", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Esempio di richiesta
{
"version": 10,
"level": "Q"
}Esempio di risposta
{
"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.
Prezzi
Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.
Limiti
max_mb | 25 |
max_pages | 200 |
Errori
| HTTP | Codice | Significato |
|---|---|---|
401 | unauthorized | Chiave API mancante o non valida: controlla l'header Authorization. |
402 | insufficient_balance | Credito esaurito: ricarica per continuare a eseguire attività. |
404 | unknown_type | Tipo di attività sconosciuto: controlla il campo type della richiesta. |
429 | rate_limited | Troppe richieste in poco tempo: rallenta e riprova tra qualche secondo. |