Метод «Заменить содержимое задачи»¶
Endpoint: POST {hostname}/dh-tasks-service/api/v3/tasks/{id}/replace
Метод позволяет обновить параметры задачи, которая была создана ранее и которая находится в процессе выполнения. Все связанные с задачей отчеты переводятся в статус «Не активен».
Более подробное описание метода находится в yaml файле «tasks_service», который расположен в папке с документацией.
Маппинг параметров запроса
| Входящие параметры** | Способ передачи параметров | Требования к заполнению |
|---|---|---|
| Idempotency-Key | Header | Ключ уникальности запроса |
| id | Path | Идентификатор родительской задачи (id), полученный методом GET {hostname}/dh-tasks-service/api/v3/tasks |
| taskRecordNumber | Body | Версия задачи, к которой относится запрос. Если не указана, используется последняя версия |
| name | Body | Наименование задачи |
| dueDate | Body | Требуемая дата выполнения задачи |
| followUpDate | Body | Время напоминания о задаче |
| assignee | Body | Текущий исполнитель задачи |
| candidateGroups | Body | Список групп, в который входят кандидаты для исполнителей |
| candidateUsers | Body | Список кандидатов для исполнителей |
| reportReceivers | Body | Список получателей отчета (логины пользователей) |
| reportReceiversGroups | Body | Список получателей отчета (список групп пользователей) |
| initiator | Body | Логин пользователя, являющегося поручителем по задаче |
| data: · additionalProp1 · additionalProp2 · additionalProp3 |
Body | Дополнительные поля задачи |
Пример запроса:
curl --location 'https://docshouse-dev.k8s.lan.lanit.ru/dh-tasks-service/api/v3/tasks/b2eb669d-d5e6-4003-8dcd-ed8312a72d8d/replace' \
-header 'accept: application/json' \
-header 'Content-Type: application/json' \
-data '{
"taskRecordNumber": 1,
"name": "test",
"dueDate": "2025-03-30T10:05:06.232Z",
"followUpDate": "2025-03-30T10:05:06.232Z",
"assignee": "ivanovp",
"candidateGroups": [
"testGroup"
],
"candidateUsers": [
"usertest"
],
"reportReceivers": [
"usertest2"
],
"reportReceiversGroups": [
"testGroup2"
],
"initiator": "borisov",
"data": {
"additionalProp1": "string",
"additionalProp2": "string",
"additionalProp3": "string"
},
}'