Справочник API

Базовый адрес https://api.objectbasin.com. Bearer-токены для REST, SigV4 для S3.

Аутентификация

Authorization: Bearer ob_live_xxxxxxxxxxxxxxxxxxxx

Ключи выдаются на бакет. При ротации предыдущий ключ продолжает работать 24 часа, чтобы релизы не ломались.

Бакеты

Метод	Путь	Описание
PUT	`/v1/buckets/{bucket}`	Создать бакет в ближайшем регионе или с `?region=`.
GET	`/v1/buckets`	Список бакетов со счётчиками использования.
POST	`/v1/buckets/{bucket}/replicate`	Включить асинхронную репликацию во второй регион.
DELETE	`/v1/buckets/{bucket}`	Удалить пустой бакет.

Объекты

Метод	Путь	Описание
PUT	`/v1/buckets/{bucket}/objects/{key}`	Загрузка объекта, максимум 5 ГиБ за запрос.
GET	`/v1/buckets/{bucket}/objects/{key}`	Скачивание, поддержка `Range` и условных заголовков.
GET	`/v1/buckets/{bucket}/objects?prefix=&cursor=`	Список объектов с курсорной пагинацией.
POST	`/v1/buckets/{bucket}/objects/{key}/copy`	Копирование на стороне сервиса.
DELETE	`/v1/buckets/{bucket}/objects/{key}`	Удаление объекта; версия уходит в окно жизненного цикла.

Multipart-загрузка

POST /v1/buckets/{bucket}/uploads                     → { "upload_id": "up_..." }
PUT  /v1/buckets/{bucket}/uploads/{upload_id}/{part}   → { "etag": "..." }
POST /v1/buckets/{bucket}/uploads/{upload_id}/complete → { "key": "...", "size": 1073741824 }

Части можно отправлять параллельно и в любом порядке: каждая становится надёжной сразу после проверки. Незавершённые загрузки удаляются через семь дней, если срок не продлён параметром ?ttl=.

Подписанные ссылки

GET /v1/buckets/{bucket}/objects/{key}/sign?expires=3600&ip=203.0.113.7

Параметры: expires (секунды, максимум 604800), ip (привязка к адресу), download (имя файла при скачивании).

Использование

Метод	Путь	Описание
GET	`/v1/usage?bucket=&period=2026-09`	Объём, запросы, трафик репликации.
GET	`/v1/usage.csv?period=2026-09`	То же в CSV.

Заголовки ответов

Заголовок	Значение
`x-objectbasin-region`	Регион, обслуживший запрос.
`x-objectbasin-node`	Идентификатор узла — полезен в обращениях.
`x-ratelimit-remaining`	Остаток запросов в текущей минуте.
`age`	Секунды с момента кэширования объекта.