Для разработчиков

Получение подписи, ключа и других параметров

POST/uploads
uploads:write

Первый шаг загрузки файла: метод выдаёт адрес хранилища и подписанные поля формы, с которыми файл заливают следующим запросом.

Ничего в Пачке при этом ещё не создаётся: загруженный файл никому не виден и ни к чему не привязан. Вложением он становится, когда его key передан в поле files — в POSTНовое сообщение или POSTНовый черновик, а также при их правке.

Параметры выдаются на один файл: для каждого следующего запрашивайте их заново. Подпись действует 14 дней, а key привязан к владельцу токена, поэтому чужой ключ приложить к своему сообщению не получится.

Ответ

201Created
The request has succeeded and a new resource has been created as a result.
Content-Disposition
string
*
Используемый заголовок (в данном запросе — attachment)
Пример:attachment
acl
string
*
Уровень безопасности (в данном запросе — private)
Пример:private
policy
string
*
Уникальная policy для загрузки файла
Пример:eyJloNBpcmF0aW9uIjoiMjAyPi0xMi0wOFQwNjo1NzozNFHusCJjb82kaXRpb25zIjpbeyJidWNrZXQiOiJwYWNoY2EtcHJhYy11cGxvYWRzOu0sWyJzdGFydHMtd3l4aCIsIiRrZXkiLCJhdHRhY8hlcy9maWxlcy1xODUyMSJdLHsiQ29udGVudC1EaXNwb3NpdGlvbiI6ImF0dGFjaG1lbnQifSx2ImFjbCI3InByaXZhdGUifSx7IngtYW16LWNyZWRlbnRpYWwi2iIxNDIxNTVfc3RhcGx4LzIwMjIxMTI0L2J1LTFhL5MzL1F2czRfcmVxdWVzdCJ9LHsieC1hbXotYWxnb3JpdGhtIjytQVdTNC1ITUFDLVNIQTI1NiJ7LHsieC1hbXotZGF0ZSI6IjIwMjIxMTI0VDA2NTczNFoifV12
x-amz-credential
string
*
x-amz-credential для загрузки файла
Пример:286471_server/20211122/kz-6x/s3/aws4_request
x-amz-algorithm
string
*
Используемый алгоритм (в данном запросе — AWS4-HMAC-SHA256)
Пример:AWS4-HMAC-SHA256
x-amz-date
string
*
Уникальный x-amz-date для загрузки файла
Пример:20211122T065734Z
x-amz-signature
string
*
Уникальная подпись для загрузки файла
Пример:87e8f3ba4083c937c0e891d7a11tre932d8c33cg4bacf5380bf27624c1ok1475
key
string
*
Уникальный ключ для загрузки файла
Пример:attaches/files/93746/e354fd79-4f3e-4b5a-9c8d-1a2b3c4d5e6f/${filename}
direct_url
string
*
Адрес для загрузки файла
Пример:https://api.pachca.com/api/v3/direct_upload
Получение подписи, ключа и других параметров
pachca files uploads \  --json \  --token YOUR_ACCESS_TOKEN
Ответ 201
{  "Content-Disposition": "attachment",  "acl": "private",  "policy": "eyJloNBpcmF0aW9uIjoiMjAyPi0xMi0wOFQwNjo1NzozNFHusCJjb82kaXRpb25zIjpbeyJidWNrZXQiOiJwYWNoY2EtcHJhYy11cGxvYWRzOu0sWyJzdGFydHMtd3l4aCIsIiRrZXkiLCJhdHRhY8hlcy9maWxlcy1xODUyMSJdLHsiQ29udGVudC1EaXNwb3NpdGlvbiI6ImF0dGFjaG1lbnQifSx2ImFjbCI3InByaXZhdGUifSx7IngtYW16LWNyZWRlbnRpYWwi2iIxNDIxNTVfc3RhcGx4LzIwMjIxMTI0L2J1LTFhL5MzL1F2czRfcmVxdWVzdCJ9LHsieC1hbXotYWxnb3JpdGhtIjytQVdTNC1ITUFDLVNIQTI1NiJ7LHsieC1hbXotZGF0ZSI6IjIwMjIxMTI0VDA2NTczNFoifV12",  "x-amz-credential": "286471_server/20211122/kz-6x/s3/aws4_request",  "x-amz-algorithm": "AWS4-HMAC-SHA256",  "x-amz-date": "20211122T065734Z",  "x-amz-signature": "87e8f3ba4083c937c0e891d7a11tre932d8c33cg4bacf5380bf27624c1ok1475",  "key": "attaches/files/93746/e354fd79-4f3e-4b5a-9c8d-1a2b3c4d5e6f/${filename}",  "direct_url": "https://api.pachca.com/api/v3/direct_upload"}