分页查询标签下的在线成员列表
GET
/im/v2/room_members/{room_id}/actions/list_tag_members请求参数
Path 参数
room_id
integer
聊天室 ID。
Query 参数
tag
string
必需
需要查询的目标标签。
offset
integer
必需
查询的偏移量,首次查询传入 0,后续查询传入上一次查询结果中的 offset。
limit
integer
必需
每页返回的成员数上限,最大为 100。小于等于 0,或者大于 100,会报 414 错误。
示例代码
返回响应
成功(200)
HTTP 状态码: 200
内容格式: JSONapplication/json
数据结构
code
integer
必需
msg
string
必需
data
object
必需
has_more
boolean
必需
是否还有更多数据。
offset
integer
必需
下一页的分页标识符。
items
array [object {17}]
必需
示例
{
"code": 200,
"msg": "success",
"data": {
"offset": 100,
"has_more": false,
"items": [
{
"extension": "",
"member_level": 0,
"account_id": "yx23",
"room_nick": "yx23",
"room_avatar": "http://w03d",
"member_role": 1,
"is_online": true,
"enter_time": 1705302091747,
"blocked": false,
"chat_banned": false,
"temp_chat_banned_time": 12322,
"temp_chat_banned": false,
"notify_target_tags": "{\"tag\": \"abc\"} and {\"tag\": \"def\"}",
"tags": "[\"tag\"]",
"online_info_list": [
{
"room_nick": "yx23",
"room_avatar": "http://wwww",
"enter_time": 1705302091747,
"client_type": 1
}
],
"online_count": 1
}
]
}
}
最后修改时间: 8 个月前