创建用户_嘟哩

模板

全局

全局说明

用户

组织

群组

创建用户

请求说明

POST  http://[SERVER:9022]/v1/user/user_create?access_token={access_token}

请求参数

字段	类型	是否必填	说明
access_token	string	Y	认证的token
org_id	string	Y	组织id
account	string	Y	用户名(账号，限制6-12位英文或数字)
nick_name	string	Y	昵称
phone	string	Y	手机号
password	string	N	密码（默认为：a123456）
mobile_prefix	string	N	国码（如，中国：86）
email	string	N	邮箱
display_in_org	boolean	N	是否展示到通讯录 true：是 false：否
main_dept	string	N	主部门（多个部门中其中一个）
dept_ids	string[]	N	部门（一个员工可属于多个部门）
post_id	string	N	岗位id
first_work_date	date	N	首次工作时间 yyyy-MM-dd
join_date	date	N	入职时间 yyyy-MM-dd

请求示例：

json

{
  "org_id": "1000000",
  "account": "200200021",
  "nick_name": "xxxxxxx1",
  "gender": 1,
  "mobile_prefix":"86",
  "phone": "",
  "email": "1231414324@qq.com",
  "display_in_org":true,
  "main_dept":"1",
  "dept_ids":["1","2"],
  "post_id":"1",
  "first_work_date":"",
  "join_date":"",
}

返回结果示例

{
  "code": 0, 
  "msg": "ok",
   "data":
     {
      "org": "companyA",
      "org_id":"1000000",
      "account_id": "200200021", // 账号ID
      "account": "kkk666",
      "nick_name": "kingsley",
      "status": "1",
      "is_online": false,
      "mobile_prefix":"86",
      "phone": "13610117012",
      "email": "13610117012@qq.com",
      "gender": 1,
      "avatar":"http://...",
      "reg_time":"2024-12-12 15:53:07"
      }
}

结果字段说明

字段	类型	说明
data		用户列表
org	string	组织名称
org_id	string	组织id
account_id	string	用户id
account	string	用户账号
nick_name	string	昵称
status	int	"1":正常，“2”：禁用，“3”：离职
is_online	boolean	是否在线 true：在线 false：离线
mobile_prefix	int	手机号码前缀：86
phone	string	手机号码
email	string	邮箱
gender	int	性别，"1":男，“2”：女
avatar	string	用户头像地址
reg_time	date	注册时间 yyyy-MM-dd HH:mm:ss

状态码说明

code	message	说明
100040	Invalid org id	无效的组织
100062	Invalid mobile number	无效的手机号
100063	email already exist error	邮箱已存在
100064	Invalid email	无效的邮箱
100111	Invalid account	无效的账号
100140	Invalid nick name	无效的昵称
100141	Invalid password	无效的密码
100142	account already exist error	账号已存在
100143	org account already exist error	多组织账号已存在
100144	account dept is null	该账号暂无部门（未指定用户无法创建多组织账号）
更多通用错误码