Поиск задач и проектов
Поиск задач
Заголовок раздела «Поиск задач»GET /api/public/v1/tasks/search - find задачи по тексту + базовым фильтрам. Все фильтры опциональны, объединяются через AND. Требует scope tasks:read.
| Параметр | Тип | Описание |
|---|---|---|
q | string (max 200) | Подстрока в title, case-insensitive |
status | string (repeatable) | Принимает 3 формата (см. Status в payload): Semantic alias (lowercase): open (все !done), closed/done (все done), todo, in-progress, blocked. System key (case-insensitive): Todo, InProgress, Done, Blocked, Custom1..Custom12. Per-project label: точное название колонки в kanban проекта (например На ревью). Требует projectId для точного scope (иначе first-match по аккаунту). Multiple statuses: передайте несколько значений через запятую (?status=open,blocked) или повторите параметр (&status=open&status=blocked). |
createdAfter | ISO-8601 datetime | Задачи, созданные после указанного момента (включительно). Пример: 2026-01-01T00:00:00Z. |
createdBefore | ISO-8601 datetime | Задачи, созданные до указанного момента (включительно). |
dueAfter | ISO-8601 datetime | Задачи, у которых dueDate >= значение. |
dueBefore | ISO-8601 datetime | Задачи, у которых dueDate <= значение. |
sortBy | string | Поле для сортировки: id (default), createdAt, updatedAt, dueDate, title. |
sortDir | string | Направление сортировки: desc (default), asc. |
assignee | int (repeatable) | userId исполнителя. Multi-value: ?assignee=5,7 или &assignee=5&assignee=7 - OR. |
projectId | int (repeatable) | ID проекта. Multi-value: ?projectId=10,20 - OR. |
tag | string (repeatable, max 50) | Ключ тега. Multi-value: ?tag=urgent,critical - OR (matches если ЛЮБОЙ из tags present). |
page | int (>=1) | Default 1 |
pageSize | int (1..200) | Default 50 |
Примеры
Заголовок раздела «Примеры»GET /api/public/v1/tasks/search?q=отчёт&status=InProgressGET /api/public/v1/tasks/search?assignee=12&projectId=5&page=2GET /api/public/v1/tasks/search?q=API&pageSize=100GET /api/public/v1/tasks/search?status=open - все незакрытыеGET /api/public/v1/tasks/search?status=closed - все закрытые (system Done + custom done)GET /api/public/v1/tasks/search?status=На%20ревью&projectId=12 - все из колонки «На ревью» в проекте 12GET /api/public/v1/tasks/search?status=Custom1 - задачи с конкретным слотом Custom1
# Multiple statusesGET /api/public/v1/tasks/search?status=open,blockedGET /api/public/v1/tasks/search?status=open&status=blocked
# Multi-value assignee (OR)GET /api/public/v1/tasks/search?assignee=5,7GET /api/public/v1/tasks/search?assignee=5&assignee=7
# Multi-value projectId (OR)GET /api/public/v1/tasks/search?projectId=10,20
# Tag filter (OR within tag values)GET /api/public/v1/tasks/search?tag=urgentGET /api/public/v1/tasks/search?tag=urgent,critical
# Date ranges + status + sortingGET /api/public/v1/tasks/search?createdAfter=2026-01-01T00:00:00Z&status=closed&sortBy=updatedAt&sortDir=descGET /api/public/v1/tasks/search?status=open,blocked&dueBefore=2026-06-01T00:00:00Z&sortBy=dueDateОтвет - { items: PublicTaskDto[], page, pageSize, total }. Сортировка по умолчанию: id DESC (новые первыми); задаётся через sortBy/sortDir.
Поиск проектов
Заголовок раздела «Поиск проектов»GET /api/public/v1/projects/search - Требует scope projects:read.
| Параметр | Тип | Описание |
|---|---|---|
q | string (max 200) | Подстрока в name, case-insensitive |
status | string | active (default включает все non-deleted active) или archived |
page/pageSize | int | Pagination как в tasks/search |
GET /api/public/v1/projects/search?q=инфраGET /api/public/v1/projects/search?status=archivedВсе условия объединяются через AND; внутри каждого multi-value фильтра (status, assignee, projectId, tag) действует OR. Порядок результатов задаётся через sortBy/sortDir.
Если нужны дополнительные возможности - напишите в support.