REST

POST

Составной запрос multipart/form-data

https://api.defaultuploader.com/v1/upload
# multipart/form-data
# Требуется заголовок — authorization: SECRET_CLIENT_TOKEN

Для загрузки файлов необходимо получить секретный ключ в личном кабинете Default uploader и добавить заголовок Authorization в запрос:

curl --location 'https://api.defaultuploader.com/v1/upload' --header 'Authorization: YOUR_SECRET_CLIENT_TOKEN' --form 'file=@"/C:/path_to_file/file_example_JPG_100kB.jpg"'

Вы получите следующий ответ от сервера:

[ // возвращается всегда коллекция
    {
        "sourceName": "7uLbiXh7867H7dEPpsubV9.png", // уникальный ID файла в бакете
        "src": "https://api.defaultuploader.com/v1/image/upload/azxwjk4PCkLTFbuUYiQZ1j/7uLbiXh7867H7dEPpsubV9.png", // путь до файла через API
        "originalSrc": "https://hb.vkcs.cloud/defaultuploader/image/png/7uLbiXh7867H7dEPpsubV9.png", // прямой путь до файла в бакете
        "originalName": "dark_theme.png", // оригинальное название файла
        "s3PathOriginal": "image/png/7uLbiXh7867H7dEPpsubV9.png", // путь до оригинального файла
        "s3Path": "image/png/7uLbiXh7867H7dEPpsubV9.png", // путь до производного файла
        "options": {}, // внутренние настройки
        "size": 1400308, // размер в байтах
        "mimeType": "image",
        "format": "png"
    }
]

PUT

Составной запрос multipart/form-data с подписанной ссылкой

В этом руководстве вы узнаете как получить подписанную ссылку.

https://api.defaultuploader.com/v1/upload/sign/7uLbiXh7867H7dEPpsubV9/5447114698657692x-params12d848eaca5282asdasda44766906ebx-token1427afc2d42ab2a200555c5d6b47a48b29cbffaac19cf572314ddafasddfd627ac0cdfabd6a134ggjhoda42728180a845e719ca0e0ce797ac/my-custom-folder.com?expirationIn=3600

GET

https://api.defaultuploader.com/v1/MIME_TYPE/upload/CLIENT_TOKEN/S3_PATH

v1 — версия api
MIME_TYPE — тип медиа(image, video, audio)
CLIENT_TOKEN — токен из личного кибенета
S3_PATH — путь до файла в вашем S3 хранилище

Запрос GET отдает файл со следующими заголовками:

Key	Value
cache-control	public, max-age=604800
etag	image/png/7uLbiXh7867H7dEPpsubV9.png
accept-ranges	bytes
content-length	1400308
content-range	bytes 0 - 1400308
content-type	image/png

DELETE

Удаляет оригинал файла и все производные от него файлы.

https://api.defaultuploader.com/v1/upload/S3_PATH_ORIGINAL
# Требуется заголовок — authorization: SECRET_CLIENT_TOKEN