Introducción a la API HTTP
Una pequeña API JSON para Base64 en https://api.base64hub.com/v1. Sin clave, sin cuenta, con CORS activado. Esta página cubre lo que tienen en común todos los endpoints.
URL base y endpoints
https://api.base64hub.com/v1
| Método | Ruta | Para qué sirve |
|---|---|---|
POST | /v1/encode | texto o bytes a Base64 |
POST | /v1/decode | Base64 a texto, hex o bytes tal cual |
POST | /v1/validate | comprueba Base64 y lo describe |
GET | /v1/health | estado y versión |
GET | /v1/openapi.json | descripción OpenAPI 3.1 de la API |
GET https://api.base64hub.com/ redirige (302) a esta página. Las peticiones no necesitan autenticación.
Formatos de petición
Cada endpoint acepta un conjunto fijo de tipos de contenido y responde a cualquier otro con 415 unsupported_media_type.
| Endpoint | Content-Type | Cuerpo |
|---|---|---|
| encode | application/json | {"input": "<text>", "variant", "padding", "wrap"} |
| encode | application/octet-stream | bytes tal cual; opciones en la query string |
| decode, validate | application/json | {"input": "<base64>"} |
| decode, validate | text/plain | el propio Base64 |
Los cuerpos deben estar en UTF-8 (salvo los bytes que se envían a encode). Los campos JSON y los parámetros de consulta desconocidos se rechazan con 400 invalid_body en lugar de ignorarse, así que una opción mal escrita nunca falla en silencio. Las opciones de la query string solo se leen junto con un cuerpo application/octet-stream.
Las respuestas son JSON (application/json; charset=utf-8), salvo decode con Accept: application/octet-stream, que devuelve los bytes tal cual.
CORS y cabeceras
Todas las respuestas llevan:
Access-Control-Allow-Origin: *
Cache-Control: no-store
X-Content-Type-Options: nosniff
Las peticiones preflight OPTIONS reciben 204 con los métodos permitidos y las cabeceras de petición Content-Type y Accept, así que la API se puede llamar con fetch() desde cualquier página web.
Límites
- Tamaño del cuerpo: 1 MB (1048576 bytes). Los cuerpos más grandes reciben
413 too_large. - Límite de peticiones: 20 cada 10 segundos por dirección IP en las rutas bajo
/v1/. Lo aplica Cloudflare, por delante de la API. Si lo superas, recibes el estado429con la respuesta propia de Cloudflare, que no es JSON y no lleva cabecera CORS, así que un script del navegador ve un error de red en lugar de un cuerpo legible. - Wrap: de 0 a 1000 caracteres.
La API no guarda estado y no registra el cuerpo de las peticiones. Para archivos grandes o secretos, usa una herramienta local como la CLI b64.
Errores
Los errores de la propia API son JSON con un code estable y un message legible:
{"error":{"code":"invalid_base64","message":"invalid character '!' at position 4"}}
| Estado | Código | Cuándo |
|---|---|---|
| 400 | invalid_body | JSON mal formado, tipos de campo incorrectos, falta input, campos o parámetros de consulta desconocidos, un cuerpo que no es UTF-8 |
| 400 | invalid_base64 | la entrada de decode no es Base64; el mensaje indica el problema y su posición |
| 404 | not_found | ruta desconocida |
| 405 | method_not_allowed | método incorrecto para la ruta; la cabecera Allow lista los correctos |
| 413 | too_large | cuerpo de más de 1 MB |
| 415 | unsupported_media_type | un Content-Type que el endpoint no acepta |
| 429 | ninguno | se alcanzó el límite de peticiones; la respuesta viene de Cloudflare y no es JSON |
| 500 | internal_error | un fallo inesperado en la API |
/v1/validate informa de un Base64 no válido con el estado 200, porque «no es válido» es la respuesta a la pregunta que se le hizo. Consulta Validar.
OpenAPI
La descripción legible por máquinas está en https://api.base64hub.com/v1/openapi.json. Impórtala en un cliente de API o en un generador de código para tener peticiones listas para cada endpoint.
Actualizado 22 nov 2026