Skip to content

获取绩效详情数据

获取被评估人各环节的绩效评估详情(不包含校准环节),如环节评估数据、环节提交状态等

请求

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

请求头

名称类型必填描述
Authorizationstringtenant_access_token 值格式:"Bearer access_token" 示例值:"Bearer t-7f1bcd13fc57d46bac21793a18e560" 了解更多:如何选择与获取 access token
Content-Typestring固定值:"application/json; charset=utf-8"

查询参数

名称类型必填描述
user_id_typestring用户 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

请求体

名称类型必填描述
semester_idsstring\[\]评估周期 ID 列表,semester_id 可通过【获取周期】获得
示例值:["6992035450862224940"]
数据校验规则
- 长度范围:010
reviewee_user_idsstring\[\]被评估人 ID 列表,ID 类型与user_id_type 的取值一致
示例值:["ou_3245842393d09e9428ad4655da6e30b3"]
数据校验规则
- 长度范围:010
stage_typesstring\[\]环节类型,如果同时传了环节 ID 和环节类型,优先返回环节 ID 对应的绩效数据。 stage_types 和 stage_ids 至少要传一个,不传默认不返回任何环节评估数据。如果返回数据为空,可以检查模板对应环节是否有内容。
示例值:["leader_review"]
可选值有
- summarize_key_outputs: 工作总结环节 - review: 评估型环节 - communication_and_open_result: 结果沟通环节 - view_result: 绩效结果查看环节 - reconsideration: 结果复议环节 - leader_review: 终评环节(特指最终的绩效结果数据)
review_stage_rolesstring\[\]评估型环节的执行人角色,当传入的环节类型中有评估型环节时,该参数才生效,返回指定执行人角色的评估型环节数据,不传默认包含所有的执行人角色。
示例值:["reviewee"]
可选值有
- reviewee: 被评估人 - invited_reviewer: 360°评估人 - solid_line_leader: 实线上级 - dotted_line_leader: 虚线上级 - secondary_solid_line_leader: 第二实线上级 - direct_project_leader: 合作项目中的直属上级 - custom_review_role: 自定义评估角色 - metric_reviewer: 指标评价人
stage_idsstring\[\]环节 ID,如果同时传了环节 ID 和环节类型,优先返回环节 ID 对应的绩效数据。 stage_types 和 stage_ids 至少要传一个,不传默认不返回任何环节评估数据。
可在事件绩效结果开通绩效详情变更获得,用于接收事件后按环节查询评估数据场景
示例值:["7343513161666707459"]
数据校验规则
- 长度范围:050
need_leader_review_data_sourceboolean当要获取的绩效数据的环节类型包含终评环节时,可指定是否需要返回绩效终评数据的具体环节来源。不传则默认不返回。
可选值有: - true: 返回绩效终评数据的具体环节来源 - false: 不返回绩效终评数据的具体环节来源
示例值:true
updated_later_thanstring可筛选出在此时间之后,有内容提交的环节数据,毫秒级时间戳。不传默认返回所有时间提交的环节数据,包括未提交的环节数据
示例值:"1630425599999"
stage_progressesint\[\]环节状态,不传默认包含所有状态。各类型的环节分别有以下环节状态: 查看绩效结果环节状态
可选值有: - 0:已开通,绩效结果已开通,未发起复议也无需确认结果 - 1:待确认,绩效结果已开通但被评估人还未确认结果,确认的截止时间还未到达 - 2:已截止,绩效结果已开通但被评估人还未确认结果,确认的截止时间已到达 - 3:已确认,绩效结果已开通,被评估人已确认结果 - 4:已复议,绩效结果已开通,且被评估人已发起复议 绩效结果复议环节状态
可选值有: - 1:待完成,任务未完成 - 2:已截止,任务的截止时间已到达,且任务未完成 - 3:已完成,任务已完成 除上述类型外的其他环节类型状态
可选值有: - 0:未开始,任务的开始时间未到达 - 1:待完成,任务的开始时间到达而截止时间未到达,且任务未完成 - 2:已截止,任务的截止时间已到达,且任务未完成 - 3: 已完成,任务已完成
示例值:[1]
数据校验规则
- 长度范围:050

