Эндпоинты
| Метод | Путь | Что делает |
|---|---|---|
POST | /v1/encode | текст или сырые байты в Base64; стандартный или URL-safe алфавит, дополнение, перенос строк |
POST | /v1/decode | Base64 в текст, hex для бинарных данных или сырые байты |
POST | /v1/validate | Base64 ли это, какой алфавит, есть ли дополнение, сколько байтов |
GET | /v1/health | статус и версия |
GET | /v1/openapi.json | описание в формате OpenAPI 3.1 |
Запросы и ответы передаются в JSON. Encode также принимает сырые байты как application/octet-stream, а decode может вернуть сырые байты, если запросить их заголовком Accept: application/octet-stream.
Запрос и ответ
Закодируем строку в URL-safe Base64 без дополнения:
curl -s https://api.base64hub.com/v1/encode \
-H 'Content-Type: application/json' \
-d '{"input": "Привет", "variant": "url", "padding": false}'
{"output":"0J_RgNC40LLQtdGC","variant":"url","padding":false,"bytes_in":12,"bytes_out":16}
Decode работает так же и сообщает, если в байтах не текст:
curl -s https://api.base64hub.com/v1/decode \
-H 'Content-Type: text/plain' -d '+/+/'
{"output":null,"utf8":false,"hex":"fbffbf","bytes_out":3}
Декодер намеренно нестрогий: он принимает пробелы и переводы строк, префикс data:...;base64,, строку без дополнения и оба алфавита. Настоящие ошибки возвращаются как 400 invalid_base64 с неверным символом и его позицией, например invalid character '!' at position 4.
Ограничения и поведение
- Аутентификация: нет, ключ и токен не нужны.
- Ограничение частоты: 20 запросов за 10 секунд с одного IP-адреса. При превышении Cloudflare возвращает статус 429.
- Размер тела: до 1 МБ. На тело побольше приходит
413 too_large. - Строгая проверка входа: неизвестные поля JSON и параметры строки запроса отклоняются с
400 invalid_body, так что опечатка в названии параметра не останется незамеченной. - CORS:
Access-Control-Allow-Origin: *в каждом ответе, на preflight-запросы API отвечает. - Кэширование: у каждого ответа
Cache-Control: no-store.
Полная таблица ошибок и правила для каждого типа содержимого есть в обзоре API.
Когда для Base64 нужен API
Base64 вычисляется дёшево и встроен в каждый язык: btoa в браузерах, Buffer в Node.js, модуль base64 в Python. Обращаться за ним к веб-сервису имеет смысл, когда:
- вы работаете в no-code-инструменте, электронной таблице или конструкторе вебхуков, который умеет отправлять HTTP-запросы, но не выполняет код;
- нужны одинаковые нестрогое декодирование и проверка во всех языках, а переносить эту логику на каждый не хочется;
- вы тестируете или обучаете и хотите получить эталонный ответ для сравнения.
Для всего чувствительного, например токенов или закрытых ключей, лучше подойдёт локальный инструмент: браузерные инструменты на этом сайте, CLI или пакеты для npm и Python дают те же результаты, а данные не покидают ваш компьютер.
Вопросы и ответы
API base64hub правда бесплатный?
Да. Не нужны ни ключ, ни аккаунт. Ограничение в 20 запросов за 10 секунд с одного IP-адреса нужно, чтобы API оставался доступен всем.
Сохраняет ли API то, что я отправляю?
Нет. Он работает как Cloudflare Worker без хранилища и не пишет тела запросов в логи. И всё же не отправляйте секреты ни в какой веб-сервис, если справится локальный инструмент: CLI b64 даёт те же результаты офлайн.
Можно ли вызывать API Base64 из JavaScript в браузере?
Да. Каждый ответ содержит Access-Control-Allow-Origin: *, и на preflight-запросы API тоже отвечает, так что fetch() работает с любого origin.
Файл какого размера можно закодировать через API?
Тело запроса ограничено 1 МБ. Для файлов побольше используйте CLI, который работает потоково, или инструмент файл в Base64 в браузере.