腾讯会议创建用户

接口描述 
描述：创建企业用户。
该接口仅适用于手动管理企业通讯录的方式。
不支持 SSO 登录。
不支持企微企业的用户创建。
创建用户后，用户状态初始为未激活。
暂不支持 OAuth2.0鉴权访问。
给用户分配高级账号后，才能分配会议增强体验相关许可；如果将用户的高级账号解绑，该用户绑定的会议增强体验相关许可也会被一起解绑。
高级账号在分配给用户后的7天之内，可以回收并重新进行分配。若超过7天，该高级账号与对应用户的绑定关系将被锁定，此后无法再进行回收和重新分配。
请求方式：POST
自建应用权限点：管理企业用户。
接口操作者权限点：需具备用户列表的编辑权限，可登录 管理后台 通过选择用户管理 > 用户列表 > 编辑权限路径查看。
接口请求域名：
https://api.meeting.qq.com/v1/users
﻿
输入参数
以下请求参数列表仅列出了接口请求参数，HTTP 请求头公共参数请参见签名验证章节的 公共参数说明。
参数名称
必选
参数类型
参数描述
email
否
String
邮箱地址，同企业内须保证唯一。与手机号二选一，若同时传入手机号和邮箱，则邮箱字段忽略。
area
否
String
地区编码（默认值为86）。
phone
是
String
手机号码。与邮箱二选一若企业未开通邮箱登录方式，手机号必填。
username
是
String
用户昵称。
userid
是
String
调用方用于标示用户的唯一 ID，最大支持传入40字节，暂不支持中文。
（例如：企业用户可以为企业账户英文名、员工工号、员工邮箱等，请勿使用手机号等个人敏感信息作为userid）。
staff_id
否
String
员工工号。
job_title
否
String
员工职位，长度范围为[0,96]个字符。
entry_time
否
Integer
入职时间。
department_list
否
String 数组
员工部门 ID，暂只支持为用户分配1个部门。
auto_invite
否
Boolean
自动发送邀请，开启之后调用接口后自动发送激活邀请。
true：开启，默认开启
false：关闭
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两个账号类型。
若此参数不填，则优先分配高级账号，高级账号不足则无法成功创建账号，并返回错误。
原 SaaS 版企业版、原 SaaS 版教育版账号：
若此参数不填，则优先分配高级账号，高级账号不足则创建免费账号。
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
注意：
userid 会在通讯录外显给企业内的所有成员，请勿使用个人敏感信息（例如手机号等）。
输出参数
参数名称
参数类型
参数描述
email
String
邮箱地址。
phone
String
手机号码。
username
String
用户昵称。
userid
String
调用方用于标示用户的唯一 ID（例如：企业用户可以为企业账户英文名、个人用户可以为手机号等，暂不支持中文）。
错误码列表
状态码
错误码
错误描述
400
500014
账号无权限。
400
190004
参数非法，请对照接口文档检查您的参数。
400
190301
请求重放错误，请求头里的 X-TC-Timestamp 和 X-TC-Nonce 每次请求时需重新生成，不能使用和过去五分钟内相同的 timestamp 和 nonce。
500
156011
数据处理中。
500
20016
图片尺寸过大。
500
20015
图片格式非法。
500
20014
图片大小非法。
500
20006
手机格式异常。
500
500025
版本不匹配。
500
41
网络错误，请稍后重试。
500
20002
用户已存在。
500
20013
图片 URL 非法。
500
41003
手机号码重复。
500
20029
图片访问失败，请稍后重试。
500
41005
邮箱重复。
示例
输入示例
POST https://api.meeting.qq.com/v1/users
{
  "username": "testusername",
  "phone": "18888888888",
  "userid": "testuserid",
  "email": "123456@qq.com",
  "staff_id":"6666",
  "job_title":"develop",
  "entry_time":1628495795,
  "department_list":["07f4c****************1966815d251"],
  "operator_id":"KM4Ss4Th09ogUw1JiK",
  "operator_id_type":1
}
输出示例
{
  "username": "testusername",
  "phone": "18888888888",
  "userid": "testuserid",
  "email": "123456@qq.com",
  "uuid": "WM4Fs4Th56ogU13JiK"
}
﻿
﻿

参数名称	必选	参数类型	参数描述
email	否	String	邮箱地址，同企业内须保证唯一。与手机号二选一，若同时传入手机号和邮箱，则邮箱字段忽略。
area	否	String	地区编码（默认值为86）。
phone	是	String	手机号码。与邮箱二选一若企业未开通邮箱登录方式，手机号必填。
username	是	String	用户昵称。
userid	是	String	调用方用于标示用户的唯一 ID，最大支持传入40字节，暂不支持中文。（例如：企业用户可以为企业账户英文名、员工工号、员工邮箱等，请勿使用手机号等个人敏感信息作为userid）。
staff_id	否	String	员工工号。
job_title	否	String	员工职位，长度范围为[0,96]个字符。
entry_time	否	Integer	入职时间。
department_list	否	String 数组	员工部门 ID，暂只支持为用户分配1个部门。
auto_invite	否	Boolean	自动发送邀请，开启之后调用接口后自动发送激活邀请。 true：开启，默认开启 false：关闭
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两个账号类型。若此参数不填，则优先分配高级账号，高级账号不足则无法成功创建账号，并返回错误。原 SaaS 版企业版、原 SaaS 版教育版账号：若此参数不填，则优先分配高级账号，高级账号不足则创建免费账号。
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

状态码	错误码	错误描述
400	500014	账号无权限。
400	190004	参数非法，请对照接口文档检查您的参数。
400	190301	请求重放错误，请求头里的 X-TC-Timestamp 和 X-TC-Nonce 每次请求时需重新生成，不能使用和过去五分钟内相同的 timestamp 和 nonce。
500	156011	数据处理中。
500	20016	图片尺寸过大。
500	20015	图片格式非法。
500	20014	图片大小非法。
500	20006	手机格式异常。
500	500025	版本不匹配。
500	41	网络错误，请稍后重试。
500	20002	用户已存在。
500	20013	图片 URL 非法。
500	41003	手机号码重复。
500	20029	图片访问失败，请稍后重试。
500	41005	邮箱重复。

创建用户

本页目录：

接口描述

输入参数

输出参数

错误码列表

示例

输入示例

输出示例