Skip to content

用户

批量同步用户

POST /api_v3/admin/sync/users

规则说明

1.单次同步数量最⼤为500个⽤户
2.每个⽤户必须保证⾄少有:⽤户名 或 邮箱 或 ⼿机号
3.每个⽤户的部⻔编码必须已存在培训平台
4.每个⽤户的⻆⾊编码必须已存在培训平台
5.每个⽤户的管理范围部⻔编码必须已存在培训平台
6.每个⽤户的⽤户组编码必须已存在培训平台
7.每个⽤户的数据进⾏同步覆盖(字段值为空则不更新)
8.用户同步syncId必须全局唯⼀且不可变更(标记用户数据唯⼀来源)。
9.如果已有⽤户的syncId为0时(系统⽤户除外),且 ⽤户名/邮箱/⼿机号 存在同步数据中,则更新其syncId。

权限

  • 需要认证

  • 支持版本 >=25.2.4

  • 具备权限 admin_user_manage(用户管理权限)

参数

字段是否必须描述
truename string真实姓名
nickname string用户名称(⽤户名/邮箱/⼿机号 ⾄少有1项⾮空)
orgCodes string所属部⻔编码(使⽤org.code,且,分开, eg: "o1,o2,o3")
依赖接口:部门接口
password string密码
email string邮箱(⽤户名/邮箱/⼿机号 ⾄少有1项⾮空)
mobile string手机号(⽤户名/邮箱/⼿机号 ⾄少有1项⾮空)
roles⻆⾊编码(⽤,分开 eg:"ROLE_USER,ROLE_TEACHER")
依赖接口:角色接口
postCode岗位编码
依赖接口:岗位接口
hireDate入职时间
idcard身份证号码
locked是否封禁(0表示在职/1表示离职,默认为0)
permissionOrgCodes管理范围部⻔编码(使⽤org.code,且,分开, eg: "o1,o2,o3")
依赖接口:部门接口
userGroupCodes⽤户组编码(⽤,分开, eg:"ug1,ug2,ug3")
依赖接口:用户组接口
syncId⽤户同步syncId(必须唯⼀且不可变更,且不能为空或0)

成功响应

json
{
    "status": true
}

失败响应

json
{
    "status": false,
    "message": "同步失败原因"
}