09.03.2026 16:45

Add

[POST] …/v1/doccontractfile/add

Прикрепляет новый файл к договору.

Метод поддерживает два формата запроса:

  • application/json для обратной совместимости, когда файл передаётся в data как Base64.
  • multipart/form-data для потоковой загрузки бинарного файла.

Входные параметры

Для application/json:

Название Тип данных Обязательность Описание
contract_id Int64 Обязательный ID договора
name String Обязательный Наименование файла
extension String Обязательный Расширение файла
data String Обязательный Данные файла в формате Base64

Для multipart/form-data:

Название Тип данных Обязательность Описание
contract_id Int64 Обязательный ID договора
name String Необязательный Имя файла. Если не передано, сервер возьмёт его из имени загружаемого файла
extension String Необязательный Расширение файла. Если не передано, сервер возьмёт его из имени загружаемого файла
file File Обязательный Бинарный поток файла

Ограничения и проверки

  • Метод принимает только один файл за запрос.
  • Для JSON-режима обязательны name, extension, data.
  • Для multipart/form-data обязателен file; name и extension можно не передавать, если они есть в имени файла.

Пример запроса

{
    "contract_id": 1,
    "name": "example",
    "extension": "docx",
    "data": "dataexample"
}

Пример multipart-запроса

curl -X POST "https://example.com/v1/doccontractfile/add" \
  -H "Authorization: Bearer <token>" \
  -F "contract_id=1" \
  -F "file=@example.docx"

Выходные параметры

Название Тип данных Описание
new_id Int64 ID созданной связи файла с договором

Пример ответа

{
    "ok": true,
    "result": {
        "new_id": 1
    }
}