Gateway

Перед WebSocket-подключением стоит запросить актуальный адрес и лимиты сессий. Для этого есть один эндпоинт — GET /gateway/bot. Он доступен только с Bot-токеном.

GET /api/v1/gateway/bot

Требует: Authorization: Bot <token>

curl https://floodilka.com/api/v1/gateway/bot \
  -H "Authorization: Bot ВАШ_БОТ_ТОКЕН"

Ответ

{
  "url": "wss://gateway.floodilka.com",
  "shards": 1,
  "session_start_limit": {
    "total": 1000,
    "remaining": 999,
    "reset_after": 14400000,
    "max_concurrency": 1
  }
}

Поле	Тип	Описание
url	string	WSS-адрес для подключения. Добавляйте к нему query-параметры: ?v=1&encoding=json
shards	integer	Рекомендованное число шардов. Для маленьких ботов — всегда 1
session_start_limit.total	integer	Всего новых IDENTIFY в окне
session_start_limit.remaining	integer	Осталось в текущем окне
session_start_limit.reset_after	integer	Миллисекунды до сброса окна
session_start_limit.max_concurrency	integer	Сколько новых IDENTIFY можно отправить параллельно

Зачем эти лимиты?

Они защищают кластер от шторма ботов, которые в цикле reconnect → IDENTIFY → crash выжирают ресурсы. Нормально работающий клиент делает 1-2 IDENTIFY за сессию и никогда не упирается в лимит. Если упёрлись — смотрите логи, скорее всего где-то бесконечный реконнект.

Что дальше

• Обзор Gateway — как подключиться с полученным URL
• Жизненный цикл соединения — IDENTIFY, READY, heartbeat