xiaodian.org.employee.update

  • 免费
  • 无需授权

API功能描述(支持get和post)

修改员工信息

公共参数

名称 类型 必选 描述
app_key Long 接入时申请的app_key
method String 接口名称
access_token String Oauth2.0授权获得的access_token
sign String 对 API 调用参数(除sign外)进行 md5 加密获得。参数的顺序为字母表的顺序
timestamp Long 时间戳,使用Unix时间戳格式
format String 响应格式。默认为json格式,固定
sign_method String 参数的加密方法选择,当前只支持Md5
version String API协议版本,固定值为:1.0

输入参数

名称 类型 必选 描述 示例值
employee Object 员工信息对象
id Number 员工id(员工id,工号,三方员工编码不能都为空)
employeeNo String 员工工号
thirdEmployeeNo String 三方员工编码
name String 员工姓名
nickName String 员工昵称
age Number 员工年龄
idType Number 员工Id类型 1:身份证 2:护照
idNo String 员工证件编号
sex Number 员工性别 1 男 2女 3其他
birthday String 员工生日精确到秒的时间戳
mobile String 员工手机号
entryDate Number 员工入职时间
status Number 员工状态 1 待入职 2在职 3已离职
employeeType Number 员工类型  0:正式员工 1:实习生  2:外包  3:劳务  4:顾问
deptId String 部门Id
leaveDate Number 员工离职时间精确到秒
position String 员工职位

返回参数

名称 类型 描述 默认值
status Object 状态对象
code String 状态码 0000000
msg String 状态信息 请求成功
result Object 结果对象
data Object 结果数据
birthday Number 生日 907171200
deptName String 部门名称 研发部
idType Number 证件类型 1
entryDate Number 入职时间 1601481600
nickName String 昵称 向南1
sex Number 性别 1
channel Number 渠道 0
deptId String 部门id 11w
mobile String 员工手机号 13212345433
idNo String 证件编号 421181199801012134
companyId Number 公司id 26
employeeType Number 员工类型 0
brandId Number 品牌id 1302424855
name String 员工姓名 向南1
id Number 员工id 65
position String 员工职位 前端工程师1
thirdEmployeeNo String 三方员工编号 13212345432
age Number 员工年龄 20
status Number 员工状态 2
success Boolean 是否成功 true

请求参数示例

1).
{ "employee":{ "id":65, "name":"向南1", "nickName":"向南1", "age":20, "idType":1, "idNo":"421181199801012134", "sex":1, "birthday":907171200, "mobile":"13212345433", "entryDate":1601481600, "status":2, "employeeType":0, "deptId":"11w", "deptName":"研发部", "thirdEmployeeNo":"13212345432", "position":"前端工程师1" } }

返回示例

1).
{ "status": { "code": "0000000", "msg": "请求成功" }, "result": { "data": { "birthday": 907171200, "deptName": "研发部", "idType": 1, "entryDate": 1601481600, "nickName": "向南1", "sex": 1, "channel": 0, "deptId": "11w", "mobile": "13212345433", "idNo": "421181199801012134", "companyId": 26, "employeeType": 0, "brandId": 1302424855, "name": "向南1", "id": 65, "position": "前端工程师1", "thirdEmployeeNo": "13212345432", "age": 20, "status": 2 } }, "success": true }

异常示例