ForHosting KIT · Utilidades de desarrollo

Codificador Crockford Base32

«Hello» se convierte en 91JPRV3F con Crockford Base32, un alfabeto sin I, L, O ni U, para que números de serie y códigos de soporte resistan el dictado por teléfono y la copia a mano. Un símbolo de control opcional detecta un carácter mal tecleado. Gratis en su navegador.

  • Gratis
  • Funciona en su navegador
  • Sin registro
  • Sus datos no salen de su equipo
Úselo desde WebAPIEmailTelegramApp pronto
Si escribe
Texto
Hello
Modo de cálculo
Encode
Obtiene
Resultado
91JPRV3F
Longitud
8
Bytes de entrada
5
Alfabeto
Crockford

Crockford Base32 es un alfabeto de codificación práctico pensado para quienes leen y escriben identificadores a mano. Elimina los símbolos que más confunden—I, L, O y U—para que un número de serie, un token corto o un código de soporte resistan clientes de correo, notas en papel y lecturas por teléfono. Este codificador y decodificador Crockford Base32 convierte texto UTF-8 a ese alfabeto y al revés, acepta las tolerancias habituales (minúsculas, guiones, O como cero, I y L como uno) y puede añadir o verificar el símbolo de control opcional módulo 37 de Crockford cuando necesite detectar errores de transcripción.

Qué es Crockford Base32 y en qué se diferencia del Base32 de RFC 4648

El Base32 estándar (RFC 4648) usa A–Z y 2–7 con relleno de signos igual. Ese alfabeto sirve para formatos de red y MIME, pero es incómodo para personas: la I mayúscula se confunde con el uno, la O mayúscula con el cero, y la U ensucia códigos dictados en voz alta.

El alfabeto Base32 de Douglas Crockford conserva treinta y dos símbolos—dígitos del cero al nueve más A a Z sin I, L, O ni U—de modo que cada glifo restante es fácil de imprimir, leer en voz alta y teclear. La decodificación es deliberadamente indulgente: los guiones pueden separar grupos para legibilidad, no importa mayúsculas o minúsculas, la letra O se trata como dígito cero, y las letras I y L como dígito uno.

No hay relleno con signos igual; los grupos de cinco bits incompletos al final se emiten igual como símbolo final al codificar, alineado con implementaciones Crockford habituales para cadenas cortas. Un símbolo de control opcional de un conjunto de treinta y siete símbolos (los treinta y dos de datos más asterisco, tilde, dólar, igual y U) es el resto del valor de la cadena de símbolos módulo treinta y siete. Añádalo cuando las etiquetas se reescriban a mano; verifíquelo al decodificar si check es true.

Esta capacidad aplica ese contrato orientado a humanos sobre texto UTF-8 con empaquetado de bits determinista, de forma que la misma entrada produce siempre la misma cadena Crockford y la decodificación inversa restaura los bytes originales cuando la carga es UTF-8 válido.

Dónde un codificador Crockford Base32 aporta valor real

Los equipos de producto y operaciones usan Crockford Base32 para identificadores públicos cortos que el personal de soporte debe leer por teléfono sin deletrear I frente a uno en cada carácter. El almacén y las etiquetas de activos se benefician de grupos con guiones y de un símbolo de control opcional que atrapa un dígito mal tecleado antes de que se elija la ubicación incorrecta.

Quienes desarrollan tokens compactos al estilo ULID o personalizados quieren un codificador con el alfabeto Crockford que la gente espera, no el conjunto 2–7 de RFC 4648, y un decodificador que acepte el pegado desordenado de chat o PDF. Ejercicios de clase y entrevistas sobre codificaciones legibles necesitan un oráculo determinista que rechace U en los datos y explique desajustes de control en lugar de devolver basura.

Mantenga cargas modestas, fije las cadenas de result en pruebas automatizadas y obtendrá Crockford Base32 reproducible para etiquetas, códigos de soporte y workers de borde sin montar su propia biblioteca de alfabeto.

Códigos de soporte y tickets legibles

Codifique referencias cortas para que los agentes las lean en voz alta sin confusiones I/L/O; decodifique pegados con guiones o minúsculas.

Canalizaciones de tokens e identificadores

Genere y verifique cargas Crockford Base32 en scripts y workers con la misma lógica pura que la herramienta gratuita del navegador.

¿Qué alfabeto usa Crockford Base32?

Dígitos 0–9 y letras A–Z excluyendo I, L, O y U (treinta y dos símbolos). La decodificación acepta minúsculas, guiones, O como 0 e I/L como 1.

¿En qué se diferencia del Base32 de RFC 4648?

RFC 4648 usa A–Z y 2–7 con relleno '='. Crockford elimina letras ambiguas, usa 0–9 y otro conjunto de letras, omite el relleno y ofrece un símbolo de control opcional.

