Простой AccessKey API :: Документация

Авторизация и формат URL

Простой API подходит, когда S3 SDK не нужен. Передайте API key зоны в header AccessKey, а имя зоны и object key — в URL.

Формат endpoint: https://storage.acdn.uz/{storageZoneName}/{objectKey}.
Значение AccessKey отличается от S3 access key ID и secret.
Для browser download link ключ можно передать как query-параметр accessKey, поскольку anchor не умеет добавлять header.
Body PUT-запроса содержит сырые байты, а не JSON, base64 или multipart/form-data.

Поддерживаемые операции

GET

Скачать объект. Trailing slash или корень зоны возвращает JSON-listing директории.

HEAD

Проверить объект или listing директории без response body.

PUT

Создать или заменить один объект содержимым raw request body.

DELETE

Удалить точный object key. Директории рекурсивно не удаляются.

Примеры cURL

curl --request PUT \
  --url https://storage.acdn.uz/<bucket>/backups/archive.tar \
  --header 'AccessKey: <api-key>' \
  --header 'Content-Type: application/octet-stream' \
  --data-binary '@/absolute/path/to/archive.tar'

curl --request GET \
  --url https://storage.acdn.uz/<bucket>/backups/archive.tar \
  --header 'AccessKey: <api-key>' \
  --output archive.tar

curl --request DELETE \
  --url https://storage.acdn.uz/<bucket>/backups/archive.tar \
  --header 'AccessKey: <api-key>'

Ответы и ошибки

Успешный PUT возвращает 201 Created, успешный DELETE — 200 OK.
Listing возвращается как JSON. Чтение объекта возвращает сохранённый content type и байты.
Ошибки простого API — обычные текстовые HTTP-ответы. XML-документы используются только для подписанных S3-запросов.