getClientIdListByGroup
获取群组中在线的所有客户端client_id列表
接口URL
/api/getClientIdListByGroup
请求方式
GET
请求Header参数
普通模式(Token验证)
默认,服务运行于普通模式,请求携带Header参数:
参数名 | 类型 | 描述 |
---|---|---|
Token | string | 认证Token,即 config.json 文件中的Token |
安全模式(签名验证)
可指定启动参数 -s=true
,将服务运行于安全模式,请求携带Header参数:
参数名 | 类型 | 描述 |
---|---|---|
Timestamp | int | 请求毫秒时间戳 |
Signature | string | 请求签名值签名算法 |
请求Query参数
参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
---|---|---|---|---|
group | suws | string | 是 | 群组名称 |
响应示例
成功
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": "群组不存在"
}