批量查询聊天室固定成员信息
GET
/im/v2/room_members/{room_id}/actions/batch请求参数
Path 参数
room_id
integer
聊天室 ID。
Query 参数
account_ids
array[string]
必需
需要查询的聊天室成员列表,一次最多查询 200 个账号。
示例代码
返回响应
成功(200)
HTTP 状态码: 200
内容格式: JSONapplication/json
数据结构
code
integer
必需
msg
string
必需
data
object
必需
failed_list
array [object {3}]
可选
success_list
array [object {17}]
必需
room_id
number
聊天室ID
account_id
string
成员的帐号ID
room_nick
string
成员昵称
room_avatar
string
成员头像
extension
string
开发者扩展字段
member_role
integer
必需
角色类型:
查询固定成员的类型
0: 普通用户(非游客)
1: 创建者(非游客)
2: 管理员(非游客)
3:普通游客
4: 匿名游客
tags
string
必需
只有在线成员且登录时指定了标签才会有此字段
notify_target_tags
string
必需
只有在线成员且登录时指定了通知标签才会有此字段
member_level
integer
必需
成员级别(若未设置成员级别,则无此字段)
is_online
boolean
是否在线
enter_time
number
进入聊天室的时间点
blocked
boolean
是否在黑名单中
chat_banned
boolean
是否被禁言
temp_chat_banned
boolean
是否被临时禁言
temp_chat_banned_time
number
必需
临时禁言的解除时长,单位秒
online_info_list
array [object {6}]
在线的成员信息
online_count
string
在线端的数量
示例
{
"code": 200,
"msg": "ok",
"data": {
"success_list": [
{
"extension": "magna Lorem 01",
"account_id": "yx1",
"room_nick": "黄涛03",
"room_avatar": "incididunt ad",
"member_role": "MANAGER",
"is_online": false,
"blocked": false,
"chat_banned": false,
"temp_chat_banned": false
}
],
"failed_list": [
{
"account_id": "yx6",
"error_code": 114404,
"error_msg": "chatroom member does not exist"
}
]
}
}
最后修改时间: 2 个月前