查询当前在线用户
本特性为高级功能,默认不开通,付费应用,可以在我的应用->查看详情,高级功能里自助开通。
每成功调用一次扣减消息数1条
GET http://{rest-host}/im/v1/here_now
参数 | 类型 | 必须 | 描述 |
---|---|---|---|
rest-host | String | 是 | 根据您创建应用的区域选择 杭州:rest-hangzhou.goeasy.io 新加坡:暂不支持IM,敬请期待 |
appkey | String | 是 | common key 或者 rest key |
userIds | Array | 是 | 要查询的用户id列表,每次最多不超过50个 传入多个时:userIds=user1&userIds=user2 |
curl -X GET "http://rest-hangzhou.goeasy.io/im/v1/here_now?appkey=BC-xxxxx&userIds=user1&userIds=user2&userIds=user3"
{
"code":200,
"content":[
{"userId":"user1","userData":"{\"nickname\":\"Jack\"}"},
{"userId":"user2","userData":"{\"nickname\":\"Cherry\"}"},
{"userId":"user3","userData":"{\"nickname\":\"Tonny\"}"}
]
}
{
"code":401,
"content":"Unauthorized"
}