启用与禁用用户

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

我的收藏

接口描述

描述:使用 userid 启用或禁用本企业下的用户。
鉴权方式:JWT 鉴权
请求方式: PUT
自建应用权限点:管理企业用户。
接口操作者权限点:需具备用户列表的编辑权限,可登录 管理后台 通过如下路径查看:用户管理 > 用户列表 > 编辑权限。
接口请求域名:
https://api.meeting.qq.com/v1/users/{userid}/enable


输入参数

路径参数

参数名称
必选
参数类型
参数描述
userid
String
调用方用于标示用户的唯一 ID(例如:企业用户可以为企业账户英文名、个人用户可以为手机号等,暂不支持中文)。
operator_id
String
操作者 ID。
operator_id_type
Integer
操作者 ID 类型。
1:userid

Body

参数名称
是否必须
参数类型
参数描述
enable
必须
Boolean
是否启用用户:
true:启用
false:禁用

输出参数

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

错误码列表

状态码
错误码
错误描述
400
20001
用户不存在。
400
190004
参数非法,请对照接口文档检查您的参数。
500
60005
用户不存在或处于未激活状态,不支持启用/禁用动作。
500
20005
不允许删除超级管理员/企业管理员。

示例

输入示例

PUT https://api.meeting.qq.com/v1/users/user1/enable
{
"enable":true,
"operator_id":"KM4Ss4Th09ogUw1JiK",
"operator_id_type":1
}

输出示例

{}