取消会议
接口描述
描述:取消用户创建的会议。用户只能取消自己创建的会议,且该会议是一个有效的会议。如果不是会议创建者或者无效会议号将会返回错误。企业 secret 鉴权用户可取消任何该用户企业下创建的有效会议,OAuth2.0 鉴权用户只能取消通过 OAuth2.0 鉴权创建的有效会议。
当您想实时监测会议取消状况时,您可以通过订阅 会议取消 的事件,接收事件通知。
调用方式:POST
接口请求域名:
https://api.meeting.qq.com/v1/meetings/{meetingId}/cancel
输入参数
以下请求参数列表仅列出了接口请求参数,发送请求需携带公共参数。详情请参见 公共请求参数。
参数名称 | 必选 | 参数类型 | 参数描述 |
---|---|---|---|
meetingId | 是 | String | 会议的唯一 ID。 |
userid | 是 | String | 调用 API 的用户 ID(企业内部请使用企业唯一用户标识;OAuth2.0 鉴权用户请使用 openId)。<br>企业唯一用户标识说明:<br>1. 企业对接 SSO 时使用的员工唯一标识 ID;<br>2. 企业调用创建用户接口时传递的 userid 参数。 |
instanceid | 是 | Integer | 用户的终端设备类型: <br>1 - PC <br>2 - Mac<br>3 - Android <br>4 - iOS <br>5 - Web <br>6 - iPad <br>7 - Android Pad <br>8 - 小程序 |
reason_code | 是 | Integer | 原因代码,可为用户自定义。 |
meeting_type | 否 | Integer | 会议类型,默认值为0。<br> 0:普通会议<br> 1:周期性会议 |
sub_meeting_id | 否 | String | 周期性子会议 ID,如果不传,则会取消该系列的周期性会议。 |
reason_detail | 否 | String | 详细取消原因描述。 |
输出参数
无输出参数,成功返回空消息体,失败返回 错误码 和错误信息。
示例
输入示例
POST https://api.meeting.qq.com/v1/meetings/7567173273889276131/cancel
{
"userid" : "test1",
"instanceid" : 1,
"reason_code" : 1,
"reason_detail" : "取消会议"
}
输出示例
取消成功,返回 Body 为空。
下载 腾讯会议API取消会议-腾讯会议.pdf
文章内容是否对您有帮助?
有帮助
无帮助
能否告知我们这篇文章的问题?(选填)