Программный интерфейс

Все операции выполняются по защищённому соединению. Авторизация — по токену доступа в заголовке Authorization. Токен выдаётся в панели управления и может быть ограничен по правам и сроку действия.

Загрузка объекта

Объект передаётся методом POST на адрес узла. Тело запроса — двоичные данные. Для файлов крупнее 64 МиБ используйте многочастную загрузку.

POST /api/upload HTTP/1.1
Host: cdn.burlakovsg.ru
Authorization: Bearer <токен>
Content-Type: application/octet-stream
Content-Length: 1048576

<двоичные данные>

Успешный ответ содержит контрольную сумму, размер и публичный адрес объекта.

{
  "ok": true,
  "size": 1048576,
  "sha256": "9f2c...a41b",
  "url": "https://cdn.burlakovsg.ru/objects/9f2c...a41b"
}

Коды ответов

Код	Значение
200	Объект принят и доступен для выдачи
201	Создан новый объект
400	Некорректный запрос или повреждённое тело
401	Отсутствует или недействителен токен
413	Превышен допустимый размер объекта
429	Превышено ограничение частоты запросов

Ограничения

По умолчанию — 60 запросов в минуту на токен и 1 ГиБ на объект при одиночной загрузке. Ограничения можно изменить в панели управления. Повторные попытки рекомендуется выполнять с экспоненциальной задержкой.