Subir un archivo
  1. base64hub
  2. Docs
  3. API HTTP

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étodoRutaPara qué sirve
POST/v1/encodetexto o bytes a Base64
POST/v1/decodeBase64 a texto, hex o bytes tal cual
POST/v1/validatecomprueba Base64 y lo describe
GET/v1/healthestado y versión
GET/v1/openapi.jsondescripció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.

EndpointContent-TypeCuerpo
encodeapplication/json{"input": "<text>", "variant", "padding", "wrap"}
encodeapplication/octet-streambytes tal cual; opciones en la query string
decode, validateapplication/json{"input": "<base64>"}
decode, validatetext/plainel 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 estado 429 con 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"}}
EstadoCódigoCuándo
400invalid_bodyJSON mal formado, tipos de campo incorrectos, falta input, campos o parámetros de consulta desconocidos, un cuerpo que no es UTF-8
400invalid_base64la entrada de decode no es Base64; el mensaje indica el problema y su posición
404not_foundruta desconocida
405method_not_allowedmétodo incorrecto para la ruta; la cabecera Allow lista los correctos
413too_largecuerpo de más de 1 MB
415unsupported_media_typeun Content-Type que el endpoint no acepta
429ningunose alcanzó el límite de peticiones; la respuesta viene de Cloudflare y no es JSON
500internal_errorun 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