Appearance
用户
批量同步用户
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": "同步失败原因"
}