添加或者保存员工信息
| 拥有此API的权限集 |
|---|
| 组织管理-增删改 |
请求方式及url
- 请求方式：
POST - 请求头：
Content-Type:application/json 接口地址：
https://api.xiaoe-tech.com/xe.ofs.user.save/1.0.0频率限制:
10秒500次
在线调试工具
请求
响应
请求参数
| 参数名 | 必选 | 类型 | 说明 |
|---|---|---|---|
| access_token | 是 | string | 专属token |
| data | 是 | array | 保存数据，最大支持1000 |
保存数据 data
| 参数名 | 必选 | 类型 | 说明 |
|---|---|---|---|
| user_id | 否 | string | 用户id，不传为新建 |
| account | 是 | string | 用户账号，手机和账号必须有一个不能为空 |
| name | 是 | string | 真实姓名 |
| mobile | 是 | string | 手机号 |
| gender | 否 | int | 1-男，2-女 |
| job | 否 | string | 职位 |
| 否 | string | 邮箱 | |
| passsword | 否 | string | 密码 |
| state | 是 | int | 状态：0-停用 ，1-启用 |
| groups | 否 | array | 用户所属分组，不传默认放入根部门 |
备注
- 若用户手机号在此店铺注册过，保存的时候会根据手机号获取微信信息注册成员工。
- 手机号和user_id都不存在时，则视为添加。
- 已存在的手机号不会作为更新标准。
- 有user_id时，为更新员工信息。
请求示例
添加员工请求示例
{
"access_token" : "xe_xxxxx",
"data": [
{
"mobile":"+86-123456789",
"name":"某某",
"account":"zhuwei456",
"password":"zhuwei123",
"groups":[
"g_appxxxxxx",
"g_appxxxxxx"
],
"gender":1,
"state":1,
"email":"123456789@xx.com",
"nickname":"zzz",
"job":"aaa"
}
]
}
修改员工请求示例
{
"access_token" : "accessxxxx",
"data":[
{
"nickname":"zzz",
"name":"某某,
"mobile":"+86-123456789",
"job":"1",
"email":"123456789@xxx.com",
"user_id":"u_1h2J3u4H5f_1a2b3C4d5C",
"state":2,
"gender":1,
"password":""
}
]
}
返回参数
| 参数名 | 类型 | 说明 |
|---|---|---|
| code | int | 请求结果码 |
| msg | string | 描述信息 |
| data | object | 员工列表 |
返回示例
{
"code": "0",
"msg": "success",
"data": null
}