# 添加或者保存员工信息 |拥有此API的权限集| |:----- | |组织管理-组织操作| **请求方式及url** - 请求方式：`POST` - 请求头：`Content-Type:application/json` - 接口地址：`https://api.xiaoe-tech.com/xe.ofs.user.save/1.0.0` - 频率限制: `10秒500次` {% api method="POST", data= { "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" } ] }, url="https://api-doc.xiaoe-tech.com/_agent/forward?url=https://api.xiaoe-tech.com/xe.ofs.user.save/1.0.0" %} {% endapi %} **请求参数** |参数名|必选|类型|说明| |:---- |:---|:----- |:----- | |access_token |是 |string |[专属token](./../get_access_token.md) | |data|是 |array |保存数据，最大支持1000 | 保存数据 `data` |参数名|必选|类型|说明| |:---- |:---|:----- |:----- | |user_id |否 |string |用户id，不传为新建 | |account |是 |string |用户账号，手机和账号必须有一个不能为空 | |name |是 |string |真实姓名 | |mobile |是 |string |手机号 | |gender|否 |int |1-男，2-女 | |job |否 |string |职位 | |email |否 |string |邮箱 | |passsword|否 |string |密码 | |state|是 |int |状态：0-停用 ，1-启用 | |groups |否 |array| 用户所属分组，不传默认放入根部门 | **备注** - 若用户手机号在此店铺注册过，保存的时候会根据手机号获取微信信息注册成员工。 - 手机号和user_id都不存在时，则视为添加。 - 已存在的手机号不会作为更新标准。 - 有user_id时，为更新员工信息。 **请求示例** <br/> **添加员工请求示例** ``` { "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 } ```