跳转至

员工新增

功能说明

  • 员工标识user_id如果是数字和字母的组合会默认当做关爱通员工工号,不符合会随机生成工号与之匹配;
  • 手机号mobile 支持国内外手机号,国外手机必填区号mobile_area,不填写区号默认为86;

接口地址

参数说明

  • 公有参数

    发送请求是必须传入公共参数,详见公共参数

  • 私有参数

    参数名称 是否必须 参数类型 长度限制 描述
    user_id string [1,20] 员工唯一标识
    enterprise_id int 企业编码
    name string [1,50] 员工姓名
    gender int [1] 性别,1:男;2:女;3:未知
    email string [1,100] 邮箱,企业内唯一
    mobile_area int [1,10] 手机区号,国外手机必填,不填默认为国内手机区号(86)
    mobile string [6,20] 手机,企业内唯一
    birth_day string [10] 生日,格式为yyyy-MM-dd,如:1991-01-01
    entry_day string [10] 入职日,格式为yyyy-MM-dd,如:2016-02-03

请求示例

POST /tenant/enterprise/employee/add HTTP/1.1
Host: openapi.guanaitong.tech
Content-Type: application/x-www-form-urlencoded
Cache-Control: no-cache

access_token=1ba50b8f418a3ceeba989d7b789de149&enterprise_id=1209&
user_id=SN112&name=zhangfei1&email=12345678@qq.com&mobile_area=86&mobile=15588652444&entry_day=2016-10-01&birth_day=1991-02-20&timestamp=1492671463&sign=ada2316deb82816d61a7a40dfba3553a34a2e82e&gender=1

返回参数说明

参数说明 描述
code 返回码,0代表正确返回
msg 如果错误,返回错误信息。
data 员工工号

正确返回示例

{
    "code": 0,
    "data": "SN112",
    "msg": "OK"
}

错误返回示例

{
    "code": 1000210001,
    "msg": "timestamp check failed!",
    "data": null
}
回到页面顶部