Skip to content

添加或者保存员工信息

拥有此API的权限集
组织管理-增删改

请求方式及url

  • 请求方式:POST

  • 请求头:Content-Type:application/json

  • 接口地址:https://api.xiaoe-tech.com/xe.ofs.user.save/1.0.0

  • 频率限制: 10秒500次

接口调试

请求参数
响应结果
暂无响应数据

请求参数

参数名必选类型说明
access_tokenstring专属token
dataarray保存数据,最大支持1000

保存数据 data

参数名必选类型说明
user_idstring用户id,不传为新建
accountstring用户账号,手机和账号必须有一个不能为空
namestring真实姓名
mobilestring手机号
genderint1-男,2-女
jobstring职位
emailstring邮箱
passswordstring密码
stateint状态:0-停用 ,1-启用
groupsarray用户所属分组,不传默认放入根部门
备注
  • 若用户手机号在此店铺注册过,保存的时候会根据手机号获取微信信息注册成员工。
  • 手机号和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
}