贡献点接口
贡献点接口的单位统一为“点”。当前开放贡献点余额与流水查询,贡献点变更与申请记录查询请通过贡献申请接口;所有接口都必须通过 X-Employee-Virtual-Id 指定当前操作人。流水的来源人统一以 creator 对象返回;匿名流水不返回来源人信息(creator 为 null),由 isAnonymous 标记匿名语义。
GET
/api/openplatform/employees/{employeeVirtualId}/scoreBalance
查询员工贡献点。
{
"statusCode": 100,
"msg": "获取成功",
"data": {
"employeeVirtualId": "emp_T7dQ2mYk8rLp4cN1sVx3bH9wAe6fJuKz",
"score": 5,
"reason": "季度激励",
"createdAt": "2026-06-17T16:00:00+08:00"
}
}
GET
/api/openplatform/scoreChanges
分页查询员工贡献流水(变动明细)。目标员工缺省为当前操作人本人;查询他人时按操作人的贡献可见权限判定可见范围,无权返回 403。
查询参数:
employeeVirtualId:目标员工 virtualId,可选;不传查当前操作人本人startAt/endAt:变动时间范围起止(含),ISO 8601 格式,可选type:流水类型(字符串枚举),可选:baseScore基础分、applyScore申请分、taskScore任务分、reportScore工作汇报分、systemScore系统贡献、auditScore审核分、achievementScore成就贡献、medalScore奖章贡献、approvalScore审批贡献、trusteeshipApprovalScore托管审批、trusteeshipAuditScore托管审核、equipmentInspection设备巡检direction:正负向筛选,可选:gain仅获得(正向)、deduct仅扣减(负向)page:页码,从 1 开始,默认 1pageSize:每页条数,1-100,默认 20
响应行字段说明:creator 为来源人成员对象(virtualId/name/phone,手机号脱敏);匿名流水(isAnonymous 为 true)时 creator 返回 null,不下发来源人任何信息。
{
"statusCode": 100,
"msg": "获取成功",
"data": {
"total": 2,
"page": 1,
"pageSize": 20,
"items": [
{
"id": "3f2a1b4c-5d6e-4f70-8a91-2b3c4d5e6f70",
"employeeVirtualId": "emp_T7dQ2mYk8rLp4cN1sVx3bH9wAe6fJuKz",
"employeeName": "张三",
"score": 5,
"item": "优秀协作",
"typeName": "申请分",
"reason": "季度协作激励",
"beforeScore": 10,
"afterScore": 15,
"changedAt": "2026-06-17T16:00:00+08:00",
"isAnonymous": false,
"creator": {
"virtualId": "emp_R8sP3nWq6tMv2xK9yB4cD7eF0gH1jLkA",
"name": "李四",
"phone": "138****5678"
}
},
{
"id": "8c9d0e1f-2a3b-4c5d-8e9f-0a1b2c3d4e5f",
"employeeVirtualId": "emp_T7dQ2mYk8rLp4cN1sVx3bH9wAe6fJuKz",
"employeeName": "张三",
"score": -2,
"item": "系统扣减",
"typeName": "系统贡献",
"reason": "违规调整",
"beforeScore": 15,
"afterScore": 13,
"changedAt": "2026-06-18T09:00:00+08:00",
"isAnonymous": true,
"creator": null
}
]
}
}