Group Counters
Gets group counters.
| URL |
Requires Auth |
HTTP Method |
/api/v1/groups.counters |
yes |
GET |
Payload
One of roomId or roomName is required.
| Argument |
Example |
Required |
Description |
roomId |
euzoT67Gx6nXcn66M |
Required |
The group’s id |
roomName |
channel.cf.1518990680083 |
Required |
The group’s name |
userId |
RtycPC29hqLJfT9xj |
Optional |
Counters for provided user id (need to have a view-room-administration right for calling user) |
Example Call
curl -H "X-Auth-Token: 8h2mKAwxB3AQrFSjLVKMooJyjdCFaA7W45sWlHP8IzO" \
-H "X-User-Id: ew28FnZqipDpvKw3R" \
-H "Content-type: application/json" \
http://localhost:3000/api/v1/groups.counters?roomId=euzoT67Gx6nXcn66M
Example Result
{
"joined":true,
"members":1,
"unreads":1,
"unreadsFrom":"2018-02-18T21:51:20.091Z",
"msgs":1,
"latest":"2018-02-23T17:20:17.345Z",
"userMentions":0,
"success":true
}
where:
joined - boolean flag that shows that user is joined the room or not
members - count of current room members
unreads - count of unread messages for specified user (calling user or provided userId)
unreadsFrom - start date-time of unread interval for specified user
msgs - count of messages in the room
latest - end date-time of unread interval for specified user (or date-time of last posted message)
userMentions - count of user mentions in messages
Change Log
| Version |
Description |
| 0.65.0 |
Added |
