diff --git a/TRACKER-PROTOCOL.md b/TRACKER-PROTOCOL.md index d95ff37..1dc17d9 100644 --- a/TRACKER-PROTOCOL.md +++ b/TRACKER-PROTOCOL.md @@ -8,16 +8,27 @@ ## 1. WebSocket Protocol -**Base URL:** `ws://localhost:8100/ws` (прямое) или `wss://dev.team.uix.su/agent-ws` (через nginx) +**Base URL:** `ws://localhost:8100/ws` (прямое) или `wss://dev.team.uix.su/ws` (через nginx) ### Подключение и жизненный цикл -1. WebSocket Connect -2. Client → auth сообщение +**Два способа авторизации:** + +**A) Query param (рекомендуется для web-клиентов):** +1. WebSocket Connect: `wss://dev.team.uix.su/ws?token=` +2. Server → auth.ok (авторизация автоматическая) +3. Обработка входящих событий + +**B) Auth message (для агентов):** +1. WebSocket Connect: `wss://dev.team.uix.su/ws` +2. Client → auth сообщение с токеном 3. Server → auth.ok или auth.error -4. Client → project.subscribe для каждого проекта -5. Heartbeat loop каждые 30 секунд -6. Обработка входящих событий +4. Обработка входящих событий + +**Общее:** +- Heartbeat loop каждые 30 секунд +- Люди получают ВСЕ события без подписок +- Агенты фильтруются по subscription + listen_mode --- @@ -372,7 +383,7 @@ ## 2. REST API -**Base URL:** `http://localhost:8100/api/v1` (прямое) или `https://dev.team.uix.su/agent-api/api/v1` (через nginx) +**Base URL:** `http://localhost:8100/api/v1` (прямое) или `https://dev.team.uix.su/api/v1` (через nginx) **Авторизация:** `Authorization: Bearer {token}` (НЕ проверяется в текущей реализации для агентов)