贡献点接口
贡献点接口的单位统一为“点”。增加、扣减贡献点时都必须通过 X-Employee-Virtual-Id 指定当前操作人。
POST
/api/openplatform/scoreChanges
创建贡献点变更请求。使用 changeType 指定增加或扣减。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
employeeVirtualId | string | 是 | 目标员工 virtualId。 |
changeType | string | 是 | 变更方向：increase 增加，decrease 扣减。 |
amount | decimal | 是 | 变更贡献点数量，必须传正数。 |
reason | string | 是 | 变更原因。 |
scoreTypeId | string | 否 | 业务类型 ID；不传时按通用贡献变更处理。 |
{
"statusCode": 100,
"msg": "贡献变更请求已提交",
"data": {
"queueId": "6fbb6f6d-4fa0-4fd3-a87c-fdf691c2a260",
"employeeVirtualId": "emp_T7dQ2mYk8rLp4cN1sVx3bH9wAe6fJuKz",
"score": 5,
"reason": "季度激励",
"acceptedAt": "2026-06-17T16:00:00+08:00"
}
}
POST
/api/openplatform/scoreChanges
扣减贡献点时将 changeType 传为 decrease，amount 仍传正数。
GET
/api/openplatform/employees/{employeeVirtualId}/scoreBalance
查询员工贡献点。
{
"statusCode": 100,
"msg": "获取成功",
"data": {
"employeeVirtualId": "emp_T7dQ2mYk8rLp4cN1sVx3bH9wAe6fJuKz",
"score": 5,
"reason": "季度激励",
"createdAt": "2026-06-17T16:00:00+08:00"
}
}