获取绩效结果

获取被评估人在指定周期、指定项目中各个环节的评估结果信息，包含绩效所在的周期、项目、评估项、评估模版以及各环节评估数据等信息。

Tip: 若采用 tenant_access_token 的鉴权模式，推荐使用获取绩效详情数据 接口获取更丰富的返回数据。

请求

项目	值
HTTP URL	https://open.feishu.cn/open-apis/performance/v1/review_datas/query
HTTP Method	POST
接口频率限制	20 次/分钟
支持的应用类型	custom,isv
权限要求 调用该 API 所需的权限。开启其中任意一项权限即可调用 开启任一权限即可	performance:performance 管理绩效数据 performance:performance:readonly 查看绩效数据
字段权限要求	> Tip: 该接口返回体中存在下列敏感字段，仅当开启对应的权限后才会返回；如果无需获取这些字段，则不建议申请 contact:user.employee_id:readonly 获取用户 user ID

请求头

名称	类型	必填	描述
Authorization	string	是	tenant_access_token 或 user_access_token 值格式："Bearer access_token" 示例值："Bearer u-7f1bcd13fc57d46bac21793a18e560" 了解更多：如何选择与获取 access token
Content-Type	string	是	固定值："application/json; charset=utf-8"

查询参数

名称	类型	必填	描述
user_id_type	string	否	用户 ID 类型 示例值：open_id 可选值有： - open_id: 标识一个用户在某个应用中的身份。同一个用户在不同应用中的 Open ID 不同。了解更多：如何获取 Open ID - union_id: 标识一个用户在某个应用开发商下的身份。同一用户在同一开发商下的应用中的 Union ID 是相同的，在不同开发商下的应用中的 Union ID 是不同的。通过 Union ID，应用开发商可以把同个用户在多个应用中的身份关联起来。了解更多：如何获取 Union ID？ - user_id: 标识一个用户在某个租户内的身份。同一个用户在租户 A 和租户 B 内的 User ID 是不同的。在同一个租户内，一个用户的 User ID 在所有应用（包括商店应用）中都保持一致。User ID 主要用于在不同的应用间打通用户数据。了解更多：如何获取 User ID？ - people_admin_id: 以 people_admin_id 来识别用户 默认值：open_id 当值为 user_id，字段权限要求： contact:user.employee_id:readonly 获取用户 user ID

请求体

名称	类型	必填	描述
start_time	string	是	周期开始时间最小值，毫秒时间戳，小于该时间开始的周期会被过滤掉 注意：当填写了 semester_id_list 参数时，此参数无效 示例值："1430425599999"
end_time	string	是	周期结束时间最大值，毫秒时间戳，大于该时间结束的周期会被过滤掉 注意：当填写了 semester_id_list 参数时，此参数无效 示例值："1630425599999"
stage_types	string\[\]	是	环节类型，目前仅支持终评环节、结果沟通环节、查看绩效结果环节（不传默认包含所有的环节） 示例值：["leader_review"] 可选值有： - leader_review: 终评环节 - communication_and_open_result: 结果沟通环节 - view_result: 查看绩效结果环节 数据校验规则： - 最大长度：50
stage_progress	int\[\]	否	环节状态，填写时按照指定状态获取绩效结果，不填查询所有状态的绩效结果 示例值：[1] 可选值有： - 0: 未开始，任务的开始时间未到达 - 1: 待完成，任务的开始时间到达而截止时间未到达，且任务未完成 - 2: 已截止，任务的截止时间已到达，且任务未完成 - 3: 已完成，任务已完成 - 4: 已复议 数据校验规则： - 最大长度：50
semester_id_list	string\[\]	否	评估周期 ID 列表，可通过获取周期接口获取 示例值：["6992035450862224940"] 数据校验规则： - 最大长度：50
reviewee_user_id_list	string\[\]	是	被评估人 ID 列表，与入参 user_id_type 类型一致 示例值：["ou_838b193464e10df19f1e1b3853698cca"] 数据校验规则： - 最大长度：50
updated_later_than	string	否	环节更新时间最早时间，毫秒时间戳，可筛选出在此时间之后，有内容提交的环节数据 示例值："1630425599999"

请求体示例

