Карта API

Общие правила

• Базовый префикс: /api/v2/management.
• Все write endpoints требуют authenticated actor и permission.
• Все списки поддерживают page, perPage, sort, filters.
• Все команды, которые могут быть повторены клиентом или worker, принимают Idempotency-Key.
• Drill-down links не возвращают данные исходного домена, а отдают ссылку и проверяемый контекст.
• Ошибки возвращаются в общем envelope из identity/API Gateway.

Metrics

Endpoint	Метод	Permission	Назначение
/metrics	GET	management.metrics.read	список метрик
/metrics	POST	management.metrics.manage	создать метрику
/metrics/{metricId}	GET	management.metrics.read	карточка метрики
/metrics/{metricId}	PATCH	management.metrics.manage	изменить метаданные
/metrics/{metricId}/versions	GET	management.metrics.read	версии формулы
/metrics/{metricId}/versions	POST	management.metrics.manage	новая версия формулы
/metrics/{metricKey}/values	GET	management.metrics.read	значения метрики
/metrics/{metricKey}/recalculate	POST	management.metrics.recalculate	запросить пересчёт

Dashboards

Endpoint	Метод	Permission	Назначение
/dashboards	GET	management.dashboards.read	доступные dashboards
/dashboards	POST	management.dashboards.manage	создать dashboard
/dashboards/{dashboardId}	GET	management.dashboards.read	dashboard с widgets
/dashboards/{dashboardId}	PATCH	management.dashboards.manage	изменить dashboard
/dashboards/{dashboardId}/publish	POST	management.dashboards.publish	опубликовать
/dashboards/{dashboardId}/widgets	POST	management.dashboards.manage	добавить widget
/widgets/{widgetId}	PATCH/DELETE	management.dashboards.manage	изменить или удалить widget
/dashboards/{dashboardId}/saved-views	GET/POST	management.dashboards.read	пользовательские views

Plans

Endpoint	Метод	Permission	Назначение
/plans	GET	management.plans.read	список планов
/plans	POST	management.plans.manage	создать план
/plans/{planId}	GET	management.plans.read	карточка плана
/plans/{planId}	PATCH	management.plans.manage	изменить план
/plans/{planId}/status	PATCH	management.plans.manage	изменить статус
/plans/{planId}/targets	POST	management.plans.manage	добавить цель
/plan-targets/{targetId}/facts	GET	management.plans.read	plan-fact история
/plans/{planId}/tasks	GET/POST	management.tasks.read/manage	связанные задачи

Tasks

Endpoint	Метод	Permission	Назначение
/tasks	GET	management.tasks.read	список задач
/tasks	POST	management.tasks.manage	создать задачу
/tasks/{taskId}	GET	management.tasks.read	карточка
/tasks/{taskId}	PATCH	management.tasks.manage	редактировать
/tasks/{taskId}/status	PATCH	management.tasks.manage	сменить статус
/tasks/{taskId}/comments	GET/POST	management.tasks.read/comment	комментарии
/tasks/{taskId}/history	GET	management.tasks.read	история изменений
/task-templates	GET/POST	management.admin	шаблоны задач

Alerts

Endpoint	Метод	Permission	Назначение
/alert-rules	GET/POST	management.alerts.manage	правила alerts
/alert-rules/{ruleId}	GET/PATCH	management.alerts.manage	карточка правила
/alerts	GET	management.alerts.read	список alerts
/alerts/{alertId}	GET	management.alerts.read	карточка alert
/alerts/{alertId}/acknowledge	POST	management.alerts.manage	подтвердить
/alerts/{alertId}/resolve	POST	management.alerts.manage	закрыть
/alerts/{alertId}/create-task	POST	management.tasks.manage	создать задачу

Data quality

Endpoint	Метод	Permission	Назначение
/data-sources	GET/POST	management.data_sources.manage	источники
/data-sources/{sourceId}	GET/PATCH	management.data_sources.manage	карточка источника
/ingestion-runs	GET	management.data_quality.read	загрузки
/data-quality/issues	GET	management.data_quality.read	проблемы данных
/data-quality/issues/{issueId}/acknowledge	POST	management.data_quality.manage	подтвердить
/data-quality/issues/{issueId}/resolve	POST	management.data_quality.manage	закрыть

Management actions

Endpoint	Метод	Permission	Назначение
/goal-profiles	GET/POST	management.goals.read/manage	профили целей
/goals	GET/POST	management.goals.read/manage	цели
/goals/{goalId}/activate	POST	management.goals.manage	активировать цель
/recommendations	GET	management.recommendations.read	рекомендации
/recommendations/{recommendationId}/publish	POST	management.recommendations.publish	опубликовать рекомендацию
/recommendations/{recommendationId}/dismiss	POST	management.recommendations.dismiss	отклонить рекомендацию
/diagnostics	GET/POST	management.diagnostics.read/manage	диагностики
/actions	POST	management.actions.execute	запустить действие
/actions/{actionId}	GET	management.actions.read	статус действия
/actions/{actionId}/retry	POST	management.actions.execute	повторить failed действие

Admin

Endpoint	Метод	Permission	Назначение
/settings	GET/PATCH	management.admin	настройки домена
/audit-logs	GET	management.audit.read	аудит
/exports	POST	management.exports.create	экспорт отчёта

Error codes

Код	HTTP	Когда
management.metric.not_found	404	метрика не найдена
management.metric.version_required	400	изменение формулы без версии
management.dashboard.not_publishable	409	dashboard нельзя опубликовать
management.plan.invalid_status	409	недопустимый переход плана
management.task.invalid_status	409	недопустимый переход задачи
management.alert.already_resolved	409	alert уже закрыт
management.data_source.unavailable	503	источник недоступен
management.sensitivity.forbidden	403	sensitivity запрещает доступ