删除用户

最近更新时间:2024-11-04 09:30:42

我的收藏

通过 userid 删除用户

接口描述

描述:使用 userid 删除企业用户,目前暂不支持 OAuth2.0 鉴权访问。
注意:
此 API 不允许删除超级管理员,如需删除,请超级管理员前往 管理后台 > 企业管理 > 账户管理中转移超管角色。
请求方式:DELETE
自建应用权限点:管理企业用户。
接口操作者权限点:需具备用户列表的编辑权限,可登录 管理后台 通过如下路径查看:用户管理 > 用户列表 > 编辑权限。
接口请求域名
https://api.meeting.qq.com/v1/users/{userid}?operator_id={operator_id}&operator_id_type={operator_id_type}


输入参数

以下请求参数列表仅列出了接口请求参数,HTTP 请求头公共参数请参见签名验证章节的 公共参数说明
参数名称
必选
参数类型
参数描述
userid
String
调用方用于标示用户的唯一 ID(例如企业用户可以为企业账户英文名、个人用户可以为手机号等)。
operator_id
String
操作者 ID。
operator_id_type
Integer
操作者 ID 类型。
1:userid

输出参数

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

错误码列表

状态码
错误码
错误描述
400
500014
账号无权限。
500
10000
用户信息 API 调用通用错误返回。
400
190004
参数非法,请对照接口文档检查您的参数。
400
190301
请求重放错误,请求头里的 X-TC-Timestamp 和 X-TC-Nonce 每次请求时需重新生成,不能使用和过去五分钟内相同的 timestamp 和 nonce。
400
20001
用户不存在。
500
41
网络错误,请稍后重试。
500
190310
每分钟总接口调用次数超过限制。
500
20004
不允许删除超级管理员,如需删除,请超管在网页后台 > 企业管理 > 账户管理中转移超管角色。

示例

输入示例

DELETE https://api.meeting.qq.com/v1/users/9527?operator_id=KM4Ss4Th09ogUw1JiK&operator_id_type=1

输出示例

删除用户成功,返回 Body 为空。

通过 uuid 删除用户

接口描述

描述:使用 uuid 删除企业用户,目前暂不支持 OAuth2.0 鉴权访问。
注意:
此 API 不允许删除超级管理员,如需删除,请超级管理员前往 管理后台 > 企业管理 > 账户管理中转移超管角色。
请求方式:DELETE
自建应用权限点:管理企业用户。
接口操作者权限点:需具备用户列表的编辑权限,可登录 管理后台 通过如下路径查看:用户管理 > 用户列表 > 编辑权限。
接口请求域名
https://api.meeting.qq.com/v1/users?uuid={uuid}&operator_id={operator_id}&operator_id_type={operator_id_type}


输入参数

以下请求参数列表仅列出了接口请求参数,HTTP 请求头公共参数请参见签名验证章节的 公共参数说明
参数名称
必选
参数类型
参数描述
uuid
String
用户身份 ID(腾讯会议颁发的用于开放平台的唯一用户 ID)。
operator_id
String
操作者 ID。
operator_id_type
Integer
操作者 ID 类型。
1:userid

输出参数

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

示例

输入示例

DELETE https://api.meeting.qq.com/v1/users?uuid=WM4Fs4Th56ogU13JiK&operator_id=KM4Ss4Th09ogUw1JiK&operator_id_type=1

输出示例

删除用户成功,返回 Body 为空。