Endpoints
| Método | Ruta | Qué hace |
|---|---|---|
POST | /v1/encode | texto o bytes a Base64; estándar o URL-safe, relleno, ajuste de línea |
POST | /v1/decode | Base64 a texto, hex para datos binarios, o los bytes tal cual |
POST | /v1/validate | si es Base64, qué alfabeto usa, si tiene relleno, cuántos bytes |
GET | /v1/health | estado y versión |
GET | /v1/openapi.json | la descripción OpenAPI 3.1 |
Las peticiones y las respuestas son JSON. /v1/encode también acepta bytes tal cual como application/octet-stream, y /v1/decode puede devolver los bytes si los pides con Accept: application/octet-stream.
Una petición y su respuesta
Codifica una cadena como Base64 URL-safe sin relleno:
curl -s https://api.base64hub.com/v1/encode \
-H 'Content-Type: application/json' \
-d '{"input": "Привет", "variant": "url", "padding": false}'
{"output":"0J_RgNC40LLQtdGC","variant":"url","padding":false,"bytes_in":12,"bytes_out":16}
/v1/decode funciona igual y te avisa cuando los bytes no son texto:
curl -s https://api.base64hub.com/v1/decode \
-H 'Content-Type: text/plain' -d '+/+/'
{"output":null,"utf8":false,"hex":"fbffbf","bytes_out":3}
El decodificador es tolerante a propósito: acepta espacios y saltos de línea, un prefijo data:...;base64,, la falta de relleno y cualquiera de los dos alfabetos. Los errores reales vuelven como 400 invalid_base64 con el carácter incorrecto y su posición, por ejemplo invalid character '!' at position 4.
Límites y comportamiento
- Autenticación: ninguna, sin clave ni token.
- Límite de peticiones: 20 cada 10 segundos por dirección IP. Si lo superas, Cloudflare responde con el estado 429.
- Tamaño del cuerpo: hasta 1 MB. Los cuerpos más grandes reciben
413 too_large. - Entradas estrictas: los campos JSON y los parámetros de consulta desconocidos se rechazan con
400 invalid_body, así que una errata en el nombre de una opción nunca pasa desapercibida. - CORS:
Access-Control-Allow-Origin: *en todas las respuestas, con respuesta a las peticiones preflight. - Caché: todas las respuestas llevan
Cache-Control: no-store.
La introducción a la API tiene la tabla completa de errores y las reglas de cada tipo de contenido.
Cuándo usar una API para Base64
Base64 cuesta poco de calcular y todos los lenguajes lo traen integrado: btoa en los navegadores, Buffer en Node.js, el módulo base64 en Python. Llamar a un servicio web para ello tiene sentido cuando:
- trabajas en una herramienta no-code, una hoja de cálculo o un constructor de webhooks que puede hacer peticiones HTTP pero no ejecutar código;
- quieres la misma decodificación tolerante y la misma validación en todos los lenguajes sin portarlas;
- estás probando o enseñando y quieres una respuesta de referencia con la que comparar.
Para cualquier cosa sensible, como tokens o claves privadas, mejor una herramienta local: las herramientas del navegador de este sitio, la CLI o los paquetes de npm y Python dan resultados idénticos sin que los datos salgan de tu equipo.
Preguntas frecuentes
¿La API de base64hub es gratis de verdad?
Sí. No hay clave ni cuenta. Un límite de 20 peticiones cada 10 segundos por dirección IP la mantiene disponible para todos.
¿La API guarda lo que envío?
No. Funciona como un Cloudflare Worker sin almacenamiento y no registra el cuerpo de las peticiones. Aun así, no envíes secretos a ningún servicio web cuando te sirve una herramienta local; la CLI b64 da los mismos resultados sin conexión.
¿Puedo llamar a la API Base64 desde JavaScript en el navegador?
Sí. Todas las respuestas llevan Access-Control-Allow-Origin: * y las peticiones preflight tienen respuesta, así que fetch() funciona desde cualquier origen.
¿Qué tamaño de archivo puedo codificar con la API?
El cuerpo de la petición está limitado a 1 MB. Para archivos más grandes, usa la CLI, que trabaja en flujo, o la herramienta Archivo a Base64 en tu navegador.