慧企星助 开放平台文档

慧企星助 开放平台面向企业三方系统提供标准 HTTP API,支持员工、绑定关系、项目、目标与目标复盘、任务、通知、便签、标签、贡献点和附件上传能力。 所有接口默认只作用于当前 API Key 所属企业,权限由后端统一控制并在请求时强校验。

显示全部接口

贡献点接口

贡献点接口的单位统一为“点”。当前开放贡献点余额与流水查询,贡献点变更与申请记录查询请通过贡献申请接口;所有接口都必须通过 X-Employee-Virtual-Id 指定当前操作人。流水的来源人统一以 creator 对象返回;匿名流水不返回来源人信息(creatornull),由 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 开始,默认 1
  • pageSize:每页条数,1-100,默认 20

响应行字段说明:creator 为来源人成员对象(virtualId/name/phone,手机号脱敏);匿名流水(isAnonymoustrue)时 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
      }
    ]
  }
}