- base64hub
- Документация
- HTTP API
- Декодирование
POSTДекодирование
Превращает Base64 обратно в текст или в исходные байты. Во входных данных может быть любой из алфавитов, может не быть дополнения или стоять префикс data:.
https://api.base64hub.com/v1/decodeЗапрос
Отправьте Base64 в поле input в JSON или целиком в теле с 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!
Параметры тела
| Имя | Тип | Описание |
|---|---|---|
input обязательный | string | Base64 для декодирования. |
С Content-Type: text/plain всё тело считается входными данными, без обёртки JSON. Параметры строки запроса этот эндпоинт не принимает.
Что принимает декодер:
- пробелы, табуляции и переводы строк в любом месте, например Base64 с переносами MIME;
- префикс
data:<type>;base64,, который удаляется; - строки без дополнения
=; - стандартный и URL-safe алфавит, даже вперемешку.
Ответ
{
"output": "Hello, hub!",
"utf8": true,
"bytes_out": 11
}
Если декодированные байты не образуют корректный UTF-8, output равен null, а байты приходят в hex. Вот ответ для +/+/:
{
"output": null,
"utf8": false,
"hex": "fbffbf",
"bytes_out": 3
}
| Поле | Тип | Описание |
|---|---|---|
output | string или null | Декодированный текст или null, если байты не UTF-8. |
utf8 | boolean | Образуют ли байты корректный UTF-8. |
hex | string | Байты в hex строчными буквами. Есть только когда utf8 равно false. |
bytes_out | integer | Число декодированных байтов. |
Сырые байты
Чтобы получить файл обратно, запросите байты заголовком Accept: application/octet-stream. Тогда телом ответа будут декодированные данные без обёртки JSON.
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
Ошибки
Некорректный Base64 отклоняется с 400 invalid_base64. Сообщение называет первую проблему и её позицию, которая отсчитывается от 0 после удаления пробельных символов:
{"error":{"code":"invalid_base64","message":"invalid character '!' at position 4"}}
| Статус | Код | Причина |
|---|---|---|
| 400 | invalid_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 г.