请求体示例

json
{
    "semester_ids": [
        "6992035450862224940"
    ],
    "reviewee_user_ids": [
        "ou_3245842393d09e9428ad4655da6e30b3"
    ],
    "stage_types": [
        "leader_review"
    ],
    "review_stage_roles": [
        "reviewee"
    ],
    "stage_ids": [
        "7343513161666707459"
    ],
    "need_leader_review_data_source": true,
    "updated_later_than": "1630425599999",
    "stage_progresses": [
        1
    ]
}

响应

响应体

名称类型描述
codeint错误码,非 0 表示失败
msgstring错误描述
data\--
  └ datasreview_profile\[\]评估数据列表
    └ user_iduser被评估人 ID
      └ open_idstring用户的 open_id
      └ user_idstring用户的 user_id,ID 类型与user_id_type 的取值一致
    └ semester_idstring绩效评估周期 ID
    └ activity_idstring绩效评估项目 ID,详细信息请参考获取项目配置
    └ review_template_idstring被评估人在该周期对应的后台评估模板 ID,详细信息请参考获取评估模板配置
    └ stagesreview_stage\[\]本周期内各环节内容
      └ stage_idstring环节 ID
      └ stage_typestring环节类型
可选值有
- summarize_key_outputs: 工作总结环节 - review: 评估型环节 - communication_and_open_result: 结果沟通环节 - view_result: 绩效结果查看环节 - reconsideration: 结果复议环节 - leader_review: 终评环节(特指最终的绩效结果数据)
      └ template_idstring该环节对应的环节模板的 ID
      └ recordsreview_record\[\]评估内容记录。多人评估的环节有多份记录,比如 360 评估环节。如果开启了 360 匿名评估,并且是对全部查看者匿名,则评估记录数低于匿名下限,则不返回 360 评估记录
        └ progressint评估人的环节状态。各类型的环节分别有以下环节状态: 查看绩效结果环节状态
可选值有: - 0:已开通,绩效结果已开通,未发起复议也无需确认结果 - 1:待确认,绩效结果已开通但被评估人还未确认结果,确认的截止时间还未到达 - 2:已截止,绩效结果已开通但被评估人还未确认结果,确认的截止时间已到达 - 3:已确认,绩效结果已开通,被评估人已确认结果 - 4:已复议,绩效结果已开通,且被评估人已发起复议 终评环节/结果沟通环节状态(不传默认包含所有的状态) 绩效结果复议环节状态
可选值有: - 1:待完成,任务未完成 - 2:已截止,任务的截止时间已到达,且任务未完成 - 3:已完成,任务已完成 除上述类型外的其他环节类型状态
可选值有: - 0:未开始,任务的开始时间未到达 - 1:待完成,任务的开始时间到达而截止时间未到达,且任务未完成 - 2:已截止,任务的截止时间已到达,且任务未完成 - 3: 已完成,任务已完成
        └ unitsreview_unit\[\]评估记录中的评估内容明细
          └ unit_idstring评估内容 ID
          └ is_unknownboolean是否为不了解。当评估人选不了解时,会返回为 true,其他时候不返回。
          └ datareview_detail\[\]评估题列表,指评估内容中的每个题,可能是评估项或者填写项
            └ field_idstring评估题 ID,指评估内容中的每个评估项或填写项
            └ reviewer_user_iduser评估人 ID。如果开启了 360 匿名评估,并且是对全部查看者匿名,则不返回该值
              └ open_idstring用户的 open_id
              └ user_idstring用户的 user_id,ID 类型与user_id_type 的取值一致
            └ submit_timestring该评估题的最后提交时间,毫秒级时间戳
            └ indicator_idstring评估项 ID(不包含子评估项),option_id 或 score 有值的时候有值,详细信息请参考获取评估项列表
            └ option_idstring评估等级 ID
            └ scorestring评分
            └ textstring填写项填写的文本
            └ tag_based_question_idstring标签填写题 ID,详细信息请参考获取标签填写题配置
            └ tag_text_item_datatag_text\[\]标签填写项的内容
              └ tag_text_idstring标签 ID
              └ tag_textstring评估人在该标签下填写的文本
              └ tag_richtextstring富文本格式的填写内容,解析方式见 editor
            └ perf_coefficient_valuestring绩效系数值
            └ sub_indicator_datasub_indicator\[\]子评估项内容
              └ field_idstring子评估题 ID
              └ indicator_idstring子评估项 ID
              └ option_idstring子评估项的评估等级 ID
              └ scorestring子评估项的评分
              └ textstring子评估项填写的文本
              └ richtextstring富文本格式的填写内容,解析方式见 editor
            └ objective_dataobjective_data\[\]评估的目标数据,当评估内容是对目标(O)或关键举措(KR)评估时有值
              └ objective_idstring目标 ID
              └ scorestring目标的评分
              └ textstring评估人在该填写项填写的文本
              └ keyresult_datakeyresult_data\[\]评估的关键举措,当评估内容是对关键举措(KR)评估时有值
                └ keyresult_idstring关键举措 ID
                └ scorestring关键举措的评分
                └ textstring该关键举措的填写项内容
                └ richtextstring富文本格式的填写内容,解析方式见 editor
              └ richtextstring富文本格式的填写内容,解析方式见 editor
            └ metric_datametric_data\[\]评估的指标,当评估内容是对指标评估时有值
              └ idstring指标 ID
              └ scorestring指标评分
            └ leader_review_data_sourcestring终评环节填写内容的来源(仅终评环节的数据有值)
