员工信用同步接口

  • 接口:/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": "未找到对应员工"}
}

results matching ""

    No results matching ""