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

接口描述

描述:会议可以通过会议室 ID 呼叫会议室邀请其入会。
权限:支持 JWT 鉴权,会议创建者所在企业的管理员和会议参会者可呼叫与自己同企业下的会议室入会,若使用会议室呼叫地址,需主持人或联席主持人身份,暂不支持 OAuth 2.0鉴权。
请求方式:PUT
接口请求域名
https://api.meeting.qq.com/v1/meeting-rooms/room-call

输入参数

参数名称
必选
参数类型
参数描述
operator_id
String
操作者 ID。
operator_id 必须与 operator_id_type 配合使用。根据 operator_id_type 的值,operator_id 代表不同类型。
operator_id_type
Integer
操作者 ID 的类型:
1:userid
meeting_room_id
String
会议室 ID,与 mra_address 二选一。
mra_address
MraAddress 对象
MRA 对象。
meeting_id
Integer
会议 ID。

MraAddress 对象

参数名称
必选
参数类型
参数描述
protocol
Integer
信令协议。
1:SIP
2:H.323
dial_string
String
信令地址。如果是 H.323 类型,输入 IP 地址或 E.164 号码。如果是 SIP 类型,输入 IP 地址或 URI。

输出参数

参数名称
参数类型
参数描述
invite_id
String
呼叫 ID。

错误码列表

状态码
错误码
错误描述
400
190301
请求重放错误,请求头里的 X-TC-Timestamp 和 X-TC-Nonce 每次请求时需重新生成,不能使用和过去五分钟内相同的 timestamp 和 nonce。
400
190004
参数非法,请对照接口文档检查您的参数。
500
10004
会议室呼叫失败。
500
10002
会议室呼叫状态查询失败。
500
20000
请检查参数类型。

示例

输入示例

PUT
https://api.meeting.qq.com/v1/meeting-rooms/room-call
{
"operator_id": "user1",
"operator_id_type": 1,
"meeting_room_id":"xxxxxxxxxxx",
"meeting_id": "13434xxxxxxxxx927028"
}

输出示例

{
"invite_id": "33faef6b-xxxx-xxxx-xxxx-9d715cc33f95"
}