可选值有
- review: 产生终评结果的评估型环节 - calibaration: 校准环节 - reconsideration: 结果复议环节
            └ multi_textsstring\[\]工作/总结类型的文本内容
            └ richtextstring富文本格式的填写内容,解析方式见 editor
            └ multi_richtextsstring\[\]富文本格式的填写内容,解析方式见 editor
            └ is_principal_review_itemboolean该评估题是否是首要评估项
        └ invited_review_record_infoinvited_review_record_info360 ° 评估记录的信息。如果开启了 360 匿名评估,并且是对全部查看者匿名,则不返回评估人的部分信息
          └ reviewer_iduser评估人 ID。如果开启了 360 匿名评估,并且是对全部查看者匿名,则不返回该值
            └ open_idstring用户的 open_id
            └ user_idstring用户的 user_id,ID 类型与user_id_type 的取值一致
          └ is_rejectedboolean是否拒绝
          └ rejected_reasonstring360° 评估人拒绝评估的理由,当 360° 评估环节被评估人拒绝时有值
          └ distribute_typeint360° 评估人的评估尺度标签
可选值有
- 1: 严格 - 2: 适中 - 3: 宽松
          └ avg_diffstring360° 评估人的评估尺度数值
          └ relationship_with_revieweestring360° 评估人的与被评估人关系。如果开启了 360 匿名评估,并且是对全部查看者匿名,且配置隐藏描述信息则不返回该值
可选值有
- direct_report: 直属下级 - skiplevel_report: 隔级下级 - former_direct_manager: 原直属上级 - skiplevel_manager: 隔级上级 - teammate: 相同上级同事 - crossteam_colleague: 不同上级同事
          └ invitedbystring360° 评估人的邀请人类型。如果开启了 360 匿名评估,并且是对全部查看者匿名,且配置隐藏描述信息则不返回该值
