更新员工工号
- 接口:/employee/update/employeeId
- Method:POST
- 数据格式:JSON
- 接口说明:每批最多处理300个数据
请求参数
参数 | 类型 | 必须 | 默认值 | 主键 | 描述 |
---|---|---|---|---|---|
originEmployeeId | string | Y | Y | 原员工工号 | |
targetEmployeeId | string | Y | Y | 修改后员工工号 |
返回数据
字段 | 类型 | 描述 |
---|---|---|
originEmployeeId | string | 原员工工号 |
targetEmployeeId | string | 修改后员工工号 |
备注
- 该接口采用单条失败的处理方式,即整批数据中,如果只有其中的几条因为各种原因失败,那么只有那几条数据不会被保存;其它的数据仍然会被正常处理;错误数据的主键(employeeId)会被放在errorData里面;errorData为结构体, 包含出错记录主键(employeeId), 以及与之对应的出错信息; 类似 {"employeeId": "错误信息"}; 具体参见失败示例;如果有错误信息,则返回的code为NACK,然后错误信息会放在errorData里,只有全部成功返回的code为ACK。
示例
请求数据
{
"timestamp": 123456,
"data": [
{
"originEmployeeId": "ST003",
"targetEmployeeId":"ST0003"
},
{
"originEmployeeId": "ST004",
"targetEmployeeId":"ST001"
},
{
"originEmployeeId": "ST0005",
"targetEmployeeId":"ST0006"
}
]
}
返回数据(成功)
{
"code": "ACK",
"message": "",
"data": [{
"originEmployeeId": "ST003",
"targetEmployeeId": "ST0003"
},
{
"originEmployeeId": "ST004",
"targetEmployeeId": "ST001"
},
{
"originEmployeeId": "ST0005",
"targetEmployeeId": "ST0006"
}
],
"args": null,
"linkDetail": false,
"nonBizError": false
}
返回数据(失败)
{
"code": "NACK",
"message": null,
"data": [],
"args": null,
"linkDetail": false,
"errorData": {
"ST003": "找不到该员工",
"ST004": "targetEmployeeId[ST001]已存在",
"ST0005": "找不到该员工"
},
"nonBizError": false
}