获取带分片 WSS 接入点

接口

GET /gateway/bot

功能描述

用于获取 WSS 接入地址及相关信息，通过该地址可建立 websocket 长连接。相关信息包括：

• 建议的分片数。
• 目前连接数使用情况。

Content-Type

application/json

返回

字段名	类型	描述
url	string	WebSocket 的连接地址
shards	int	建议的 shard 数
session_start_limit	SessionStartLimit	创建 Session 限制信息

SessionStartLimit

字段名	类型	描述
total	int	每 24 小时可创建 Session 数
remaining	int	目前还可以创建的 Session 数
reset_after	int	重置计数的剩余时间(ms)
max_concurrency	int	每 5s 可以创建的 Session 数

错误码

详见错误码。

示例

{
  "wss://api.sgroup.qq.com/websocket/",
  "shards": 9,
  "session_start_limit": {
    "total": 1000,
    "remaining": 999,
    "reset_after": 14400000,
    "max_concurrency": 1
  }
}