Жизненный цикл задачи
Это «учебная» end-to-end история работы с задачей через API.
1. Create
Заголовок раздела «1. Create»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.
2. Get с ETag
Заголовок раздела «2. Get с ETag»curl -i -H "Authorization: Bearer $FW_KEY" \ https://api.flowworker.ru/api/public/v1/tasks/9001В ответе заголовок ETag: "1" (текущая версия) - используется в PATCH ниже.
3. Patch с If-Match (опт. конкурентность)
Заголовок раздела «3. Patch с If-Match (опт. конкурентность)»Чтобы быть уверенным что никто не изменил задачу между вашим 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).
4. Изменение статуса и lane
Заголовок раздела «4. Изменение статуса и lane»Когда вы меняете status (например todo → in-progress), сервер автоматически устанавливает KanbanOrder в max(target_lane) + 1024, то есть задача попадает в конец новой полосы канбана. Управление позицией внутри полосы пока не часть публичного API (только через UI).
5. Очистка DueDate
Заголовок раздела «5. Очистка DueDate»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 выигрывает (очищает).
6. Delete
Заголовок раздела «6. Delete»curl -X DELETE -H "Authorization: Bearer $FW_KEY" \ https://api.flowworker.ru/api/public/v1/tasks/9001Soft-delete (запись остаётся в БД с IsDeleted=true). Восстановление через публичный API не поддерживается.