Загрузить файл
  1. base64hub
  2. Документация
  3. HTTP API

Обзор HTTP API

Небольшой JSON API для Base64 по адресу https://api.base64hub.com/v1. Без ключа и аккаунта, с поддержкой CORS. На этой странице описано то, что общее у всех эндпоинтов.

Базовый URL и эндпоинты

https://api.base64hub.com/v1
МетодПутьНазначение
POST/v1/encodeтекст или сырые байты в Base64
POST/v1/decodeBase64 в текст, hex или сырые байты
POST/v1/validateпроверить Base64 и описать его
GET/v1/healthстатус и версия
GET/v1/openapi.jsonописание API в формате OpenAPI 3.1

GET https://api.base64hub.com/ перенаправляет (302) на эту страницу. Аутентификация не нужна.

Форматы запросов

Каждый эндпоинт принимает фиксированный набор типов содержимого, а на всё остальное отвечает 415 unsupported_media_type.

ЭндпоинтContent-TypeТело
encodeapplication/json{"input": "<text>", "variant", "padding", "wrap"}
encodeapplication/octet-streamсырые байты; параметры в строке запроса
decode, validateapplication/json{"input": "<base64>"}
decode, validatetext/plainсам Base64

Тела должны быть в UTF-8 (кроме сырых байтов для encode). Неизвестные поля JSON и неизвестные параметры строки запроса не игнорируются, а отклоняются с 400 invalid_body, так что параметр с опечаткой не сломается молча. Параметры из строки запроса читаются только вместе с телом application/octet-stream.

Ответы приходят в JSON (application/json; charset=utf-8), кроме decode с Accept: application/octet-stream, который возвращает сырые байты.

CORS и заголовки

Каждый ответ содержит:

Access-Control-Allow-Origin: *
Cache-Control: no-store
X-Content-Type-Options: nosniff

На preflight-запросы OPTIONS приходит 204 с разрешёнными методами и заголовками запроса Content-Type и Accept, так что API можно вызывать через fetch() с любой веб-страницы.

Лимиты

  • Размер тела: 1 МБ (1048576 байт). На тело побольше приходит 413 too_large.
  • Ограничение частоты: 20 запросов за 10 секунд с одного IP-адреса для путей под /v1/. Лимит соблюдает Cloudflare, который стоит перед API. При превышении приходит статус 429 с собственным ответом Cloudflare: это не JSON, и в нём нет заголовка CORS, поэтому скрипт в браузере увидит сетевую ошибку, а не тело ответа.
  • Перенос строк: от 0 до 1000 символов.

API не хранит состояние и не пишет тела запросов в логи. Для больших файлов или секретов используйте локальный инструмент, например CLI b64.

Ошибки

Ошибки самого API приходят в JSON со стабильным code и понятным человеку message:

{"error":{"code":"invalid_base64","message":"invalid character '!' at position 4"}}
СтатусКодКогда
400invalid_bodyнекорректный JSON, неверные типы полей, нет input, неизвестные поля или параметры строки запроса, тело не в UTF-8
400invalid_base64на вход decode пришёл не Base64; сообщение называет проблему и её позицию
404not_foundнеизвестный путь
405method_not_allowedневерный метод для этого пути; правильные перечислены в заголовке Allow
413too_largeтело больше 1 МБ
415unsupported_media_typeContent-Type, который эндпоинт не принимает
429нетдостигнут лимит запросов; ответ приходит от Cloudflare и не в JSON
500internal_errorнепредвиденный сбой в API

Validate сообщает о некорректном Base64 со статусом 200, потому что «некорректно» и есть ответ на заданный ему вопрос. См. проверку.

OpenAPI

Машиночитаемое описание лежит по адресу https://api.base64hub.com/v1/openapi.json. Импортируйте его в API-клиент или генератор кода, чтобы получить готовые запросы ко всем эндпоинтам.

Обновлено 22 нояб. 2026 г.