Skip to content
Floodilka · Bots

Gateway

Before opening a WebSocket you should ask the API for the current gateway address and session limits. There is one endpoint — GET /gateway/bot. It requires a Bot token.

GET /api/v1/gateway/bot

Section titled “GET /api/v1/gateway/bot”

Requires: Authorization: Bot <token>

Окно терминала
curl https://floodilka.com/api/v1/gateway/bot \
  -H "Authorization: Bot YOUR_BOT_TOKEN"

Response

Section titled “Response”
{
  "url": "wss://gateway.floodilka.com",
  "shards": 1,
  "session_start_limit": {
    "total": 1000,
    "remaining": 999,
    "reset_after": 14400000,
    "max_concurrency": 1
  }
}
Field Type Description
url string WSS URL to connect to. Append query params: ?v=1&encoding=json
shards integer Recommended shard count. Small bots always get 1
session_start_limit.total integer Total new IDENTIFY calls in the current window
session_start_limit.remaining integer Calls left in the current window
session_start_limit.reset_after integer Milliseconds until the window resets
session_start_limit.max_concurrency integer How many parallel IDENTIFY calls are allowed
Why these limits?

They protect the cluster from a storm of bots that hit reconnect → IDENTIFY → crash in a loop and drain resources. A healthy client does 1–2 IDENTIFYs per session and never touches the limit. If you do — check your logs, most likely you have an infinite reconnect loop somewhere.

What’s next

Section titled “What’s next”