smarty-trackerДата актуальности: 2026-06-18. Read-only документация.
Справочник REST-эндпоинтов, экспонируемых роутамиsmarty-backend-stable/smarty-tracker/routes/index.js.
Все маршруты подключены под префиксом /api/v2/ws/:_wsId/tracker. Полный путь:
/api/v2/ws/:_wsId/tracker + path createRoute
| Класс запроса | Описание |
|---|---|
EmployeeRequest |
Авторизованный сотрудник workspace. Создание/редактирование/удаление проектов -- ws-admin (manage_meta). Задачи/спринты/эпики/комментарии -- ws-member. |
Scrum/Agile-трекер на собственных сущностях. Проект (доска) владеет статусами workflow (колонками), задачами (issues), спринтами, эпиками и комментариями. Не трогает CRM-задачи (assignments).
| Метод | Путь | Auth | Назначение | Параметры |
|---|---|---|---|---|
GET |
/projects |
Employee | Список проектов | -- |
POST |
/projects |
Admin | Создать проект | body: key (required, 2-8 заглавных), name (required), description, leadId |
GET |
/projects/:projectId |
Employee | Проект + статусы + спринты + эпики | -- |
PATCH |
/projects/:projectId |
Admin | Обновить проект | body: name, description, leadId, archived |
DELETE |
/projects/:projectId |
Admin | Удалить проект (мягкое) | -- |
Примечание: при создании проекта автоматически создаются 4 дефолтных статуса workflow: "К работе", "В работе", "На ревью", "Готово".
| Метод | Путь | Auth | Назначение | Параметры |
|---|---|---|---|---|
GET |
/projects/:projectId/issues |
Employee | Список задач проекта | query: sprint (backlog или ObjectId), status, epic, type, assignee |
POST |
/issues |
Employee | Создать задачу | body: projectId (required), title (required), type, priority, statusId, assigneeId, reporterId, sprintId, epicId, parentId, storyPoints, labels[], startDate, endDate, dueDate, description |
GET |
/issues/:issueId |
Employee | Задача + комментарии | -- |
PATCH |
/issues/:issueId |
Employee | Обновить задачу | body: title, description, type, priority, statusId, assigneeId, sprintId, epicId, parentId, storyPoints, labels[], dueDate |
DELETE |
/issues/:issueId |
Employee | Удалить задачу (мягкое) | -- |
POST |
/issues/:issueId/move |
Employee | Перемещение задачи (статус + rank) | body: statusId, beforeId, afterId |
POST |
/issues/:issueId/comments |
Employee | Добавить комментарий | body: body (required, max 5000) |
Типы задач: epic, story, task, bug, subtask.
Приоритеты: low, medium, high, critical.
Ключ: генерируется автоматически как {PROJECT_KEY}-{seq}.
| Метод | Путь | Auth | Назначение | Параметры |
|---|---|---|---|---|
GET |
/projects/:projectId/sprints |
Employee | Список спринтов проекта | -- |
POST |
/sprints |
Employee | Создать спринт | body: projectId (required), name (required), goal, startDate, endDate |
PATCH |
/sprints/:sprintId |
Employee | Обновить спринт | body: name, goal, startDate, endDate, state |
DELETE |
/sprints/:sprintId |
Employee | Удалить спринт (отвязывает задачи) | -- |
POST |
/sprints/:sprintId/start |
Employee | Начать спринт (state -> active) | -- |
POST |
/sprints/:sprintId/complete |
Employee | Завершить спринт | body: moveOpenTo (optional ObjectId -- куда перенести открытые) |
Состояния спринта: planned, active, completed.
| Метод | Путь | Auth | Назначение | Параметры |
|---|---|---|---|---|
GET |
/projects/:projectId/epics |
Employee | Список эпиков проекта | -- |
POST |
/epics |
Employee | Создать эпик | body: projectId (required), name (required), color (#RRGGBB), startDate, endDate |
PATCH |
/epics/:epicId |
Employee | Обновить эпик | body: name, color, startDate, endDate, state |
DELETE |
/epics/:epicId |
Employee | Удалить эпик (отвязывает задачи) | -- |
Состояния эпика: open, done.