Группы, с которыми чаще всего работают пользователи и интеграторы.
Точные схемы — в Scalar (/scalar).
/api/v0.1/clashes| Метод | Путь | Назначение | Кто |
|---|---|---|---|
GET |
/clashes |
Список | UI, BI, боты |
GET |
/clashes/{id} |
Одна коллизия | UI, интеграции |
PATCH |
/clashes/{id}/review-status |
Статус ревью | UI, автоматизация |
PATCH |
/clashes/{id}/severity |
Приоритет | UI |
GET/POST |
/clashes/{id}/image |
Картинка (MinIO) | UI, экспорт |
PUT |
/clashes/import/batch |
Импорт из Navis | Worker / плагин экспорта |
Полезные поля в ответе (упрощённо):
| Поле | Смысл |
|---|---|
info.id |
GUID коллизии |
info.tradeClash |
Номер / обозначение из Clash Detective |
info.testName |
Имя теста |
info.levelName, info.gridsIntersection, info.distance |
Локация / глубина |
status.reviewStatus |
Active, InWork, … |
status.clashSeverity |
Low … Critical |
status.checkDate |
Дата проверки |
items |
Элементы, участвующие в коллизии |
/api/v0.1/configuration| Метод | Путь | Назначение |
|---|---|---|
GET/PUT |
/server-settings |
Серверы и пути |
GET/PUT |
/export-settings |
Правила выгрузки NWC |
Обычно только веб и админы.
/api/v0.1/model-inventoryОтдельный сервис на Worker-контуре (проксируется для UI). Основные:
| Метод | Путь | Назначение |
|---|---|---|
GET |
/solution-tree |
Дерево моделей |
POST |
/solution-tree/refresh |
Обновить дерево |
GET |
/model-artifact-states |
Состояния артефактов |
GET |
/clash-matrices |
Матрицы коллизий |
/api/v0.1/navis-report| Метод | Путь | Назначение |
|---|---|---|
POST |
/queue |
Поставить генерацию отчёта в очередь |
Внутренний контур агентов (claim / heartbeat / complete). Для Power BI и
Telegram обычно не нужен; используйте список коллизий и статусы.
Наблюдаемость job для UI — отдельные read-эндпоинты (см. Scalar).
Чтение/запись коллизий и админ-операции завязаны на политики авторизации
и роли Keycloak. Анонимно в MVP остаются отдельные worker-callback’и —
их не используйте из внешних интеграций.