接口描述
描述:会议可以通过会议室 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。建议将 meeting_id 转换成 int64 传入。 |
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 | 请检查参数类型。 |
示例
输入示例
PUThttps://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"}