目标与复盘接口
目标、关键结果和周期接口使用 objectives.read 或 objectives.write;复盘接口使用独立的 objectiveReviews.read 或 objectiveReviews.write。所有资源均按当前企业和操作员工权限校验。
id(Guid)作为资源标识;员工对象只返回公开展示字段和当前 API Key 范围内的 virtualId,不会返回手机号、账号、部门内部 Id 或真实员工 Guid,不得用员工 virtualId 替代业务资源 id。目标接口
查询目标列表。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
page | int | 否 | 页码。 |
pageSize | int | 否 | 每页条数。 |
keyword | string | 否 | 目标关键字。 |
group | int | 否 | 目标分组。 |
level | int | 否 | 目标层级。 |
cycle | guid | 否 | 目标周期 ID。 |
departmentId | guid | 否 | 部门 ID。 |
创建目标。人员字段请使用 ownerVirtualIds、participantVirtualIds,不得传内部员工 Guid。
查询目标详情。
路径参数:id 为目标 Guid。
修改目标字段。
路径参数:id 为目标 Guid。
删除目标。
路径参数:id 为目标 Guid。
查询子目标,支持 page 和 pageSize 分页参数。
路径参数:id 为父目标 Guid。
查询目标的关键结果。
路径参数:id 为目标 Guid。
新增目标关键结果。
路径参数:id 为目标 Guid。
修改关键结果。
路径参数:objectiveId 为所属目标 Guid,keyResultId 为关键结果 Guid。
删除关键结果。
路径参数:objectiveId 为所属目标 Guid,keyResultId 为关键结果 Guid。
查询关键结果进度记录。
路径参数:objectiveId 为所属目标 Guid,keyResultId 为关键结果 Guid。
查询当前企业的目标周期。
目标复盘接口
valueAndGain(价值与收获)、deficiencyAndMethod(不足与改进方法)、improvementPlan(改进计划)、participantVirtualIds 和 attachmentUrls(附件)。查询目标复盘列表。
路径参数:id 为目标 Guid。
提交目标复盘。
路径参数:id 为目标 Guid。
{
"valueAndGain": "达成了跨部门交付目标",
"deficiencyAndMethod": "前期排期沟通不足",
"improvementPlan": "下周期提前完成资源评审",
"participantVirtualIds": ["emp_xxx"],
"attachmentUrls": []
}修改目标复盘。objectiveId 为所属目标 Guid,reviewId 为复盘 Guid。