Описание: Выгрузить один или несколько элементов в ZIP-архив. Папки экспортируются рекурсивно, с сохранением структуры вложенности как путей внутри архива; файлы добавляются как есть. Если у файла есть электронная подпись, поведение зависит от параметра mode:

  • Detached — рядом с файлом в архив добавляется файл(ы) подписи как отдельные записи (по одной на каждую подпись).
  • MergedDetached — все подписи файла объединяются в одну и добавляются как один отдельный файл подписи.
  • Embedded — это режим MergedDetached + в саму подпись включаются байты документа, отдельно файл документа не выгружается.

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

🌐 HTTP-информация

  • Метод: POST
  • URL: /api/export/ToZip/{mode}
  • Headers:
    • Content-Type: multipart/form-data
    • Authorization: <UserSessionToken>

📥 Параметры запроса (URL Path)

ПараметрТипОписание
modestringРежим включения электронных подписей в архив (число в виде строки): 0 - Detached, 1 - MergedDetached или 2 - Embedded (см. описание выше)

📦 Тело запроса (Request Body)

Тело передаётся как форма (multipart/form-data), а не JSON.

Поле формыТипОбяз.Описание
itemListJsonstringДаJSON-строка с массивом ID экспортируемых элементов (файлов и/или папок), например ["622dddbb-2db2-433d-9d3c-89f31ea22e64"]

📤 Тело ответа (Response Body)

Бинарный поток ZIP-архива (Content-Type: application/octet-stream, Content-Disposition: attachment). Имя файла архива формируется как <имя родительской папки первого элемента>_<дата_время>.zip.

  • No labels