有奖捉虫:办公协同&微信生态&物联网文档专题 HOT

接口描述

描述:对 MRA 进行举手和手放下操作。
请求方式:PUT
接口请求域名
https://api.meeting.qq.com/v1/mra-control/meetings/{meeting_id}/raise-hand

输入参数

HTTP 请求头公共参数请参见签名验证章节的 公共参数说明

请求路径参数

参数名称
必选
参数类型
参数描述
meeting_id
String
会议 ID,周期性会议传总会议 ID。

请求 body

参数名称
必选
参数类型
参数描述
operator_id
String
操作者 ID。
operator_id 必须与 operator_id_type 配合使用。根据 operator_id_type 的值,operator_id 代表不同类型。
operator_id_type
Integer
操作者 ID 的类型:
1:userid
4:ms_open_id
instanceid
Integer
用户的终端设备类型 ID。
raise_hand
Bool
MRA 设备举手操作:
True:举手
False:手放下
user
User 对象
被操作用户对象信息。

User 对象

参数名称
必选
参数类型
参数描述
ms_open_id
String
被操作 MRA 设置当前会议中的临时身份 ID。
instanceid
Integer
用户的终端设备类型:
9:voip、sip 设备

输出参数

成功返回空消息体,失败返回 错误码 和错误信息。

错误码列表

状态码
错误码
错误描述
500
190001
存在未注册的用户。
400
190004
参数非法,请对照接口文档检查您的参数。

示例

输入示例

PUT
https://api.meeting.qq.com/v1/mra-control/meetings/100001/raise-hand
{
"operator_id":"user1",
"operator_id_type":1,
"instanceid":1,
"raise_hand":true,
"user":{
"ms_open_id":"1234567",
"instanceid":9
}
}

输出示例

{}