{
	"reviewee_user_id_list":["ou_3245842393d09e9428ad4655da6e30b3"],
	"start_time":"1430425599999",
	"end_time":"1630425599999",
	"stage_types":["leader_review","communication_and_open_result"],
	"semester_id_list":["6992035450862224940"],
	"stage_progress":[0,1,2,3],
	"updated_later_than":"1430425599999"
}

响应

响应体

名称	类型	描述
code	int	错误码，非 0 表示失败
msg	string	错误描述
data	review_data	-
└ semesters	semester\[\]	周期列表
└ id	string	周期 ID，详情可查看：获取周期列表 year int 周期年份 type_group string 周期类型分组 type string 周期类型
└ name	i18n	周期名称
└ zh-CN	string	周期中文名称
└ en-US	string	周期英文名称
└ progress	string	绩效评估周期 状态 可选值有： - initiating: 初始化 - enabled: 已启动
└ start_time	string	周期开始时间，毫秒时间戳
└ end_time	string	周期结束时间，毫秒时间戳
└ create_time	string	周期创建时间，毫秒时间戳
└ modify_time	string	绩效评估周期 更新时间
└ create_user_id	string	绩效评估周期 创建人 ID，与入参 user_id_type 类型一致
└ modify_user_id	string	绩效评估周期 更新人 ID，与入参 user_id_type 类型一致
└ activities	activity\[\]	绩效评估项目列表
└ id	string	项目 ID，可通过获取项目列表接口获取
└ name	i18n	项目名称
└ zh-CN	string	项目中文名称
└ en-US	string	项目英文名称
└ semester_id	string	周期 ID，详情可查看：获取周期列表
└ indicators	indicator\[\]	评估项列表
└ id	string	评估项 ID，详情可查看：获取评估项列表
└ name	i18n	评估项名称
└ zh-CN	string	评估项中文名称
└ en-US	string	评估项英文名称
└ options	indicator_option\[\]	评估项等级列表
└ id	string	等级 ID
└ name	i18n	等级名称
└ zh-CN	string	等级中文名称
└ en-US	string	等级英文名称
└ label	string	等级代号
└ templates	template\[\]	评估模板列表
└ id	string	评估模板 ID，详情可查看：获取评估模板
└ name	i18n	环节名称
└ zh-CN	string	环节中文名称
└ en-US	string	环节英文名称
└ stage	string	环节类型
└ units	unit\[\]	评估内容列表
└ id	string	评估内容 ID
└ name	i18n	评估内容名称
└ zh-CN	string	评估内容中文名称
└ en-US	string	评估内容英文名称
└ fields	field\[\]	评估字段列表
└ id	string	评估字段 ID
└ name	i18n	评估字段名称
└ zh-CN	string	评估字段中文名称
└ en-US	string	评估字段英文名称
└ indicator_id	string	评估项 ID，详情可查看：获取评估项列表
└ parent_field_id	string	父级评估字段 ID
└ datas	review_profile\[\]	评估数据列表
└ user_id	user	被评估人 ID，ID 类型请参考：用户资源介绍
└ open_id	string	用户的 open_id
└ user_id	string	用户的 user_id，与入参 user_id_type 类型一致
└ semester_id	string	周期 ID，详情可查看：获取周期列表
└ activity_id	string	项目 ID，详情可查看：获取项目列表
└ stages	review_stage\[\]	环节信息
└ stage_type	string	环节类型
└ progress	int	环节状态 可选值有： - 0: 未开始，任务的开始时间未到达 - 1: 待完成，任务的开始时间到达而截止时间未到达，且任务未完成 - 2: 已截止，任务的截止时间已到达，且任务未完成 - 3: 已完成，任务已完成 - 4: 已复议，绩效结果已开通，且被评估人已发起复议
└ data	review_detail\[\]	环节填写内容
└ template_id	string	评估模板 ID，详情可查看：获取评估模板
└ unit_id	string	评估内容 ID
└ field_id	string	评估字段 ID
└ reviewer_user_id	user	评估人 ID，ID 类型请参考：用户资源介绍
└ open_id	string	用户的 open_id
└ user_id	string	用户的 user_id，与入参 user_id_type 类型一致
└ submit_time	string	最后提交时间，毫秒时间戳
└ indicator_id	string	评估项 ID，详情可查看：获取评估项列表   说明：当 option_id 或 score 有值的时候有值
└ option_id	string	评估项结果等级 ID   说明：当前评估项是评级型评估项数据时有值
└ score	string	评分型评估项填写内容   说明：当前评估项是评分型评估项数据时有值
└ text	string	填写项填写内容  说明：当前评估项是填写项数据时有值
└ perf_coefficient_result	string	绩效系数值
└ richtext	string	富文本格式的填写内容，解析方式见 editor