可选值有
- system_default: 系统默认 - reviewee: 被评估人本人 - manager: 上级 - hrbp_or_others: HRBP或其他人 - voluntary: 自愿评估
        └ direct_project_leader_record_infodirect_project_leader_record_info合作项目中上级的评估记录信息,仅在「项目直属上级环节」有值
          └ reviewer_iduser评估人 ID
            └ open_idstring用户的 open_id
            └ user_idstring用户的 user_id,ID 类型与user_id_type 的取值一致
          └ cooperation_projectscooperation_project\[\]评估人作为直属项目上级所在的项目
            └ idstring合作项目 ID
            └ namei18n合作项目的名称
              └ zh_cnstring中文
              └ en_usstring英文
            └ rolescooperation_role\[\]合作项目角色
              └ reviewer_rolecooperation_user_role评估人在合作项目中的角色。在未配置合作项目角色情况下,该字段为空值。
                └ role_idstring合作项目角色 ID
                └ namei18n名称
                  └ zh_cnstring中文
                  └ en_usstring英文
              └ reviewee_rolecooperation_user_role被评估人在合作项目中的项目角色。在未配置合作项目角色情况下,该字段为空值。
                └ role_idstring合作项目角色 ID
                └ namei18n名称
                  └ zh_cnstring中文
                  └ en_usstring英文
            └ user_rolescooperation_user_role\[\]评估人项目角色
              └ role_idstring角色 ID
              └ namei18n名称
                └ zh_cnstring中文
                └ en_usstring英文
            └ underling_rolescooperation_user_role\[\]被评估人项目角色
              └ role_idstring角色 ID
              └ namei18n名称
                └ zh_cnstring中文
                └ en_usstring英文
          └ review_depend_projectscooperation_project\[\]评估依据的项目
            └ idstring合作项目 ID
            └ namei18n合作项目的名称
              └ zh_cnstring中文
              └ en_usstring英文
            └ rolescooperation_role\[\]项目角色
              └ reviewer_rolecooperation_user_role评估人的项目角色。在未配置项目角色情况下,该字段为空值。
                └ role_idstring角色 ID
                └ namei18n名称
                  └ zh_cnstring中文
                  └ en_usstring英文
              └ reviewee_rolecooperation_user_role被评估人的项目角色。在未配置项目角色情况下,该字段为空值。
                └ role_idstring角色 ID
                └ namei18n名称
                  └ zh_cnstring中文
                  └ en_usstring英文
            └ user_rolescooperation_user_role\[\]评估人项目角色
              └ role_idstring角色 ID
              └ namei18n名称
                └ zh_cnstring中文
                └ en_usstring英文
            └ underling_rolescooperation_user_role\[\]被评估人项目角色
              └ role_idstring角色 ID
              └ namei18n名称
                └ zh_cnstring中文
                └ en_usstring英文
          └ participated_projectscooperation_project\[\]共同参与的项目
            └ idstring合作项目 ID
            └ namei18n合作项目的名称
              └ zh_cnstring中文
              └ en_usstring英文
            └ rolescooperation_role\[\]项目角色
              └ reviewer_rolecooperation_user_role评估人的项目角色。在未配置项目角色情况下,该字段为空值。
                └ role_idstring角色 ID
                └ namei18n名称
                  └ zh_cnstring中文
                  └ en_usstring英文
              └ reviewee_rolecooperation_user_role被评估人的项目角色。在未配置项目角色情况下,该字段为空值。
                └ role_idstring角色 ID
                └ namei18n名称
                  └ zh_cnstring中文
                  └ en_usstring英文
            └ user_rolescooperation_user_role\[\]评估人项目角色
              └ role_idstring角色 ID
              └ namei18n名称
                └ zh_cnstring中文
                └ en_usstring英文
            └ underling_rolescooperation_user_role\[\]被评估人项目角色
              └ role_idstring角色 ID
              └ namei18n名称
                └ zh_cnstring中文
                └ en_usstring英文
        └ record_idstring评估记录 ID
      └ review_stage_rolestring评估型环节的执行人角色
可选值有
- reviewee: 被评估人 - invited_reviewer: 360°评估人 - solid_line_leader: 实线上级 - dotted_line_leader: 虚线上级 - secondary_solid_line_leader: 第二实线上级 - direct_project_leader: 项目直属上级 - custom_review_role: 自定义评估角色 - metric_reviewer: 指标评价人角色

响应体示例

