Enviar um arquivo
  1. base64hub
  2. Docs
  3. API HTTP
  4. Decodificar

POSTDecodificar

Transforme Base64 de volta em texto, ou nos bytes originais. A entrada pode usar qualquer um dos dois alfabetos, omitir o preenchimento ou trazer um prefixo data:.

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

Requisição

Envie o Base64 em JSON, no campo input, ou como o corpo inteiro com Content-Type: text/plain.

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

Parâmetros do corpo

NomeTipoDescrição
input obrigatóriostringO Base64 a decodificar.

Com Content-Type: text/plain, o corpo inteiro é a entrada, sem JSON em volta. Este endpoint não aceita parâmetros de query.

O que o decodificador aceita:

  • espaços, tabulações e quebras de linha em qualquer lugar, por exemplo Base64 quebrado no estilo MIME;
  • um prefixo data:<type>;base64,, que é removido;
  • preenchimento = ausente;
  • o alfabeto padrão e o URL-safe, até misturados.

Resposta

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

Quando os bytes decodificados não são UTF-8 válido, output é null e os bytes vêm em hex. Esta é a resposta para +/+/:

200 OK · application/json
{
  "output": null,
  "utf8": false,
  "hex": "fbffbf",
  "bytes_out": 3
}
CampoTipoDescrição
outputstring ou nullO texto decodificado, ou null quando os bytes não são UTF-8.
utf8booleanSe os bytes são UTF-8 válido.
hexstringOs bytes em hex minúsculo. Presente só quando utf8 é false.
bytes_outintegerNúmero de bytes decodificados.

Bytes puros

Para receber um arquivo de volta, peça os bytes com Accept: application/octet-stream. O corpo da resposta passa a ser os dados decodificados, sem JSON em volta.

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

Erros

Base64 inválido é rejeitado com 400 invalid_base64. A mensagem indica o primeiro problema e a posição dele, contada a partir de 0 depois de removidos os espaços em branco:

400 Bad Request · application/json
{"error":{"code":"invalid_base64","message":"invalid character '!' at position 4"}}
StatusCódigoCausa
400invalid_base64Um caractere fora dos dois alfabetos, = no meio, mais de dois =, ou um tamanho que deixa um caractere sozinho no último grupo.
400invalid_bodyJSON inválido, input ausente ou que não é string, um campo desconhecido, um parâmetro de query, ou um corpo que não é UTF-8.
413too_largeO corpo passa de 1 MB.
415unsupported_media_typeO Content-Type não é application/json nem text/plain.
429nenhumLimite de requisições atingido; veja os limites.

Para conferir uma string sem receber um status de erro, use o endpoint Validar.

Atualizado 22 de nov. de 2026