获取某指定会议的等候室成员列表,需开启等候室且为“会议进行中”状态。如果会议非进行中,调用此接口查询会返回空列表。
请求方式:POST(HTTPS)
请求地址:https://qyapi.weixin.qq.com/cgi-bin/meeting/waitingroom/get_current_user_list?access_token=ACCESS_TOKEN
请求包体:
{
"meetingid": "MEETINGID",
"limit": 2,
"cursor": "GNEI"
}
参数说明:
参数 | 必须 | 类型 | 说明 |
---|---|---|---|
access_token | 是 | string | 调用接口凭证。获取方法查看“获取access_token” |
meetingid | 是 | string | 会议ID |
limit | 否 | int32 | 分页大小,默认10,最大50 |
cursor | 否 | string | 分页查询用,将上一个请求返回的next_cursor字段传入。第一次查询时可不传值 |
注意:
limit参数必须与首次调用获得cursor时传入的limit一致。
权限说明
返回结果:
{
"errcode": 0,
"errmsg": "ok",
"has_more": true,
"next_cursor": "NGIENIGE",
"user_list": [{
"userid": "USERID1",
"instance_id": 1,
"customer_data": "DATA",
"tmp_openid": "214142"
}, {
"userid": "",
"instance_id": 1,
"customer_data": "DATA",
"tmp_openid": "NIGEMIGEO"
}]
}
参数说明:
参数 | 类型 | 说明 |
---|---|---|
errcode | int32 | 返回码 |
errmsg | string | 对返回码的文本描述内容 |
has_more | bool | 是否还有未拉取的成员列表 |
next_cursor | string | 当has_more=true时有值,下次请求将该字段赋值给cursor字段 |
user_list | object[] | 等候室人员对象数组。详见User |
User说明
参数 | 类型 | 说明 |
---|---|---|
userid | string | 等候室企业内成员userid |
instance_id | int32 | 成员的终端设备类型: 1:PC 2:Mac 3:Android 4:iOS 5:Web 6:iPad 7:Android Pad 8:小程序 9:voip、sip 设备 10:linux 20:Rooms for Touch Windows 21:Rooms for Touch Mac 22:Rooms for Touch Android 30:Controller for Touch Windows 32:Controller for Touch Android 33:Controller for Touch Iphone |
customer_data | string | 用户专属信息。 |
tmp_openid | string | 会议中为每个参会成员授予的临时 ID |