WebSocket - Enot Messenger

Подключение к WebSocket

WebSocket используется для real-time обновлений: новые сообщения, голосовые звонки, изменения серверов и каналов.

Endpoint

wss://api.enot.space/ws?token=YOUR_JWT_TOKEN

Пример подключения (JavaScript)

                        const token = localStorage.getItem('token');
const ws = new WebSocket(`wss://api.enot.space/ws?token=${token}`);

ws.onopen = () => {
    console.log('WebSocket connected');
};

ws.onmessage = (event) => {
    const message = JSON.parse(event.data);
    console.log('Received:', message);
};

ws.onerror = (error) => {
    console.error('WebSocket error:', error);
};

ws.onclose = () => {
    console.log('WebSocket disconnected');
};
                    

Важно: JWT токен должен быть валидным. При истечении токена WebSocket соединение будет закрыто.

Типы сообщений

Все WebSocket сообщения имеют поле type, определяющее тип события.

Тип	Направление	Описание
`ping`	Client → Server	Проверка соединения
`pong`	Server → Client	Ответ на ping
`subscribe`	Client → Server	Подписка на канал
`unsubscribe`	Client → Server	Отписка от канала
`message_new`	Server → Client	Новое сообщение в канале
`message_update`	Server → Client	Сообщение отредактировано
`message_delete`	Server → Client	Сообщение удалено
`voice_state_update`	Client → Server	Обновление голосового состояния
`voice_state_add`	Server → Client	Пользователь подключился к голосовому каналу
`voice_state_remove`	Server → Client	Пользователь отключился от голосового канала
`webrtc_signal`	Bidirectional	WebRTC signaling (offer, answer, ICE)

Подписка на каналы

Чтобы получать сообщения из канала, необходимо подписаться на него.

Отписка

                        ws.send(JSON.stringify({
    type: 'unsubscribe',
    channel_id: 123
}));
                    

Совет: Подписывайтесь только на активные каналы для экономии трафика.

События сообщений

Новое сообщение

                        {
    "type": "message_new",
    "data": {
        "id": 456,
        "channel_id": 123,
        "user_id": 1,
        "content": "Привет!",
        "created_at": "2026-05-05T18:00:00Z",
        "author": {
            "id": 1,
            "username": "user",
            "display_name": "User#1234"
        }
    }
}
                    

Сообщение отредактировано

                        {
    "type": "message_update",
    "data": {
        "id": 456,
        "channel_id": 123,
        "content": "Привет, мир!",
        "edited_at": "2026-05-05T18:05:00Z"
    }
}
                    

Сообщение удалено

                        {
    "type": "message_delete",
    "data": {
        "id": 456,
        "channel_id": 123
    }
}
                    

Голосовые события

Подключение к голосовому каналу

                        ws.send(JSON.stringify({
    type: 'voice_state_update',
    channel_id: 123,
    muted: false,
    deafened: false,
    screen_sharing: false
}));
                    

Пользователь подключился

                        {
    "type": "voice_state_add",
    "data": {
        "user_id": 2,
        "channel_id": 123,
        "muted": false,
        "deafened": false,
        "screen_sharing": false,
        "display_name": "User#5678"
    }
}
                    

WebRTC Signaling

                        // Отправка offer
ws.send(JSON.stringify({
    type: 'webrtc_signal',
    to_user_id: 2,
    signal_type: 'offer',
    data: {
        sdp: '...',
        type: 'offer'
    }
}));

// Получение answer
{
    "type": "webrtc_signal",
    "from_user_id": 2,
    "signal_type": "answer",
    "data": {
        "sdp": "...",
        "type": "answer"
    }
}
                    

Rate Limiting

WebSocket сообщения также подвержены rate limiting:

60-120 сообщений в минуту на пользователя
При превышении лимита соединение будет закрыто
Используйте debounce для частых обновлений

Best Practices

Реализуйте автоматическое переподключение с exponential backoff
Отправляйте ping каждые 30 секунд для поддержания соединения
Обрабатывайте все типы событий gracefully
Подписывайтесь только на активные каналы
Используйте валидацию сообщений на клиенте
Храните состояние локально для offline режима

🦝 Enot Messenger

WebSocket API