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

Статусы задач

Каждая задача имеет поле statusKey - внутренний ключ статуса. Система поддерживает системные статусы и custom-слоты:

КлючОписаниеIsDone по умолчанию
TodoНовая задача, ещё не начатаfalse
InProgressВ работеfalse
DoneЗавершенаtrue
BlockedЗаблокированаfalse
Custom1 .. Custom12Кастомные слоты, название задаётся per-projectзависит от настройки

Проект может переопределить название и isDone для любого слота через настройки kanban-доски. Например, Custom1 может называться «На ревью» (isDone=false), а Custom3 - «Архив» (isDone=true).

Начиная с v2.0, поле status в PublicTaskDto - это объект, а не строка:

{
"id": 42,
"title": "Написать тесты",
"status": {
"key": "Custom1",
"label": "На ревью",
"isDone": false,
"color": "#f59e0b"
}
}
ПолеТипОписание
keystringСистемный ключ: Todo, InProgress, Done, Blocked, Custom1..Custom12
labelstringНазвание из настроек проекта или системное название по умолчанию
isDonebooleantrue если статус считается завершённым
colorstring | nullHEX-цвет из настроек проекта, либо null если цвет не задан
  • Override (из настроек проекта): если проект настроил название колонки, например «Беклог» вместо «Todo», или «На ревью» для Custom1 - в label придёт именно это название.
  • По умолчанию label содержит системное название. Для Todo это «К выполнению», для InProgress — «В работе», для Custom1 — Custom 1.

Для чтения isDone не полагайтесь только на системный список - используйте поле isDone из payload, так как custom-слоты могут быть настроены как «завершённые».

GET /api/public/v1/tasks/search?status=... поддерживает три формата и принимает несколько значений одновременно. Передайте их через запятую или повторите параметр:

GET /api/public/v1/tasks/search?status=open,blocked
GET /api/public/v1/tasks/search?status=open&status=blocked

Несколько значений объединяются через OR (задача включается в результат, если хотя бы один из статусов совпадает). Остальные фильтры при этом по-прежнему объединяются через AND.

Наиболее универсальный вариант - не зависит от конкретной конфигурации проекта:

AliasЧто возвращает
openВсе задачи, где isDone = false
closed или doneВсе задачи, где isDone = true
todoЗадачи со StatusKey Todo
in-progressЗадачи со StatusKey InProgress
blockedЗадачи со StatusKey Blocked
GET /api/public/v1/tasks/search?status=open
GET /api/public/v1/tasks/search?status=closed

Точный поиск по системному ключу:

GET /api/public/v1/tasks/search?status=InProgress
GET /api/public/v1/tasks/search?status=inprogress
GET /api/public/v1/tasks/search?status=Custom1

Поиск по названию колонки в конкретном проекте. Для точного результата укажите projectId:

GET /api/public/v1/tasks/search?status=На%20ревью&projectId=12
GET /api/public/v1/tasks/search?status=Беклог&projectId=5

Без projectId - first-match по аккаунту (если несколько проектов имеют колонку с одинаковым названием, результат может быть неожиданным).

  • Для general queries (все открытые, все закрытые) - используйте semantic aliases open/closed. Они корректно обрабатывают custom-слоты с нестандартным isDone.
  • Для конкретного project workflow - используйте label с projectId для точного scope: ?status=На%20ревью&projectId=12.
  • Для программных интеграций - читайте task.status.key, а не task.status.label (labels могут меняться при переименовании колонок).
  • Для отображения пользователю - используйте task.status.label и task.status.color.

См. также: Поиск задач и проектов.