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

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.

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

Requisiçã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 '-_-_'

Parâmetros do corpo

NomeTipoDescrição
input obrigatóriostringO 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"
  }
}
CampoTipoDescrição
validbooleantrue exatamente quando o endpoint Decodificar daria certo.
variantstringstandard se aparece + ou /, url se aparece - ou _, mixed se aparecem os dois, either se nenhum.
paddedbooleanSe a entrada limpa, = incluído, tem um tamanho múltiplo de 4 caracteres.
bytesintegerTamanho dos dados decodificados.
errorobjectSó 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:

StatusCódigoCausa
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.

Atualizado 22 de nov. de 2026