接口描述
描述：
使用 userid 更新企业用户，目前暂不支持 OAuth2.0鉴权访问。
用户已删除或被禁用则不能更新。
不支持企微企业用户的更新。
请求方式：PUT
自建应用权限点：管理企业用户。
接口操作者权限点：需具备用户列表的编辑权限，可登录 管理后台 通过用户管理 > 用户列表 > 编辑权限路径查看。
接口请求域名：
https://api.meeting.qq.com/v1/users/{userid}
输入参数
路径参数
参数名称 | 必填 | 参数类型 | 参数描述 |
userid | 否 | String | 调用方用于标识用户的唯一 ID。 企业唯一用户标识说明：企业调用创建用户接口时传递的 userid 参数。 |
请求体
参数名称 | 必填 | 参数类型 | 参数描述 |
email | 否 | String | 邮箱地址，已激活的用户邮箱不可修改。 |
area | 否 | String | 地区编码（默认值为86）。 |
username | 否 | String | 新的用户昵称。 |
phone | 否 | String | 手机号码，已激活的用户手机号码不可修改。 |
avatar_url | 否 | String | 头像地址。 |
staff_id | 否 | String | 员工工号。 |
job_title | 否 | String | 员工职位，长度范围为[0,96]个字符。 |
entry_time | 否 | Integer | 入职时间。 |
department_list | 否 | String 数组 | 员工部门 ID，暂只支持为用户分配1个部门。 |
user_account_type | 否 | Integer | 指定账号类型。 1：高级账号（企业版/教育版） 2：免费账号（企业版/教育版） 3：免费账号100方 （商业版） 4：高级账号300方（商业版） 5：高级账号500方（商业版） 6：高级账号1000方（商业版） 7：高级账号2000方（商业版） 8：高级账号100方（商业版） 9：高级账号（企业版/教育版/商业版） 说明： 商业版2.0、企业版2.0和教育版2.0版本的账号，仅支持传入2和9两个账号类型。 根据传入的参数判断是否有该类型账号，没有则报错。更新后，原类型账号资源释放。 |
add_on_largemeeting | 否 | Integer | 增强会议体验：房间规模升级许可。 0：回收房间规模升级许可 1：500方房间规模升级许可 2：1000方房间规模升级许可 3：2000方房间规模升级许可 |
add_on_webinar | 否 | Integer | 增强会议体验：网络研讨会（Webinar）观众规模升级许可。 0：回收 Webinar 观众规模升级许可 1：Webinar 观众规模提升至300观众 2：Webinar 观众规模提升至500观众 3：Webinar 观众规模提升至1000观众 4：Webinar 观众规模提升至2000观众 5：Webinar 观众规模提升至3000观众 6：Webinar 观众规模提升至5000观众 7：Webinar 观众规模提升至8000观众 8：Webinar 观众规模提升至10000观众 |
operator_id | 是 | String | 操作者 ID。 |
operator_id_type | 是 | Integer | 操作者 ID 类型。 1：userid |
输出参数
错误码列表
状态码 | 错误码 | 错误描述 |
500 | 156011 | 更新用户中，请勿重复提交。 |
500 | 20014 | 图片大小非法。 |
500 | 500025 | 版本不匹配。 |
400 | 500014 | 账号无权限。 |
500 | 20029 | 图片访问失败，请稍后重试。 |
500 | 20002 | 用户 userid 已存在。 |
400 | 190004 | 参数非法，请对照接口文档检查您的参数。 |
500 | 20013 | 图片 URL 非法。 |
500 | 20006 | 手机号格式错误。 |
500 | 20015 | 图片格式非法。 |
400 | 20001 | 用户不存在。 |
500 | 20016 | 图片尺寸过大。 |
示例
输入示例
PUT https://api.meeting.qq.com/v1/users/9527{"username": "testusername", "operator_id":"KM4Ss4Th09ogUw1JiK","operator_id_type":1}
输出示例
更新用户成功，返回 Body 为空。
