[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 | Обязательный | Бинарный поток файла |
Ограничения и проверки
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
}
}