ACDN :: Документация :: Скачивание файла

Скачивание файла

Для получения файла используется GET-запрос на storage endpoint. Путь формируется из имени зоны хранения, директории и имени файла. Если объект не найден, endpoint возвращает ошибку. Если путь указывает на директорию, система может вернуть её содержимое как listing.

GET

https://storage.acdn.uz/{storageZoneName}/{path}/{fileName}

Что делает запрос

HTTP-метод

Используется `GET`, потому что запрос читает объект из зоны хранения без изменения данных.

Точка входа

Запрос отправляется на `storage.acdn.uz`, а путь формируется из storage zone, директории и имени файла.

Файлы и директории

Если путь указывает на файл, клиент получает содержимое файла. Если путь указывает на директорию или корень зоны, система может вернуть JSON-listing содержимого.

Заголовки

`AccessKey`

Обязательный заголовок для авторизации. Используется API-ключ зоны хранения.

Параметры пути

`storageZoneName`

Имя зоны хранения, из которой читается объект.

`path`

Путь к директории или файлу внутри зоны. Для корня зоны можно запрашивать путь без вложенных директорий.

`fileName`

Имя файла, который нужно скачать, либо конечный сегмент пути к объекту.

Пример cURL

curl --request GET \
  --url https://storage.acdn.uz/{storageZoneName}/{path}/{fileName} \
  --header 'AccessKey: <api-key>'

Ответ

При успешном запросе endpoint возвращает файл с его content type.
Если путь указывает на директорию или на корень зоны, endpoint может вернуть JSON-listing содержимого.
Если объект отсутствует, клиент получает ошибку и объект не возвращается.