取消会议

最近更新时间:2024-07-08 11:48:51

我的收藏

接口描述

描述
用户能取消自己创建的会议和自己所管理企业下的会议,且该会议是一个有效的会议。
如果不是会议创建者或者企业管理员或者无效会议号将会返回错误。
企业 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)。
企业唯一用户标识说明:
1:企业对接 SSO 时使用的员工唯一标识 ID。
2:企业调用创建用户接口时传递的 userid 参数。
instanceid
Integer
用户的终端设备类型:
0:PSTN
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 MacOS
22:Rooms for Touch Android
30:Controller for Touch Windows
32:Controller for Touch Android
33:Controller for Touch iOS
reason_code
Integer
原因代码,可为用户自定义。
meeting_type
Integer
会议类型,默认值为0。
0:普通会议
1:周期性会议
sub_meeting_id
String
周期性子会议 ID,如果不传,则会取消该系列的周期性会议。
reason_detail
String
详细取消原因描述。

输出参数

无输出参数,成功返回空消息体,失败返回 错误码 和错误信息。

错误码列表

状态码
错误码
错误描述
400
500014
账号无权限。
400
190004
参数非法,请对照接口文档检查您的参数。
403
9042
无权限进行该操作,建议检查操作者身份或资源归属。
500
9002
非法请求。
500
9007
MEETING CANCLED。
500
13602
已开始的会议不能取消。
500
13603
会议已结束。
500
13000
缓存查询会议信息失败。
500
960000
网络错误,请稍后重试。
500
190001
存在未注册的用户。
500
9003
MEETING NOT EXIST。
500
202007
成员不在会中。
500
190310
每分钟总接口调用次数超过限制。

代码示例

输入示例

POST https://api.meeting.qq.com/v1/meetings/7567173273889276131/cancel
{
"userid" : "test1",
"instanceid" : 1,
     "reason_code" : 1,
     "reason_detail" : "取消会议"
}

输出示例

取消成功,返回 Body 为空。