¿Qué ocurre si envío un carácter no válido?

U no es válida en el alfabeto de datos (solo puede aparecer como símbolo de control).

¿Para qué sirve el símbolo de control de Crockford?

Es un carácter extra: el resto de dividir el valor del código entre 37, tomado de los 32 símbolos de datos más *, ~, $, = y U. Añádalo a etiquetas que alguien volverá a teclear; al decodificar con el control activado, un último carácter erróneo hace fallar la decodificación.

¿Puedo decodificar un código con guiones o en minúsculas?

Sí. Los guiones entre grupos se ignoran, da igual si las letras van en mayúsculas o minúsculas, la O se lee como cero y la I y la L como uno, así que un texto pegado desde un chat o un PDF se decodifica igual. La U se rechaza dentro de los datos.

Todo lo de esta página está disponible por programación. Esta sección es para equipos que quieren integrarlo en sus sistemas; el resto puede usar la herramienta de arriba sin más.

POSThttps://api.kit.forhosting.com/enc/base32-crockford

¿Prefiere automatizarlo? Un POST autenticado crea la tarea; el resultado llega por webhook o enlace firmado. La misma capacidad también se ejecuta aquí en la web, por email y desde Telegram — y pronto también desde nuestra app.

curl -X POST https://api.kit.forhosting.com/enc/base32-crockford \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"Hello"}'
{
  "text": "Hello"
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "enc.base32_crockford",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

La API es asíncrona: la llamada devuelve un task_id al instante y el resultado llega por webhook. El polling está limitado a 1 req/s por tarea.

Por solicitud$0.002

Precio publicado — sin tokens ni créditos inventados. Una tarea fallida no se cobra.

HTTPCódigoSignificado
401unauthorizedAPI key ausente o inválida.
402insufficient_balanceEl saldo no cubre el precio de la tarea.
404unknown_typeEl tipo de tarea no existe.
429rate_limitedDemasiadas peticiones. Use el webhook en vez de sondear.

La misma lógica pura de análisis alimenta la herramienta gratuita del navegador y la ruta API de pago, de modo que scripts de estudio, etiquetas de inventario y workers de producción no discrepan en un solo carácter. La entrada mal formada falla con invalid_input y un mensaje claro que nombra el símbolo incorrecto o el desajuste del control, en lugar de una corrupción silenciosa.

Contrato de entrada, forma de la respuesta y comportamiento ante errores

El texto vacío codifica a un resultado vacío. La longitud está limitada para que pegados excesivos fallen pronto. La validación fallida no se factura. Envíe por POST un cuerpo JSON con el campo de cadena obligatorio text y los opcionales mode y check. Mode es encode o decode y por defecto encode; se aceptan los alias op, operation y direction. Check es un booleano con valor predeterminado false; si es true al codificar, la API añade el símbolo de control Crockford y lo devuelve como check_symbol, y si es true al decodificar, el carácter final debe coincidir con el resto módulo treinta y siete o la tarea falla con invalid_input. Tras un encode correcto el cuerpo incluye mode, el text original, result (la cadena Crockford), length, input_bytes, alphabet Crockford, resumen de charset, la bandera check y la etiqueta de standard. Tras un decode correcto obtiene mode, text, result (cadena UTF-8), length, output_bytes, los mismos metadatos de alfabeto y, si se pidió check, check_verified más el check_symbol que pasó. La decodificación sin check trata toda la cadena como datos tras quitar guiones y aplicar alias O/I/L; cualquier carácter fuera del alfabeto de datos—incluida una U suelta en la carga—lanza invalid_input indicando posición y carácter. Un mode inválido o un check no booleano también fallan con invalid_input. Combine encode y decode en sus pruebas con check en true y false para que los goldens fijen alfabeto, alias y aritmética de control entre runtimes.

Dónde un codificador Crockford Base32 aporta valor real

Como la implementación es parse puro de nivel A, cada llamada correcta cuesta el precio base publicado $0.002 sin tokens de modelo ni red de salida.

Etiquetas de activo con símbolo de control opcional

Imprima etiquetas Crockford con check=true para que un solo error de tecleo falle la verificación antes de mover inventario al lugar equivocado.

¿Qué hace la opción check?

Al codificar, check=true añade un símbolo de control módulo 37 del conjunto de treinta y siete símbolos. Al decodificar, check=true exige ese símbolo final y rechaza desajustes.

¿Cuánto cuesta el codificador Crockford Base32?

La herramienta del navegador es gratuita. Las peticiones API usan saldo prepago KIT a $0.002 por llamada correcta; la entrada inválida no se factura.

Ver la documentación completa del KIT →