POSTValidar
Comprueba si una cadena es Base64 antes de usarla. La respuesta incluye el alfabeto, el relleno y el tamaño decodificado, o el motivo por el que no es válida.
POST
https://api.base64hub.com/v1/validatePetición
La entrada es la misma que en Decodificar: JSON con input, o el Base64 como cuerpo 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 del cuerpo
| Nombre | Tipo | Descripción |
|---|---|---|
input obligatorio | string | El texto que se comprueba. |
Respuesta
/v1/validate siempre responde 200 a una petición bien formada. Entrada válida:
200 OK · application/json
{
"valid": true,
"variant": "url",
"padded": true,
"bytes": 3
}
Entrada no válida, en este caso 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 | Descripción |
|---|---|---|
valid | boolean | true exactamente cuando Decodificar tendría éxito. |
variant | string | standard si aparece + o /, url si aparece - o _, mixed si aparecen ambos, either si no aparece ninguno. |
padded | boolean | Si la entrada limpia, = incluidos, tiene una longitud múltiplo de 4 caracteres. |
bytes | integer | Tamaño de los datos decodificados. |
error | object | Solo cuando valid es false: code es invalid_base64 y message describe el problema y su posición. |
either es habitual: SGVsbG8sIGh1YiE= no contiene ninguno de los cuatro caracteres especiales, así que es válido en los dos alfabetos. padded: false no hace que una entrada sea no válida; SGVsbG8sIGh1YiE es válido con padded: false y 11 bytes.
Errores
Los errores con un estado distinto de 200 tienen que ver con la petición, no con el Base64:
| Estado | Código | Causa |
|---|---|---|
| 400 | invalid_body | JSON 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. |
| 413 | too_large | El cuerpo supera 1 MB. |
| 415 | unsupported_media_type | Content-Type no es application/json ni text/plain. |
| 429 | ninguno | Se alcanzó el límite de peticiones; consulta los límites. |
Actualizado 22 nov 2026