Skip to content

getClientIdListByGroup

获取群组中在线的所有客户端client_id列表

接口URL

/api/getClientIdListByGroup

请求方式

GET

普通模式(Token验证)

默认,服务运行于普通模式,请求携带Header参数:

参数名类型描述
Tokenstring认证Token,即 config.json 文件中的Token

安全模式(签名验证)

可指定启动参数 -s=true,将服务运行于安全模式,请求携带Header参数:

参数名类型描述
Timestampint请求毫秒时间戳
Signaturestring请求签名值签名算法

请求Query参数

参数名示例值参数类型是否必填参数描述
groupsuwsstring群组名称

响应示例

成功

json
{
  "code": 0,
  "message": "成功",
  "data": {
    "clients": {
      "7f31d444-6c8d-407c-a38a-9f290c148a05": 1757433322882,
      "b8cf8629-b9e1-4ef8-b08d-4b186acdfe32": 1757433403752,
      "c24cf128-d5e7-40e6-9360-43212a4f6f53": 1757433352944
    }
  }
}

失败

json
{
  "code": 121,
  "message": "群组不存在"
}