- base64hub
- Документация
- HTTP API
- Проверка
POSTПроверка
Убедитесь, что строка – это Base64, прежде чем её использовать. В ответе будут алфавит, дополнение и размер после декодирования или причина, по которой строка некорректна.
POST
https://api.base64hub.com/v1/validateЗапрос
Входные данные те же, что и для декодирования: JSON с input или Base64 в теле 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)
Параметры тела
| Имя | Тип | Описание |
|---|---|---|
input обязательный | string | Текст для проверки. |
Ответ
На правильно оформленный запрос validate всегда отвечает 200. Корректные данные:
200 OK · application/json
{
"valid": true,
"variant": "url",
"padded": true,
"bytes": 3
}
Некорректные данные, здесь Zm9vY:
200 OK · application/json
{
"valid": false,
"error": {
"code": "invalid_base64",
"message": "invalid length: 5 characters leave a single character in the last group"
}
}
| Поле | Тип | Описание |
|---|---|---|
valid | boolean | true ровно тогда, когда декодирование прошло бы успешно. |
variant | string | standard, если встречается + или /, url, если встречается - или _, mixed, если есть и те и другие, either, если нет ни тех ни других. |
padded | boolean | Кратна ли 4 длина очищенных данных вместе с =. |
bytes | integer | Размер данных после декодирования. |
error | object | Только когда valid равно false: code равен invalid_base64, а message описывает проблему и её позицию. |
either встречается часто: в SGVsbG8sIGh1YiE= нет ни одного из четырёх особых символов, поэтому строка допустима в обоих алфавитах. padded: false не делает данные некорректными: SGVsbG8sIGh1YiE корректна, у неё padded: false и 11 байт.
Ошибки
Ошибки со статусом, отличным от 200, касаются самого запроса, а не Base64:
| Статус | Код | Причина |
|---|---|---|
| 400 | invalid_body | Некорректный JSON, input отсутствует или не строка, неизвестное поле, параметр строки запроса или тело не в UTF-8. |
| 413 | too_large | Тело больше 1 МБ. |
| 415 | unsupported_media_type | Content-Type не application/json и не text/plain. |
| 429 | нет | Достигнут лимит запросов; см. лимиты. |
Обновлено 22 нояб. 2026 г.