Сохранение файлов в архив

Запрос: POST /archive

HTTP-заголовки:

Authorization: Bearer access_token
Content-Type: multipart/form-data
Accept: application/json

Тело запроса состоит из двух частей. Описательная часть называется json и содержит JSON с информацией о сохраняемом файле:

{
    "FileName": "string",
    "AttachmentType": 0,
    "DocumentId": "guid"
}

Содержательная часть называется content и в ней передается массив байт сохраняемого файла.

Описание запроса

Запрос позволяет сохранить файл в архиве.

Файл сохраняется с определенным именем, типом вложения и привязкой к документу. Эта информация является контекстной и обрабатывается в зависимости от функциональных возможностей выбранной реализации архива.

Имя файла задается в поле FileName.

Тип вложения задается в поле AttachmentType. Перечень типов вложений можно запросить, выполнив справочный запрос к Integration API.

Поле DocumentId привязывает файл к документу с заданным идентификатором.

Проверка на дубликаты

Archive API не позволяет сохранять дубликаты файлов в архив.

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

Ответ на запрос

В случае успешного выполнения запроса возвращается ссылка на файл в архиве в виде строки. Формат ссылки зависит от выбранной реализации архива.