Codificatore Crockford Base32
«Hello» diventa 91JPRV3F in Crockford Base32, un alfabeto senza I, L, O né U, così numeri di serie e codici di assistenza resistono alla lettura al telefono e alla trascrizione a mano. Un simbolo di controllo facoltativo rileva un carattere digitato male. Gratis nel suo browser.
- Gratis
- Funziona nel suo browser
- Senza registrazione
- I suoi dati restano sul dispositivo
Esegui gratis nel browser
Esempio risolto
- Testo
- Hello
- Modalità di calcolo
- Encode
- Risultato
- 91JPRV3F
- Lunghezza
- 8
- Byte di input
- 5
- Alfabeto
- Crockford
Crockford Base32 è un alfabeto di codifica pratico pensato per chi legge e digita identificatori a mano. Elimina i simboli che creano più confusione—I, L, O e U—così un numero di serie, un token breve o un codice di assistenza resistono a client di posta, appunti cartacei e letture al telefono. Questo codificatore e decodificatore Crockford Base32 converte testo UTF-8 in quell’alfabeto e viceversa, accetta le tolleranze umane abituali (minuscole, trattini, O come zero, I e L come uno) e può aggiungere o verificare il simbolo di controllo opzionale modulo 37 di Crockford quando deve rilevare errori di trascrizione.
Cos’è Crockford Base32 e in cosa differisce dal Base32 di RFC 4648
Il Base32 standard (RFC 4648) usa A–Z e 2–7 con padding di segni di uguale. Quell’alfabeto va bene per formati di rete e MIME, ma è scomodo per le persone: la I maiuscola assomiglia all’uno, la O maiuscola allo zero e la U confonde i codici dettati a voce. L’alfabeto Base32 di Douglas Crockford conserva trentadue simboli—cifre da zero a nove più A–Z senza I, L, O e U—così ogni glifo restante è facile da stampare, leggere ad alta voce e digitare.
La decodifica è deliberatamente indulgente: i trattini possono separare gruppi per leggibilità, la maiuscola non conta, la lettera O è trattata come cifra zero e le lettere I e L come cifra uno. Non c’è padding con segni di uguale; i gruppi finali incompleti di cinque bit vengono comunque emessi come simbolo finale in codifica, in linea con le implementazioni Crockford comuni per stringhe corte.
Un simbolo di controllo opzionale da un insieme di trentasette simboli (i trentadue di dati più asterisco, tilde, dollaro, uguale e U) è il resto del valore della stringa di simboli modulo trentasette. Lo aggiunga quando le etichette verranno ridigitate; lo verifichi in decodifica quando check è true.
Dove un codificatore Crockford Base32 dà un vantaggio concreto
I team di prodotto e operations usano Crockford Base32 per identificatori pubblici brevi che l’assistenza deve leggere al telefono senza spellare I contro uno a ogni carattere. Magazzino e etichette di asset traggono vantaggio da gruppi con trattini e da un simbolo di controllo opzionale che intercetta una cifra digitata male prima di scegliere l’ubicazione sbagliata. Chi sviluppa token compatti in stile ULID o personalizzati vuole un codificatore con l’alfabeto Crockford atteso, non l’insieme 2–7 di RFC 4648, e un decodificatore che accetti collages disordinati da chat o PDF.
Esercizi di aula e colloqui sulle codifiche leggibili necessitano di un oracolo deterministico che rifiuti U nei dati e spieghi le mancate corrispondenze di controllo invece di restituire spazzatura.
Casi d'uso
Codici di assistenza e ticket leggibili
Codifichi riferimenti brevi così gli agenti li leggono ad alta voce senza confusioni I/L/O; decodifichi collages con trattini o minuscole.
Domande frequenti
Quale alfabeto usa Crockford Base32?
Cifre 0–9 e lettere A–Z escludendo I, L, O e U (trentadue simboli). La decodifica accetta minuscole, trattini, O come 0 e I/L come 1.
In cosa differisce dal Base32 di RFC 4648?
RFC 4648 usa A–Z e 2–7 con padding '='. Crockford elimina lettere ambigue, usa 0–9 e un altro insieme di lettere, omette il padding e offre un simbolo di controllo opzionale.
Cosa succede se invio un carattere non valido?
U non è valida nell’alfabeto dati (può comparire solo come simbolo di controllo).
A cosa serve il simbolo di controllo di Crockford?
È un carattere in più: il resto della divisione del valore del codice per 37, preso dai 32 simboli di dati più *, ~, $, = e U. Lo aggiunga alle etichette che qualcuno dovrà ridigitare; in decodifica con il controllo attivo, un ultimo carattere sbagliato fa fallire la decodifica.
Posso decodificare un codice con trattini o in minuscolo?
Sì. I trattini tra i gruppi vengono ignorati, maiuscole e minuscole sono indifferenti, la lettera O vale zero e le lettere I e L valgono uno, quindi un testo incollato da una chat o da un PDF si decodifica comunque. La lettera U viene rifiutata nei dati.
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/base32-crockford \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"text":"Hello"}'const res = await fetch("https://api.kit.forhosting.com/enc/base32-crockford", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"text": "Hello"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/enc/base32-crockford",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"text": "Hello"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/enc/base32-crockford", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"text":"Hello"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"text":"Hello"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/enc/base32-crockford", 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": "Hello"
}Esempio di risposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "enc.base32_crockford",
"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.
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
La stessa logica pura di parse alimenta lo strumento gratuito del browser e il percorso API a pagamento, così script didattici, etichette di magazzino e worker di produzione non divergono mai su un carattere. L’input malformato fallisce con invalid_input e un messaggio chiaro che indica il simbolo errato o la mancata corrispondenza del controllo, invece di una corruzione silenziosa.
Cos’è Crockford Base32 e in cosa differisce dal Base32 di RFC 4648
Questa capacità applica quel contratto orientato alle persone sul testo UTF-8 con impacchettamento di bit deterministico, così lo stesso input produce sempre la stessa stringa Crockford e la decodifica inversa ripristina i byte originali quando il payload è UTF-8 valido.
Contratto di ingresso, forma della risposta e comportamento in errore
Il testo vuoto codifica in un risultato vuoto. La lunghezza è limitata così i collages eccessivi falliscono presto. La validazione fallita non viene fatturata. Invii con POST un corpo JSON con il campo stringa obbligatorio text e gli opzionali mode e check. Mode è encode o decode e per impostazione predefinita encode; sono accettati gli alias op, operation e direction. Check è un booleano predefinito false; se true in codifica, l’API aggiunge il simbolo di controllo Crockford e lo restituisce come check_symbol; se true in decodifica, il carattere finale deve coincidere con il resto modulo trentasette altrimenti l’operazione fallisce con invalid_input. In caso di encode riuscito il corpo include mode, il text originale, result (la stringa Crockford), length, input_bytes, alphabet Crockford, riepilogo charset, flag check e etichetta standard. In caso di decode riuscito ottiene mode, text, result (stringa UTF-8), length, output_bytes, gli stessi metadati di alfabeto e, se check era richiesto, check_verified più il check_symbol superato. La decodifica senza check tratta l’intera stringa come dati dopo aver rimosso i trattini e applicato gli alias O/I/L; qualsiasi carattere fuori dall’alfabeto dati—compresa una U isolata nel payload—solleva invalid_input con posizione e carattere. Mode non valido o check non booleano falliscono pure con invalid_input.
Dove un codificatore Crockford Base32 dà un vantaggio concreto
Poiché l’implementazione è parse puro di livello A, ogni chiamata riuscita costa il prezzo base pubblicato $0.002 senza token di modello né rete in uscita. Mantenga payload modesti, fissi le stringhe result nei test automatici e ottiene Crockford Base32 riproducibile per etichette, codici di assistenza e worker edge senza montare una propria libreria di alfabeto.
Casi di integrazione
Etichette asset con simbolo di controllo opzionale
Stampi etichette Crockford con check=true così un solo errore di digitazione fallisce la verifica prima di spostare l’inventario nel posto sbagliato.
Pipeline di token e identificatori
Generi e verifichi payload Crockford Base32 in script e worker con la stessa logica pura dello strumento gratuito del browser.
Domande tecniche
Cosa fa l’opzione check?
In codifica, check=true aggiunge un simbolo di controllo modulo 37 dall’insieme di trentasette simboli. In decodifica, check=true richiede quel simbolo finale e rifiuta le mancate corrispondenze.
Quanto costa il codificatore Crockford Base32?
Lo strumento nel browser è gratuito. Le richieste API usano il saldo prepagato KIT a $0.002 per chiamata riuscita; l’input non valido non viene fatturato.