员工信用同步接口
接口:/credit/update
Method:POST
数据格式:JSON
请求参数:
字段 | 类型 | 必须 | 默认值 | 描述 |
---|---|---|---|---|
employeeId | String | Y | 员工工号 | |
currentCredit | int | Y | 员工当前信用分 |
该接口采用单条失败的处理方式,即整批数据中,如果只有其中的几条因为各种原因失败,那么只有那几条数据不会被保存;其它的数据仍然会被正常处理;错误数据的主键(employeeId)会被放在errorData里面;
errorData为结构体, 包含出错记录主键(employeeId), 以及与之对应的出错信息; 类似 {"employeeId": "错误信息"}; 具体参见失败示例;
为保持向后兼容, data也会包含有和errorData相同的记录,但后续可能会改变;
示例
请求示例
{
"timestamp": 123456,
"data": [
{
"employeeId": "10001",
"currentCredit": 90
},
{
"employeeId": "10002",
"currentCredit": 92
}
]
}
返回数据(成功)
{
"code": "ACK",
"message": "",
}
返回数据(失败)
{
"code": "NACK",
"errorData": {"10001": "未找到对应员工"}
}