POSTValidar
Confira se uma string é Base64 antes de usá-la. A resposta traz o alfabeto, o preenchimento e o tamanho decodificado, ou o motivo de ela não ser válida.
POST
https://api.base64hub.com/v1/validateRequisição
A entrada é a mesma do endpoint Decodificar: JSON com input, ou o Base64 como corpo text/plain.
curl -s https://api.base64hub.com/v1/validate \
-H 'Content-Type: text/plain' \
-d '-_-_'
const res = await fetch("https://api.base64hub.com/v1/validate", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({ input: "-_-_" }),
});
const v = await res.json();
console.log(v.valid, v.variant, v.bytes); // true url 3
import json
import urllib.request
req = urllib.request.Request(
"https://api.base64hub.com/v1/validate",
data=json.dumps({"input": "-_-_"}).encode(),
headers={"Content-Type": "application/json"},
)
with urllib.request.urlopen(req) as res:
v = json.load(res)
print(v["valid"], v["variant"], v["bytes"]) # True url 3
b64 --validate -- -_-_
# valid (url, 3 bytes)
Parâmetros do corpo
| Nome | Tipo | Descrição |
|---|---|---|
input obrigatório | string | O texto a conferir. |
Resposta
O endpoint validate sempre responde 200 a uma requisição bem formada. Entrada válida:
200 OK · application/json
{
"valid": true,
"variant": "url",
"padded": true,
"bytes": 3
}
Entrada inválida, aqui Zm9vY:
200 OK · application/json
{
"valid": false,
"error": {
"code": "invalid_base64",
"message": "invalid length: 5 characters leave a single character in the last group"
}
}
| Campo | Tipo | Descrição |
|---|---|---|
valid | boolean | true exatamente quando o endpoint Decodificar daria certo. |
variant | string | standard se aparece + ou /, url se aparece - ou _, mixed se aparecem os dois, either se nenhum. |
padded | boolean | Se a entrada limpa, = incluído, tem um tamanho múltiplo de 4 caracteres. |
bytes | integer | Tamanho dos dados decodificados. |
error | object | Só quando valid é false: code é invalid_base64, e message descreve o problema e a posição dele. |
either é comum: SGVsbG8sIGh1YiE= não contém nenhum dos quatro caracteres especiais, então é válido nos dois alfabetos. padded: false não torna a entrada inválida; SGVsbG8sIGh1YiE é válido, com padded: false e 11 bytes.
Erros
Os erros com status diferente de 200 dizem respeito à requisição, não ao Base64:
| Status | Código | Causa |
|---|---|---|
| 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. |
Atualizado 22 de nov. de 2026