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

POSTDecodificar

Convierte Base64 de nuevo en texto o en los bytes originales. La entrada puede usar cualquiera de los dos alfabetos, omitir el relleno o llevar un prefijo data:.

POSThttps://api.base64hub.com/v1/decode

Petición

Envía el Base64 como JSON en input, o como cuerpo completo con Content-Type: text/plain.

curl -s https://api.base64hub.com/v1/decode \
  -H 'Content-Type: application/json' \
  -d '{"input": "SGVsbG8sIGh1YiE="}'

Parámetros del cuerpo

NombreTipoDescripción
input obligatoriostringEl Base64 que se decodifica.

Con Content-Type: text/plain, todo el cuerpo es la entrada, sin JSON alrededor. Este endpoint no acepta parámetros de consulta.

Qué acepta el decodificador:

  • espacios, tabuladores y saltos de línea en cualquier sitio, por ejemplo Base64 ajustado al estilo MIME;
  • un prefijo data:<type>;base64,, que se elimina;
  • la falta del relleno =;
  • el alfabeto estándar y el URL-safe, incluso mezclados.

Respuesta

200 OK · application/json
{
  "output": "Hello, hub!",
  "utf8": true,
  "bytes_out": 11
}

Cuando los bytes decodificados no son UTF-8 válido, output es null y los bytes llegan en hex. Esta es la respuesta para +/+/:

200 OK · application/json
{
  "output": null,
  "utf8": false,
  "hex": "fbffbf",
  "bytes_out": 3
}
CampoTipoDescripción
outputstring o nullEl texto decodificado, o null cuando los bytes no son UTF-8.
utf8booleanSi los bytes son UTF-8 válido.
hexstringLos bytes en hex en minúsculas. Solo aparece cuando utf8 es false.
bytes_outintegerNúmero de bytes decodificados.

Bytes tal cual

Para recuperar un archivo, pide los bytes con Accept: application/octet-stream. El cuerpo de la respuesta es entonces el dato decodificado, sin JSON alrededor.

curl -s https://api.base64hub.com/v1/decode \
  -H 'Content-Type: text/plain' \
  -H 'Accept: application/octet-stream' \
  --data-binary @photo.b64 -o photo.jpg

Errores

Un Base64 no válido se rechaza con 400 invalid_base64. El mensaje indica el primer problema y su posición, contada desde 0 después de quitar los espacios en blanco:

400 Bad Request · application/json
{"error":{"code":"invalid_base64","message":"invalid character '!' at position 4"}}
EstadoCódigoCausa
400invalid_base64Un carácter fuera de los dos alfabetos, un = en medio, más de dos = o una longitud que deja un único carácter en el último grupo.
400invalid_bodyJSON no válido, falta input o no es una cadena, un campo desconocido, un parámetro de consulta o un cuerpo que no es UTF-8.
413too_largeEl cuerpo supera 1 MB.
415unsupported_media_typeContent-Type no es application/json ni text/plain.
429ningunoSe alcanzó el límite de peticiones; consulta los límites.

Para comprobar una cadena sin recibir un estado de error, usa Validar.

Actualizado 22 nov 2026