简要描述:
用于同步用户,创建用户时需要选择一个组织结构,验证openUserId唯一性。
请求URL:
https://ip/api/v1/system/open/sync/user
请求方式:
POST
请求参数:
请求体参数
| Parameters | Type/Value | Require | Description |
|---|---|---|---|
| type | [enum] | 是 | 同步方式,全量:ALL 增量:PART ,为ALL时,会删除原有数据 |
| userList | [array] | 是 | 用户列表,列表对象为用户user |
| openKey | [string] | 否 | 系统用户标识,当openKey不为空时,删除其他非当前openKey的用户 |
user
| Parameters | Type/Value | Require | Description |
|---|---|---|---|
| openUserId | [string] | 是 | 第三方用户唯一ID,判断是否是同一个账号,存在相同openUserId则时为更新 |
| username | [string] | 是 | 登录名,小于20位 |
| name | [string] | 是 | 姓名 |
| [string] | 是 | 邮箱 | |
| telephone | [string] | 否 | 电话 |
| phone | [string] | 否 | 座机 |
| deptId | [string] | 是 | 部门ID,所属结构ID |
| gender | [enum] | 是 | 性别,MALE:男,FEMALE:女 |
| position | [string] | 否 | 职位 |
| enable | [boolean] | 否 | 是否启用,true 是 false 否 默认true |
| delFlag | [boolean] | 否 | 是否删除,true 是 false 否 默认false |
| sort | [int] | 否 | 排序序号,根据传的值升序排序 |
请求示例:
{
"type": "PART",
"userList": [
{
"openUserId":"1",
"username":"zhangs",
"name":"张三",
"deptId":"3",
"email":"zhangsan@stec.com",
"telephone":"13558822481",
"phone": "87989",
"gender":"MALE",
"position":"经理"
},
{
"openUserId":"2",
"username":"lius",
"name":"刘四",
"deptId":"3",
"email":"lius@sss.com",
"telephone":"13555825542",
"phone": "875689",
"gender":"MALE",
"position":"经理"
}
]
}
返回参数说明:
请求成功时,http status code =200