- base64hub
- Документация
- 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/decode | Base64 в текст, 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 | Тело |
|---|---|---|
| encode | application/json | {"input": "<text>", "variant", "padding", "wrap"} |
| encode | application/octet-stream | сырые байты; параметры в строке запроса |
| decode, validate | application/json | {"input": "<base64>"} |
| decode, validate | text/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"}}
| Статус | Код | Когда |
|---|---|---|
| 400 | invalid_body | некорректный JSON, неверные типы полей, нет input, неизвестные поля или параметры строки запроса, тело не в UTF-8 |
| 400 | invalid_base64 | на вход decode пришёл не Base64; сообщение называет проблему и её позицию |
| 404 | not_found | неизвестный путь |
| 405 | method_not_allowed | неверный метод для этого пути; правильные перечислены в заголовке Allow |
| 413 | too_large | тело больше 1 МБ |
| 415 | unsupported_media_type | Content-Type, который эндпоинт не принимает |
| 429 | нет | достигнут лимит запросов; ответ приходит от Cloudflare и не в JSON |
| 500 | internal_error | непредвиденный сбой в API |
Validate сообщает о некорректном Base64 со статусом 200, потому что «некорректно» и есть ответ на заданный ему вопрос. См. проверку.
OpenAPI
Машиночитаемое описание лежит по адресу https://api.base64hub.com/v1/openapi.json. Импортируйте его в API-клиент или генератор кода, чтобы получить готовые запросы ко всем эндпоинтам.
Обновлено 22 нояб. 2026 г.