Files

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

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

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

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

post/uploads

Request

  • Base URL: https://api.pachca.com/api/shared/v1
  • URL: https://api.pachca.com/api/shared/v1/uploads
  • Auth: HTTP bearer

Response

The request has succeeded and a new resource has been created as a result.

Content-Dispositionstring required

Используемый заголовок (в данном запросе — attachment)

aclstring required

Уровень безопасности (в данном запросе — private)

policystring required

Уникальная policy для загрузки файла

x-amz-credentialstring required

x-amz-credential для загрузки файла

x-amz-algorithmstring required

Используемый алгоритм (в данном запросе — AWS4-HMAC-SHA256)

x-amz-datestring required

Уникальный x-amz-date для загрузки файла

x-amz-signaturestring required

Уникальная подпись для загрузки файла

keystring required

Уникальный ключ для загрузки файла

direct_urlstring required

Адрес для загрузки файла

Example response

{
  "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"
}

Changes

No recorded changes to this operation across all 1 revision of this API.