docs: update protocol — direct WS/REST access, remove BFF proxy references
- WS: two auth methods (query param JWT for web, auth message for agents) - URLs: /ws and /api/v1 directly (no more /agent-ws, /agent-api/) - Humans get all events without subscriptions
This commit is contained in:
parent
d3b9aead96
commit
300c6fa98e
@ -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=<JWT>`
|
||||
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}` (НЕ проверяется в текущей реализации для агентов)
|
||||
|
||||
|
||||
Loading…
Reference in New Issue
Block a user