API — Cellar

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

Ключ доступа передаётся в заголовке Authorization. Ключ выпускается в панели для каждого проекта отдельно.

Authorization: Bearer <ваш_токен>

Базовый адрес

Все вызовы уходят на продакшн-эндпоинт:

https://clsr.one/api/v3/objects

Методы

Метод	Путь	Назначение
`PUT`	/api/v3/objects/{bucket}/{key}	Загрузить или заменить объект
`GET`	/api/v3/objects/{bucket}/{key}	Забрать объект или открыть поток выдачи
`HEAD`	/api/v3/objects/{bucket}/{key}	Метаданные объекта без тела
`DELETE`	/api/v3/objects/{bucket}/{key}	Удалить объект

Пример: загрузка объекта

curl -X PUT "https://clsr.one/api/v3/objects/media/logo.png" \
  -H "Authorization: Bearer $BLX_TOKEN" \
  -H "Content-Type: image/png" \
  --data-binary @logo.png

Пример: выгрузка объекта

curl "https://clsr.one/api/v3/objects/media/logo.png" \
  -H "Authorization: Bearer $BLX_TOKEN" \
  -o logo.png

Коды ответов

Код	Значение
`200`	Объект получен
`201`	Объект создан
`401`	Токен отсутствует или недействителен
`404`	Бакет или ключ не найден
`429`	Превышен лимит частоты запросов

Совместимость и SDK

Ветка объектов повторяет протокол AWS S3, поэтому работает любой S3-клиент: aws-cli, boto3, minio-py, rclone. В настройках укажите endpoint https://clsr.one и ваши ключи доступа.

Лимиты

По умолчанию: до 1200 запросов в секунду на проект, размер объекта до 5 ТБ, multipart для крупных файлов. Пороги поднимаются по запросу в поддержку.

REST API объектного хранилища