API: поиск, отчеты, файлы, уведомления и личные данные

Главная / Документация / APIAPI: поиск, отчеты, файлы, уведомления и личные данныеПоиск, отчеты, файлы, уведомления: полный перечень из 31 методов с параметрами и схемами тел.Обновлено 24.06.2026Пути - без префикса `/api/v1`. Детальные схемы - в `/api/docs`.Поиск (`/search`)

Метод

Путь

Назначение

GET

`/search?q=...&limit=N`

Глобальный поиск (минимум 2 символа), результаты по типам сущностей

Готовые отчеты (`/reports`)GET-эндпоинты: `/portfolio-status`, `/evm`, `/milestones`, `/execution-discipline`, `/approval-timing`, `/overdue-docs`, `/correspondence-register`, `/document-volume`, `/problem-projects`, `/overdue`, `/portfolio-tasks`, `/budget-analytics`. Перечень доступных пользователю: `/reports/visible-keys`. PDF-выгрузка: `/reports/{portfolio-status|problem-projects|overdue|portfolio-tasks|budget-analytics}/pdf`. Доступ - право `reports.read` и видимость по ролям.Конструктор отчетов (`/report-builder`)

Метод

Путь

Право

GET

`/report-builder/datasets`

по доступу

GET

`/report-builder/definitions`

по доступу

GET

`/report-builder/definitions/{key}`

по доступу

POST

`/report-builder/definitions/{key}/run`

по доступу

POST

`/report-builder/preview`

`report_builder.manage`

POST

`/report-builder/definitions`

`report_builder.manage`

PUT

`/report-builder/definitions/{key}`

`report_builder.manage`

DELETE

`/report-builder/definitions/{key}`

`report_builder.manage`

Файлы (`/files`)

Метод

Путь

Назначение

GET

`/files/download`

Скачивание файла

GET

`/files/{full_path}`

Доступ к файлу по пути в хранилище

Уведомления (`/notifications`)

Метод

Путь

Назначение

GET

`/notifications`

Список

GET

`/notifications/unread-count`

Число непрочитанных

PATCH

`/notifications/{notification_id}/read`

Отметить прочитанным

POST

`/notifications/mark-all-read`

Отметить все прочитанными

GET/PUT

`/notifications/settings`

Настройки уведомлений

POST

`/notifications/telegram/link`

Привязка Telegram

POST

`/notifications/telegram/verify`

Подтверждение привязки

POST

`/notifications/telegram/unlink`

Отвязка

Справочники и предпочтения

Метод

Путь

Назначение

GET

`/reference/enums`

Перечисления системы (статусы, типы)

GET/PUT

`/users/me/preferences`

Личные предпочтения интерфейса

Профиль и 2FA (`/me`)

Метод

Путь

Назначение

GET/PUT

`/me/profile`

Профиль

GET

`/me/activity`

История действий

POST/DELETE

`/me/avatar`

Фотография

GET

`/me/2fa/status`

Статус 2FA

POST

`/me/2fa/setup`

Начать настройку 2FA

POST

`/me/2fa/verify`

Подтвердить и включить 2FA

POST

`/me/2fa/disable`

Отключить 2FA (с паролем)

GET

`/me/2fa/backup-codes/info`

Состояние резервных кодов

POST

`/me/2fa/backup-codes/regenerate`

Перегенерация резервных кодов

Дашборд проекта

Метод

Путь

Назначение

GET

`/projects/{project_id}/s-curve`

S-кривая проекта

GET

`/project-health/summary`

Сводка здоровья проектов

GET

`/project-health/{project_id}`

Здоровье проекта

Трудозатраты и табели (`/me/timesheet`, `/timesheet/approvals`)

Метод

Путь

Назначение

GET

`/me/timesheet`

Сетка периода

PUT

`/me/timesheet/entry`

Запись часов

DELETE

`/me/timesheet/entry/{entry_id}`

Удалить запись

GET

`/me/timesheet/periods`

Периоды

POST

`/me/timesheet/periods/{period_id}/submit`

Отправить на согласование

POST

`/me/timesheet/periods/{period_id}/recall`

Отозвать

GET

`/me/timesheet/periods/{period_id}/segments`

Сегменты периода

GET

`/timesheet/approvals/pending`

Сегменты на согласование

POST

`/timesheet/approvals/{segment_id}/approve`

Согласовать сегмент

POST

`/timesheet/approvals/{segment_id}/reject`

Отклонить сегмент

Отсутствия

Метод

Путь

Право

GET

`/me/absences`

сессия

GET

`/absences`

сессия (календарь команды)

GET

`/people/{person_id}/absences`

сессия

POST

`/people/{person_id}/absences`

`employees.update`

PUT

`/absences/{absence_id}`

`employees.update`

DELETE

`/absences/{absence_id}`

`employees.update`

Роадмап

Метод

Путь

Назначение

GET

`/admin/roadmap`

План развития продукта

См. также: профильные статьи `guide-reports`, `guide-timesheet`, `guide-absences`, `guide-profile`.Документация соответствует версии продукта 0.9.0. Дата проверки: 2026-06-23.

Интеграции и REST API

Функциональная карта