响应体示例

{
  "code": 0,
  "data": {
    "activities": [
      {
        "id": "6992035450862323244",
        "name": {
          "en-US": "",
          "zh-CN": "rino"
        },
        "semester_id": "6992035450862224940"
      }
    ],
    "datas": [
      {
        "activity_id": "6992035450862323244",
        "semester_id": "6992035450862224940",
        "stages": [
          {
            "data": [
              {
                "field_id": "6982759009698137641",
                "reviewer_user_id": {
                  "open_id": "ou_f0ff33850fc47236e34360d5eed99405",
                  "user_id": "6924863940618878996"
                },
                "submit_time": "1627977114000",
                "template_id": "6982759008972326447",
                "text": "干得不错",
                "richtext": "{\"ops\":[{\"name\":\"insert\",\"text\":\"干得不错\"}]}",
                "unit_id": "6982759008973882926"
              }
            ],
            "progress": 3,
            "stage_type": "communication_and_open_result"
          },
          {
            "data": [
              {
                "field_id": "6982759006887888417",
                "indicator_id": "6966127279593784876",
                "option_id": "6966127279593653804",
                "reviewer_user_id": {
                  "open_id": "ou_f0ff33850fc47236e34360d5eed99405",
                  "user_id": "6924863940618878996"
                },
                "submit_time": "1627977100000",
                "template_id": "6982759008789366313",
                "unit_id": "6982759009396508196"
              },
              {
                "field_id": "6982759010081818159",
                "reviewer_user_id": {
                  "open_id": "ou_f0ff33850fc47236e34360d5eed99405",
                  "user_id": "6924863940618878996"
                },
                "submit_time": "1627977100000",
                "template_id": "6982759008789366313",
                "text": "nice",
                "richtext": "{\"ops\":[{\"name\":\"insert\",\"text\":\"nice\"}]}",
                "unit_id": "6982759009396508196"
              },
              {
                "field_id": "6982759007539463717",
                "reviewer_user_id": {
                  "open_id": "ou_f0ff33850fc47236e34360d5eed99405",
                  "user_id": "6924863940618878996"
                },
                "submit_time": "1627977100000",
                "template_id": "6982759008789366313",
                "text": "bad",
                "richtext": "{\"ops\":[{\"name\":\"insert\",\"text\":\"bad\"}]}",
                "unit_id": "6982759009396508196"
              },
              {
                "field_id": "6982759008811615782",
                "indicator_id": "6966168074268280364",
                "option_id": "6966127279593686572",
                "reviewer_user_id": {
                  "open_id": "ou_f0ff33850fc47236e34360d5eed99405",
                  "user_id": "6924863940618878996"
                },
                "submit_time": "1627977100000",
                "template_id": "6982759008789366313",
                "unit_id": "6982759008043877922"
              },
              {
                "field_id": "6982759010112800295",
                "reviewer_user_id": {
                  "open_id": "ou_f0ff33850fc47236e34360d5eed99405",
                  "user_id": "6924863940618878996"
                },
                "submit_time": "1627977100000",
                "template_id": "6982759008789366313",
                "text": "字节范不错",
                "richtext": "{\"ops\":[{\"name\":\"insert\",\"text\":\"字节范不错\"}]}",
                "unit_id": "6982759008043877922"
              },
              {
                "field_id": "6982759009719158315",
                "indicator_id": "6966164187820820012",
                "option_id": "6966127279593621036",
                "reviewer_user_id": {
                  "open_id": "ou_f0ff33850fc47236e34360d5eed99405",
                  "user_id": "6924863940618878996"
                },
                "submit_time": "1627977100000",
                "template_id": "6982759008789366313",
                "unit_id": "6982759010462647852"
              },
              {
                "field_id": "6982759006797776417",
                "reviewer_user_id": {
                  "open_id": "ou_f0ff33850fc47236e34360d5eed99405",
                  "user_id": "6924863940618878996"
                },
                "submit_time": "1627977100000",
                "template_id": "6982759008789366313",
                "text": "与公司共同发展",
                "richtext": "{\"ops\":[{\"name\":\"insert\",\"text\":\"与公司共同发展\"}]}",
                "unit_id": "6982759010462647852"
              },
              {
                "field_id": "7374030018090418179",
                "indicator_id": "",
                "option_id": "",
                "perf_coefficient_result": "4.00",
                "reviewer_user_id": {
                  "open_id": "ou_4cced6778e381ff987855095d546be82",
                  "user_id": "7312059639540072452"
                },
                "score": "",
                "submit_time": "1716900660000",
                "template_id": "7374030018090106883",
                "text": "",
                "richtext": "{\"ops\":[{\"name\":\"insert\",\"text\":\"\"}]}",
                "unit_id": "7374030018090336259"
              }
            ],
            "progress": 3,
            "stage_type": "leader_review"
          }
        ],
        "user_id": {
          "open_id": "ou_3245842393d09e9428ad4655da6e30b3",
          "user_id": "6932009399175086099"
        }
      }
    ],
    "fields": [
      {
        "id": "6982759008811615782",
        "name": {
          "en-US": "",
          "zh-CN": "价值观"
        }
      },
      {
        "id": "6982759010112800295",
        "name": {
          "en-US": "",
          "zh-CN": "价值观评语"
        }
      },
      {
        "id": "6982759008504284709",
        "name": {
          "en-US": "",
          "zh-CN": ""
        }
      },
      {
        "id": "6982759009698137641",
        "name": {
          "en-US": "",
          "zh-CN": "最终反馈"
        }
      },
      {
        "id": "6982759006887888417",
        "name": {
          "en-US": "",
          "zh-CN": "业绩"
        }
      },
      {
        "id": "6982759010081818159",
        "name": {
          "en-US": "",
          "zh-CN": "做得好的"
        }
      },
      {
        "id": "6982759007539463717",
        "name": {
          "en-US": "",
          "zh-CN": "待改进的"
        }
      },
      {
        "id": "6982759009072072239",
        "name": {
          "en-US": "",
          "zh-CN": "留言"
        }
      },
      {
        "id": "6982759009719158315",
        "name": {
          "en-US": "",
          "zh-CN": "投入度"
        }
      },
      {
        "id": "6982759006797776417",
        "name": {
          "en-US": "",
          "zh-CN": "投入度评语"
        }
      }
    ],
    "indicators": [
      {
        "id": "6966127279593784876",
        "name": {
          "en-US": "",
          "zh-CN": "业绩"
        },
        "options": [
          {
            "id": "6966127279593588268",
            "label": "D",
            "name": {
              "en-US": "",
              "zh-CN": "不符预期"
            }
          },
          {
            "id": "6966127279593621036",
            "label": "C",
            "name": {
              "en-US": "",
              "zh-CN": "略低预期"
            }
          },
          {
            "id": "6966127279593653804",
            "label": "B",
            "name": {
              "en-US": "",
              "zh-CN": "符合预期"
            }
          },
          {
            "id": "6966127279593686572",
            "label": "A",
            "name": {
              "en-US": "",
              "zh-CN": "略超预期"
            }
          },
          {
            "id": "6966127279593719340",
            "label": "S",
            "name": {
              "en-US": "",
              "zh-CN": "远超预期"
            }
          }
        ]
      },
      {
        "id": "6966164187820820012",
        "name": {
          "en-US": "",
          "zh-CN": "投入度"
        },
        "options": [
          {
            "id": "6966127279593588268",
            "label": "D",
            "name": {
              "en-US": "",
              "zh-CN": "不符预期"
            }
          },
          {
            "id": "6966127279593621036",
            "label": "C",
            "name": {
              "en-US": "",
              "zh-CN": "略低预期"
            }
          },
          {
            "id": "6966127279593653804",
            "label": "B",
            "name": {
              "en-US": "",
              "zh-CN": "符合预期"
            }
          },
          {
            "id": "6966127279593686572",
            "label": "A",
            "name": {
              "en-US": "",
              "zh-CN": "略超预期"
            }
          },
          {
            "id": "6966127279593719340",
            "label": "S",
            "name": {
              "en-US": "",
              "zh-CN": "远超预期"
            }
          }
        ]
      },
      {
        "id": "6966168074268280364",
        "name": {
          "en-US": "",
          "zh-CN": "价值观"
        },
        "options": [
          {
            "id": "6966127279593588268",
            "label": "D",
            "name": {
              "en-US": "",
              "zh-CN": "不符预期"
            }
          },
          {
            "id": "6966127279593621036",
            "label": "C",
            "name": {
              "en-US": "",
              "zh-CN": "略低预期"
            }
          },
          {
            "id": "6966127279593653804",
            "label": "B",
            "name": {
              "en-US": "",
              "zh-CN": "符合预期"
            }
          },
          {
            "id": "6966127279593686572",
            "label": "A",
            "name": {
              "en-US": "",
              "zh-CN": "略超预期"
            }
          },
          {
            "id": "6966127279593719340",
            "label": "S",
            "name": {
              "en-US": "",
              "zh-CN": "远超预期"
            }
          }
        ]
      }
    ],
    "semesters": [
      {
        "end_time": "1640966399999",
        "id": "6992035450862224940",
        "name": {
          "en-US": "",
          "zh-CN": "sr"
        },
        "start_time": "1625068800000"
      }
    ],
    "templates": [
      {
        "id": "6982759007063000610",
        "name": {
          "en-US": "Release and Communicate Performance Review with Direct Reports",
          "zh-CN": "进行直属下级绩效沟通并开通结果"
        },
        "stage": "communication_and_open_result"
      },
      {
        "id": "6982759008113116716",
        "name": {
          "en-US": "Manager Review",
          "zh-CN": "上级评估"
        },
        "stage": "leader_review"
      },
      {
        "id": "6982759008537495079",
        "name": {
          "en-US": "Release and Communicate Performance Review with Direct Reports",
          "zh-CN": "进行直属下级绩效沟通并开通结果"
        },
        "stage": "communication_and_open_result"
      },
      {
        "id": "6982759008789366313",
        "name": {
          "en-US": "Manager Review",
          "zh-CN": "上级评估"
        },
        "stage": "leader_review"
      },
      {
        "id": "6982759008959153708",
        "name": {
          "en-US": "Release and Communicate Performance Review with Direct Reports",
          "zh-CN": "进行直属下级绩效沟通并开通结果"
        },
        "stage": "communication_and_open_result"
      },
      {
        "id": "6982759008972326447",
        "name": {
          "en-US": "Release and Communicate Performance Review with Direct Reports",
          "zh-CN": "进行直属下级绩效沟通并开通结果"
        },
        "stage": "communication_and_open_result"
      },
      {
        "id": "6982759010376304165",
        "name": {
          "en-US": "Manager Review",
          "zh-CN": "上级评估"
        },
        "stage": "leader_review"
      },
      {
        "id": "6982759010524038691",
        "name": {
          "en-US": "Manager Review",
          "zh-CN": "上级评估"
        },
        "stage": "leader_review"
      },
      {
        "id": "6982759010669463083",
        "name": {
          "en-US": "Release and Communicate Performance Review with Direct Reports",
          "zh-CN": "进行直属下级绩效沟通并开通结果"
        },
        "stage": "communication_and_open_result"
      }
    ],
    "units": [
      {
        "id": "6982759008043877922",
        "name": {
          "en-US": "",
          "zh-CN": "价值观"
        }
      },
      {
        "id": "6982759008607602222",
        "name": {
          "en-US": "",
          "zh-CN": "重点工作"
        }
      },
      {
        "id": "6982759008973882926",
        "name": {
          "en-US": "",
          "zh-CN": "最终反馈"
        }
      },
      {
        "id": "6982759009396508196",
        "name": {
          "en-US": "",
          "zh-CN": "业绩"
        }
      },
      {
        "id": "6982759010063910445",
        "name": {
          "en-US": "",
          "zh-CN": "留言"
        }
      },
      {
        "id": "6982759010462647852",
        "name": {
          "en-US": "",
          "zh-CN": "投入度"
        }
      }
    ]
  },
  "msg": "success"
}

错误码

HTTP状态码	错误码	描述	排查建议
500	1580101	internal error	请根据实际报错信息定位或咨询技术支持
400	1580102	param is invalid	检查参数是否正确，例如类型，大小
400	1580901	tenant no license	请检查租户是否有席位