GoEasyIM REST API - 查询在线用户列表

接口功能

查询当前在线用户

开通

本特性为高级功能,默认不开通,付费应用,可以在我的应用->查看详情,高级功能里自助开通。

资费

每成功调用一次扣减消息数1条

调用说明

URL:

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"
}

results matching ""

    No results matching ""