文档中心 员工接口 批量导入员工

批量导入员工

1.功能说明

批量导入员工,建议批量导入时,员工数量最多为100

2.接口调用说明

请求URL

https://openapi.guanaitong.tech/employee/batchSynchronize

HTTP请求方式

POST

Content-Type: application/json

输入参数说明

(1)公共参数

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

(2)私有参数

批量导入员工的信息是放在一个数组里面,导入员工的信息如下:
参数名称 是否必须 参数类型 长度限制 描述
corp_code string [1,20] 员工工号
name string [1,50] 员工姓名
gender int [1] 性别,1:男;2:女
email string [1,100] 邮箱
mobile_area int [1,10] 手机区号,国外手机同步,不填默认为国内手机区号(86)
mobile string [6,20] 手机
send_invite int [1] 是否发送登录邀请, 1:发送,2:不发送。默认不发送。
remark string [1,255] 岗位名称
dept_code string [0,50] 部门编号
level string [0,50] 职级
birth_day string [10] 生日,格式为yyyy-MM-dd
entry_day string [10] 入职日期,格式为yyyy-MM-dd
card_type int [1] 证件类型,1-身份证,2-护照,3-香港居民身份证,4-澳门居民身份证,5-台湾身份证,6-台胞证,7-回乡证
card_no string [1,30] 证件号码
请求示例
POST /employee/batchSynchronize?timestamp=1505874158&access_token=cbe961534ef810b5cedf25c3585093f4&
     sign=8905e6a4d480b9609262b62df6b1481de5a1589e HTTP/1.1
Host: openapi.guanaitong.tech
Content-Type: application/json
Cache-Control: no-cache

[{"corp_code":"TEST001","gender":"1","name":"张三",email":"zhangsan@163.com","mobile_area":86,"mobile":"13011111111"},
{"corp_code":"TEST002","gender":"2","name":"李艳",email":"liyan@163.com","mobile_area":86,"mobile":"13022222222"}]
                
返回参数说明
参数名称 描述
code 返回码。详见错误返回码
msg 如果错误,返回错误信息。
data 如果没有错误,返回batch_num(批量处理编号),后续去"查询批量结果"查询
正确返回示例
{
    "code": 0,
    "data": "USERDOOR_BATCH_SET_PM_5a1ab36bc6b0e99f8726e99461db0429",
    "msg": "OK"
}
错误返回示例
{
    "code": 1000210001,
    "msg": "timestamp check failed!",
    "data": null
}