客户端在线状态 > 服务端通过Rest API获取在线客户端列表
本特性为高级功能,默认不开通,付费应用,可以在我的应用->查看详情,高级功能里自助开通。
资费: 1.每调用一次扣减消息量1条
Request:
URL: http(s)://<Rest Host>/herenow?appkey={appkey}&channel={channel}&includeUsers={includeUsers}&distinct={distinct}
Method: GET
参数:
channel //必须项,可以包含一个或多个channel
includeUsers //可选项,是否返回用户列表,默认false
distinct //可选项,相同userId的客户端,列表中只保留一个,默认false
Response JSON:
//response示例
{
"code": 200,
"content": {
"channels": {
"channel_A": { //channel name
"channel": "channel_A",
"clientAmount": 3, //在线客户端数量
"userAmount": 2, //在线用户数量
"users": [ //在线用户id列表
{"id":"Jack2","data":"18 years old"}, //在线用户id
{"id":"Ted2","data":""}
]
},
"channel_B": { //channel name
"channel": "channel_B",
"clientAmount": 1, //在线客户端数量
"userAmount": 1, //在线用户数量
"users": [ //在线用户id列表
{"id":"Tom","data":"18 years old"}, //在线用户id
]
}
}
}
}
初始化客户端在线状态(必读)
监听客户端上下线状态变化
取消监听客户端上下线
客户端获取当前在线客户端列表
服务器端通过Rest API获取在线客户端列表
服务端通过webhook接收客户端状态变化