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:.
https://api.base64hub.com/v1/decodeRequisiçã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="}'
const res = await fetch("https://api.base64hub.com/v1/decode", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({ input: "SGVsbG8sIGh1YiE=" }),
});
const data = await res.json();
console.log(data.output); // Hello, hub!
import json
import urllib.request
req = urllib.request.Request(
"https://api.base64hub.com/v1/decode",
data=json.dumps({"input": "SGVsbG8sIGh1YiE="}).encode(),
headers={"Content-Type": "application/json"},
)
with urllib.request.urlopen(req) as res:
print(json.load(res)["output"]) # Hello, hub!
b64 -d SGVsbG8sIGh1YiE=
# Hello, hub!
Parâmetros do corpo
| Nome | Tipo | Descrição |
|---|---|---|
input obrigatório | string | O 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
{
"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 +/+/:
{
"output": null,
"utf8": false,
"hex": "fbffbf",
"bytes_out": 3
}
| Campo | Tipo | Descrição |
|---|---|---|
output | string ou null | O texto decodificado, ou null quando os bytes não são UTF-8. |
utf8 | boolean | Se os bytes são UTF-8 válido. |
hex | string | Os bytes em hex minúsculo. Presente só quando utf8 é false. |
bytes_out | integer | Nú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
const res = await fetch("https://api.base64hub.com/v1/decode", {
method: "POST",
headers: { "Content-Type": "text/plain", Accept: "application/octet-stream" },
body: "SGk=",
});
const bytes = new Uint8Array(await res.arrayBuffer());
console.log(bytes); // Uint8Array(2) [ 72, 105 ]
import urllib.request
req = urllib.request.Request(
"https://api.base64hub.com/v1/decode",
data=b"SGk=",
headers={"Content-Type": "text/plain", "Accept": "application/octet-stream"},
)
with urllib.request.urlopen(req) as res:
print(res.read()) # b'Hi'
b64 -d -i 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:
{"error":{"code":"invalid_base64","message":"invalid character '!' at position 4"}}
| Status | Código | Causa |
|---|---|---|
| 400 | invalid_base64 | Um caractere fora dos dois alfabetos, = no meio, mais de dois =, ou um tamanho que deixa um caractere sozinho no último grupo. |
| 400 | invalid_body | JSON 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. |
| 413 | too_large | O corpo passa de 1 MB. |
| 415 | unsupported_media_type | O Content-Type não é application/json nem text/plain. |
| 429 | nenhum | Limite 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