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

Единый эндпоинт /api/v1/objects для загрузки, выгрузки и управления объектами.

Базовый URL

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

https://fastxconnect.ru/api/v1/objects

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

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

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

Методы

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

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

curl "https://fastxconnect.ru/api/v1/objects/media/logo.png" \
  -H "Authorization: Bearer $FXC_TOKEN" \
  -o logo.png

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

curl -X PUT "https://fastxconnect.ru/api/v1/objects/media/logo.png" \
  -H "Authorization: Bearer $FXC_TOKEN" \
  -H "Content-Type: image/png" \
  --data-binary @logo.png

Коды ответов

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

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

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

Лимиты

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