Перейти к основному содержимому

Работа с файлами

Взаимодействие с Хранилищем осуществляется программно. Вы можете использовать API или SDK для управления файлами.

Способы загрузки​

Сервис поддерживает два основных механизма загрузки файлов, каждый из которых подходит для своих сценариев.

1. Простая загрузка (Simple Upload)​

Стандартная загрузка через HTTP POST запрос с использованием multipart/form-data.

  • Когда использовать: Для небольших файлов (аватарки, документы, картинки), когда не требуется сложная логика возобновления.
  • Преимущества: Простота реализации, поддержка любым HTTP-клиентом.

2. Протокол TUS (Resumable Upload)​

TUS — это открытый протокол для возобновляемой загрузки файлов.

  • Когда использовать:
    • Загрузка больших файлов (видео, архивы).
    • Работа в нестабильных сетях (мобильный интернет).
  • Преимущества:
    • Возобновляемость: Если соединение прервется, загрузка продолжится с того же места.
    • Надежность: Гарантия целостности данных.

Доступ к файлам​

После загрузки файла вы можете получить к нему доступ по URL.

Получение URL​

URL файла формируется на основе настроек вашего провайдера и ключа файла.

  • Публичные файлы: Доступны по прямой ссылке без авторизации (если бакет настроен как публичный).
  • Приватные файлы: Требуют генерации подписанных URL (Presigned URLs) с ограниченным сроком действия для безопасного доступа.
подсказка

Подробную информацию о методах API и функциях SDK для работы с хранилищем смотрите в разделе API Reference и SDK.