Загрузка файла

Для того чтобы прикрепить файл к сообщению или к другой сущности через API, требуется сначала загрузить файл на сервер (через метод получения подписи и ключа), а затем сформировать ссылку на него.

Процесс загрузки состоит из трёх шагов:

1. Получение подписи, ключа и других параметров — сделать POST-запрос без тела запроса для получения параметров загрузки.
2. Загрузка файла — после получения всех параметров, нужно сделать POST запрос c форматом multipart/form-data на адрес direct_url, включая те же поля, что пришли (content-disposition, acl, policy, x-amz-credential, x-amz-algorithm, x-amz-date, x-amz-signature, key) и сам файл. При успешной загрузке — HTTP статус 204, тело ответа отсутствует.
3. Прикрепление файла к сообщению или другой сущности — после загрузки файла, чтобы прикрепить его к сообщению или другой сущности API, необходимо сформировать путь файла. Для этого в поле key, полученном на этапе подписи, заменить шаблон $filename на фактическое имя файла. Пример: Если ваш файл называется Логотип для сайта.png, а в ответе на метод /uploads ключ был attaches/files/93746/e354-...-5e6f/$filename, итоговый ключ будет attaches/files/93746/e354-...-5e6f/Логотип для сайта.png.