Crei un payload Code 128 e ne calcoli il checksum
Verifichi che un valore rientri nel Code 128 set B e ottenga i valori dei simboli che servono alla stampante: KIT-128 parte dal valore iniziale 104 e ha checksum 77. Ogni carattere non ammesso viene segnalato con la sua posizione. Gratis nel suo browser.
- Gratis
- Funziona nel suo browser
- Senza registrazione
- I suoi dati restano sul dispositivo
Esegui gratis nel browser
Esempio risolto
- Testo
- KIT-128
- Payload
- KIT-128
- Set di codici
- B
- Valore del simbolo iniziale
- 104
- Valore del simbolo di controllo
- 77
È utile per software di etichettatura, integrazioni con stampanti, test e diagnosi, poiché ogni carattere non compatibile produce un errore preciso.
Verifichi quali testi sono realmente ammessi
Code 128 è una famiglia di codifiche compatte, non la rappresentazione diretta di qualunque testo Unicode. Questo strumento usa intenzionalmente il set B, adatto agli identificativi comuni che contengono lettere, cifre, punteggiatura e spazi. Accetta i caratteri ASCII stampabili da U+0020, lo spazio, a U+007E, la tilde.
L’intervallo comprende lettere inglesi maiuscole e minuscole, cifre decimali e segni comuni. Tabulazioni, ritorni a capo, codici di controllo, lettere accentate, emoji e altri caratteri vengono rifiutati. La restrizione è esplicita perché sostituire o eliminare un carattere senza avviso cambierebbe l’identificativo e potrebbe associare l’etichetta al record sbagliato.
In caso di errore, la risposta indica l’indice a base zero e il punto di codice Unicode, consentendoLe di trovare subito il valore da correggere. Anche il testo vuoto non è valido e il limite massimo mantiene l’esecuzione sotto controllo. Per controlli, simboli FNC o i set A e C occorre un codificatore con un contratto più ampio.
Comprenda il calcolo dei simboli e del checksum
Nel set B ogni carattere ammesso diventa un simbolo sottraendo 32 dal codice ASCII. Lo spazio vale zero, la cifra zero vale 16, la A maiuscola vale 33 e la tilde vale 94. Il calcolo parte da 104 e somma ogni simbolo dati moltiplicato per la sua posizione, contando da uno.
Il primo ha peso uno, il secondo peso due e così via. Il renderer inserisce questo simbolo dopo i dati e prima del pattern di arresto; non è una cifra decimale da aggiungere al testo originale. I valori intermedi permettono di verificare ogni termine del calcolo.
Poiché l’algoritmo usa soltanto aritmetica intera, lo stesso input produce sempre lo stesso risultato.
Usi correttamente il risultato nelle etichette
La risposta è destinata a software che sappia già trasformare i simboli Code 128 in barre, comandi per stampante o asserzioni di test. Lo strumento non disegna SVG o PNG, non sceglie dimensioni, non aggiunge zone di quiete e non verifica la scansione di una stampa fisica; questi aspetti appartengono al rendering e al controllo qualità. Il pattern di arresto non compare nell’array perché è strutturale e non partecipa al checksum.
In un flusso automatico, esegua la convalida prima di inviare comandi alla stampante e conservi la risposta con l’artefatto. Nei test confronti valori ordinati e checksum. Senza rete, archiviazione, casualità o orologio, il risultato rimane stabile.
Casi d'uso
Preparare comandi per stampanti
Convalidi un identificativo di magazzino e ottenga i valori esatti del set B prima di comporre il comando della stampante.
Diagnosticare identificativi rifiutati
Individui un controllo, una lettera accentata o un altro punto incompatibile prima che raggiunga il flusso di etichettatura.
Domande frequenti
Quali caratteri sono supportati?
I caratteri ASCII stampabili dallo spazio (U+0020) alla tilde (U+007E), il repertorio adottato qui per il set B di Code 128.
Lo strumento genera un’immagine del barcode?
Barre, zone di quiete, dimensioni e formati spettano a un renderer.
Come si calcola il checksum del Code 128?
Si parte da 104, il valore iniziale del set B, e si somma ogni simbolo di dati moltiplicato per la sua posizione, contando da uno. Il totale si divide per 103 e si tiene il resto: per KIT-128 quel resto, cioè il checksum, è 77.
Devo aggiungere il checksum in fondo al mio testo?
No. Il checksum è un valore di simbolo che il generatore del codice mette dopo i dati e prima del motivo di arresto. Non è una cifra da scrivere in coda al testo originale, che resta esattamente come lo ha inserito.
Che cosa succede se il testo contiene un accento o un a capo?
Viene rifiutato con un messaggio preciso che indica la posizione del carattere, contando da zero, e il suo punto di codice Unicode. Nulla viene tolto o sostituito, perché cambiare un identificativo potrebbe mettere un'etichetta sul record sbagliato.
Strumenti correlati
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/enc/barcode-code128-payload \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"text":"KIT-128"}'const res = await fetch("https://api.kit.forhosting.com/enc/barcode-code128-payload", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"text": "KIT-128"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/enc/barcode-code128-payload",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"text": "KIT-128"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/enc/barcode-code128-payload", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"text":"KIT-128"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"text":"KIT-128"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/enc/barcode-code128-payload", 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
{
"text": "KIT-128"
}Esempio di risposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "enc.barcode_code128_payload",
"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_chars | 4096 |
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. |
Note tecniche
Questo generatore di payload Code 128 convalida il testo prima del rendering, converte ogni carattere ammesso nel relativo valore del set B e calcola il checksum obbligatorio modulo 103. La risposta comprende il payload invariato, il simbolo iniziale, i simboli dati ordinati e il checksum.
Comprenda il calcolo dei simboli e del checksum
L’array data_symbol_values conserva l’ordine ed esclude sia l’avvio sia il checksum, separando chiaramente i dati dagli elementi strutturali. start_symbol_value è 104, il valore standard di Start B. Il resto modulo 103 viene restituito in checksum_symbol_value.
Usi correttamente il risultato nelle etichette
Un renderer può emettere il simbolo iniziale, i valori di data_symbol_values, checksum_symbol_value e infine il pattern di arresto obbligatorio. Il campo payload resta invariato per collegare il calcolo alla fonte esatta. Il browser consente una verifica immediata, mentre l’API costa $0.002 per richiesta nelle integrazioni.
Casi di integrazione
Creare test di regressione
Generi array di simboli e checksum verificabili per confrontare un renderer Code 128 indipendente con valori deterministici.
Domande tecniche
Devo aggiungere il checksum al testo?
No. È un valore di simbolo Code 128 per il renderer, non un testo da accodare al payload originale.
Cosa accade con un emoji o un ritorno a capo?
La richiesta fallisce con invalid_input e identifica il primo carattere incompatibile tramite indice e punto di codice Unicode.
Quanto costa l’esecuzione via API?
Ogni richiesta API costa $0.002. Lo stesso calcolo deterministico può essere eseguito gratuitamente nel browser.