.. _Integration_ArchiveApi_SavingFilesToArchive:

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

| Запрос: ``POST /archive``
| HTTP-заголовки:

.. code-block::

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

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

.. code-block:: JSON

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

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

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

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

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

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

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

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

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

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

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

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

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