json
{
    "code": 0,
    "msg": "success",
    "data": {
        "datas": [
            {
                "user_id": {
                    "open_id": "od-asd2dasdasd",
                    "user_id": "ou-ux987dsf6x"
                },
                "semester_id": "7343513161666707459",
                "activity_id": "7343513161666707459",
                "review_template_id": "7343513161666707459",
                "stages": [
                    {
                        "stage_id": "7343513161666707459",
                        "stage_type": "review",
                        "template_id": "7343513161666707459",
                        "records": [
                            {
                                "progress": 1,
                                "units": [
                                    {
                                        "unit_id": "7343513161666707459",
                                        "data": [
                                            {
                                                "field_id": "7343513161666707459",
                                                "reviewer_user_id": {
                                                    "open_id": "od-asd2dasdasd",
                                                    "user_id": "ou-ux987dsf6x"
                                                },
                                                "submit_time": "7343513161666707459",
                                                "indicator_id": "7343513161666707459",
                                                "option_id": "7343513161666707459",
                                                "score": "1.1",
                                                "text": "qwert",
                                                "tag_based_question_id": "7343513161666707459",
                                                "tag_text_item_data": [
                                                    {
                                                        "tag_text_id": "7343513161666707459",
                                                        "tag_text": "qwertyu",
                                                        "tag_richtext": "{\"ops\":[{\"name\":\"insert\",\"text\":\"qwerty\"}]}"
                                                    }
                                                ],
                                                "perf_coefficient_value": "1.1",
                                                "sub_indicator_data": [
                                                    {
                                                        "field_id": "7343513161666707459",
                                                        "indicator_id": "7343513161666707459",
                                                        "option_id": "7343513161666707459",
                                                        "score": "1.1",
                                                        "text": "qwertyuiop",
                                                        "richtext": "{\"ops\":[{\"name\":\"insert\",\"text\":\"qwerty\"}]}"
                                                    }
                                                ],
                                                "objective_data": [
                                                    {
                                                        "objective_id": "7343513161666707459",
                                                        "score": "1.1",
                                                        "text": "qwertyu",
                                                        "keyresult_data": [
                                                            {
                                                                "keyresult_id": "7343513161666707459",
                                                                "score": "1.1",
                                                                "text": "qwerty",
                                                                "richtext": "{\"ops\":[{\"name\":\"insert\",\"text\":\"qwerty\"}]}"
                                                            }
                                                        ],
                                                        "richtext": "{\"ops\":[{\"name\":\"insert\",\"text\":\"qwerty\"}]}"
                                                    }
                                                ],
                                                "metric_data": [
                                                    {
                                                        "id": "7343513161666707459",
                                                        "score": "1.1"
                                                    }
                                                ],
                                                "leader_review_data_source": "review",
                                                "multi_texts": [
                                                    "qwerty"
                                                ],
                                                "richtext": "{\"ops\":[{\"name\":\"insert\",\"text\":\"qwerty\"}]}",
                                                "multi_richtexts": [
                                                    "{\"ops\":[{\"name\":\"insert\",\"text\":\"qwerty\"}]}"
                                                ],
                                                "is_principal_review_item": true
                                            }
                                        ]
                                    }
                                ],
                                "invited_review_record_info": {
                                    "reviewer_id": {
                                        "open_id": "od-asd2dasdasd",
                                        "user_id": "ou-ux987dsf6x"
                                    },
                                    "is_rejected": false,
                                    "rejected_reason": "test",
                                    "distribute_type": 1,
                                    "avg_diff": "1.23",
                                    "relationship_with_reviewee": "direct_report",
                                    "invitedby": "system_default"
                                },
                                "direct_project_leader_record_info": {
                                    "reviewer_id": {
                                        "open_id": "od-asd2dasdasd",
                                        "user_id": "ou-ux987dsf6x"
                                    },
                                    "cooperation_projects": [
                                        {
                                            "id": "7309457114076807188",
                                            "name": {
                                                "zh_cn": "体验",
                                                "en_us": "Interactive experience"
                                            },
                                            "roles": [
                                                {
                                                    "reviewer_role": {
                                                        "role_id": "7213434603057807379",
                                                        "name": {
                                                            "zh_cn": "体验",
                                                            "en_us": "Interactive experience"
                                                        }
                                                    },
                                                    "reviewee_role": {
                                                        "role_id": "7213434603057807379",
                                                        "name": {
                                                            "zh_cn": "体验",
                                                            "en_us": "Interactive experience"
                                                        }
                                                    }
                                                }
                                            ],
                                            "user_roles": [
                                                {
                                                    "role_id": "7213434603057807379",
                                                    "name": {
                                                        "zh_cn": "体验",
                                                        "en_us": "Interactive experience"
                                                    }
                                                }
                                            ],
                                            "underling_roles": [
                                                {
                                                    "role_id": "7213434603057807379",
                                                    "name": {
                                                        "zh_cn": "体验",
                                                        "en_us": "Interactive experience"
                                                    }
                                                }
                                            ]
                                        }
                                    ],
                                    "review_depend_projects": [
                                        {
                                            "id": "7309457114076807188",
                                            "name": {
                                                "zh_cn": "体验",
                                                "en_us": "Interactive experience"
                                            },
                                            "roles": [
                                                {
                                                    "reviewer_role": {
                                                        "role_id": "7213434603057807379",
                                                        "name": {
                                                            "zh_cn": "体验",
                                                            "en_us": "Interactive experience"
                                                        }
                                                    },
                                                    "reviewee_role": {
                                                        "role_id": "7213434603057807379",
                                                        "name": {
                                                            "zh_cn": "体验",
                                                            "en_us": "Interactive experience"
                                                        }
                                                    }
                                                }
                                            ],
                                            "user_roles": [
                                                {
                                                    "role_id": "7213434603057807379",
                                                    "name": {
                                                        "zh_cn": "体验",
                                                        "en_us": "Interactive experience"
                                                    }
                                                }
                                            ],
                                            "underling_roles": [
                                                {
                                                    "role_id": "7213434603057807379",
                                                    "name": {
                                                        "zh_cn": "体验",
                                                        "en_us": "Interactive experience"
                                                    }
                                                }
                                            ]
                                        }
                                    ],
                                    "participated_projects": [
                                        {
                                            "id": "7309457114076807188",
                                            "name": {
                                                "zh_cn": "体验",
                                                "en_us": "Interactive experience"
                                            },
                                            "roles": [
                                                {
                                                    "reviewer_role": {
                                                        "role_id": "7213434603057807379",
                                                        "name": {
                                                            "zh_cn": "体验",
                                                            "en_us": "Interactive experience"
                                                        }
                                                    },
                                                    "reviewee_role": {
                                                        "role_id": "7213434603057807379",
                                                        "name": {
                                                            "zh_cn": "体验",
                                                            "en_us": "Interactive experience"
                                                        }
                                                    }
                                                }
                                            ],
                                            "user_roles": [
                                                {
                                                    "role_id": "7213434603057807379",
                                                    "name": {
                                                        "zh_cn": "体验",
                                                        "en_us": "Interactive experience"
                                                    }
                                                }
                                            ],
                                            "underling_roles": [
                                                {
                                                    "role_id": "7213434603057807379",
                                                    "name": {
                                                        "zh_cn": "体验",
                                                        "en_us": "Interactive experience"
                                                    }
                                                }
                                            ]
                                        }
                                    ]
                                },
                                "record_id": "7385000219907457024-7385000219907457025"
                            }
                        ],
                        "review_stage_role": "reviewee"
                    }
                ]
            }
        ]
    }
}

错误码

HTTP状态码错误码描述排查建议
4001580102param is invalid检查传入的参数
5001580101internal error内部错误,请稍后重试,仍然出现可以咨询客服
4001580901tenant no licnese租户无绩效席位,请联系租户管理员开通绩效席位

内容来源:飞书开放平台 · 自动爬取整理