Перейти к содержимому

Жизненный цикл задачи

Это «учебная» end-to-end история работы с задачей через API.

Окно терминала
curl -X POST -H "Authorization: Bearer $FW_KEY" -H "Content-Type: application/json" \
-d '{"projectId":123,"title":"Refactor auth handler","priority":2,"assigneeId":7}' \
https://api.flowworker.ru/api/public/v1/tasks

Ответ - созданная задача с version: 1. Запомните id и version.

Окно терминала
curl -i -H "Authorization: Bearer $FW_KEY" \
https://api.flowworker.ru/api/public/v1/tasks/9001

В ответе заголовок ETag: "1" (текущая версия) - используется в PATCH ниже.

Чтобы быть уверенным что никто не изменил задачу между вашим GET и PATCH, передайте версию в If-Match:

Окно терминала
curl -X PATCH \
-H "Authorization: Bearer $FW_KEY" \
-H "Content-Type: application/json" \
-H "If-Match: \"1\"" \
-d '{"status":"in-progress"}' \
https://api.flowworker.ru/api/public/v1/tasks/9001
  • Если версия совпадает - патч применяется, ответ содержит новый ETag: "2".
  • Если задача была изменена кем-то ещё - ответ 412 Precondition Failed с body {"error":{"code":"version_mismatch",...}} и ETag ответа = текущая версия. Прочитайте задачу, разрешите конфликт, повторите PATCH.

Если If-Match не указан - патч применяется без проверки версии (loose mode).

Когда вы меняете status (например todo → in-progress), сервер автоматически устанавливает KanbanOrder в max(target_lane) + 1024, то есть задача попадает в конец новой полосы канбана. Управление позицией внутри полосы пока не часть публичного API (только через UI).

DueDate нельзя «снять» отправкой null (System.Text.Json не различает «отсутствует» и «null»). Используйте флаг:

Окно терминала
curl -X PATCH \
-H "Authorization: Bearer $FW_KEY" \
-H "Content-Type: application/json" \
-d '{"clearDueDate":true}' \
https://api.flowworker.ru/api/public/v1/tasks/9001

Если в одном запросе пришли и DueDate и clearDueDate: true - clearDueDate выигрывает (очищает).

Окно терминала
curl -X DELETE -H "Authorization: Bearer $FW_KEY" \
https://api.flowworker.ru/api/public/v1/tasks/9001

Soft-delete (запись остаётся в БД с IsDeleted=true). Восстановление через публичный API не поддерживается.