Skip to content

获取面试评价详细信息

获取面试评价详细信息,如面试结论、面试得分和面试官等信息。

请求

项目
HTTP URLhttps://open.feishu.cn/open-apis/hire/v1/interview_records/:interview_record_id
HTTP MethodGET
接口频率限制20 次/秒
支持的应用类型custom,isv
权限要求 调用该 API 所需的权限。开启其中任意一项权限即可调用 开启任一权限即可hire:interview:readonly 获取面试信息 hire:interview 更新面试信息
字段权限要求> Tip: 该接口返回体中存在下列敏感字段,仅当开启对应的权限后才会返回;如果无需获取这些字段,则不建议申请 contact:user.employee_id:readonly 获取用户 user ID

请求头

名称类型必填描述
Authorizationstringtenant_access_token 值格式:"Bearer access_token" 示例值:"Bearer t-7f1bcd13fc57d46bac21793a18e560" 了解更多:如何选择与获取 access token

路径参数

名称类型描述
interview_record_idstring面试评价 ID,可通过获取面试信息接口获取
示例值:"1618209327096"

查询参数

名称类型必填描述
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?
默认值open_id
当值为 user_id,字段权限要求contact:user.employee_id:readonly 获取用户 user ID

响应

响应体

名称类型描述
codeint错误码,非 0 表示失败
msgstring错误描述
data\--
  └ interview_recordinterview_record面试评价详细信息
    └ idstring面试评价 ID
    └ user_idstring面试官用户 ID,与入参 user_id_type 类型一致
    └ contentstring系统预设「记录」题目内容,见「飞书招聘」-「设置」-「面试设置」-「面试评价表设置」中的「记录」模块
    └ commit_statusint提交状态
可选值有
- 1: 已提交 - 2: 未提交
    └ feedback_submit_timeint面试评价提交时间,毫秒时间戳
    └ conclusionint面试结论
可选值有
- 1: 通过 - 2: 未通过 - 3: 未开始 - 4: 未提交 - 5: 未到场 - 6: 待定
    └ interview_scoreinterview_score面试得分
      └ idstring面试得分 ID
      └ levelint面试得分分数级别
      └ zh_namestring面试得分中文名称
      └ zh_descriptionstring面试得分中文描述
      └ en_namestring面试得分英文名称
      └ en_descriptionstring面试得分英文描述
    └ assessment_scoreassessment_score_info面评打分题分数
      └ calculate_typeint计分方式
可选值有
- 1: 总分 - 2: 平均分
      └ scorenumber(float)分数,精确到小数点后两位
      └ full_scoreint满分
    └ question_listinterview_question\[\]面试题目
      └ idstring面试题题目 ID
      └ titlei18n面试题题目
        └ zh_cnstring面试题中文题目
        └ en_usstring面试题英文题目
      └ descriptioni18n面试题描述
        └ zh_cnstring面试题中文描述
        └ en_usstring面试题英文描述
      └ contentstring面试者作答内容
      └ ability_listability\[\]题目关联的能力项
        └ idstring能力项 ID
        └ namei18n能力项名称
          └ zh_cnstring能力项中文名称
          └ en_usstring能力项英文名称
        └ descriptioni18n能力项描述
          └ zh_cnstring能力项中文描述
          └ en_usstring能力项英文描述
    └ code_question_listinterview_question\[\]在线编程题目
      └ idstring面试题题目 ID
      └ titlei18n面试题题目
        └ zh_cnstring面试题中文题目
        └ en_usstring面试题英文题目
      └ descriptioni18n面试题描述
        └ zh_cnstring面试题中文描述
        └ en_usstring面试题英文描述
      └ contentstring面试者作答内容
    └ interviewerid_name_object面试官信息
      └ idstring面试官用户 ID,与入参 user_id_type 类型一致
      └ namei18n面试官姓名
        └ zh_cnstring面试官中文名
        └ en_usstring面试官英文名
    └ image_listattachment_v2\[\]面试评价图片附件
      └ idstring图片附件 ID,详情请参考获取附件信息
      └ urlstring图片附件下载链接,有效期为 30 分钟
      └ namestring图片附件文件名
      └ mimestring图片附件类型(MIME
      └ create_timestring图片附件创建时间,毫秒时间戳
    └ dimension_assessment_listinterview_dimension_assessment\[\]面试维度评价信息
      └ idstring维度评价 ID
      └ namei18n维度名称
        └ zh_cnstring维度中文名称
        └ en_usstring维度英文名称
      └ full_scoreint打分题总分,仅当维度评价方式为 打分题(单选)打分题(填空) 时可用
      └ contentstring当维度评价方式为 描述题 时,从此取值
      └ dimension_idstring维度 ID,详情可查看:获取面试评价表列表返回结果中 data.items.modules.dimensions 字段
      └ dimension_scoreinterview_dimension_score当维度评价方式为 单选题/打分题(单选) 时,从此取值
        └ idstring选项 ID
        └ namei18n选项名称
          └ zh_cnstring选项中文名称
          └ en_usstring选项英文名称
        └ score_valint选项对应的分数,维度评价为方式 打分题(单选) 时关注该字段
      └ dimension_score_listinterview_dimension_score\[\]当维度评价方式为 多选题 时,从此取值
        └ idstring选项 ID
        └ namei18n选项名称
          └ zh_cnstring选项中文名称
          └ en_usstring选项英文名称
      └ dimension_custom_scoreint当维度评价方式为 打分题(填空)时,从此取值
      └ ability_listability\[\]维度关联能力项
        └ idstring能力项 ID
        └ namei18n能力项名称
          └ zh_cnstring能力项中文名称
          └ en_usstring能力项英文名称
        └ descriptioni18n能力项描述
          └ zh_cnstring能力项中文描述
          └ en_usstring能力项英文描述
      └ question_listinterview_question\[\]维度关联面试题
        └ idstring面试题题目 ID
        └ titlei18n面试题题目
          └ zh_cnstring面试中文题目
          └ en_usstring面试英文题目
        └ descriptioni18n面试题描述
          └ zh_cnstring面试题中文描述
          └ en_usstring面试题英文描述
        └ contentstring面试者作答内容
        └ ability_listability\[\]题目关联的能力项
          └ idstring能力项 ID
          └ namei18n能力项名称
            └ zh_cnstring能力项中文名称
            └ en_usstring能力项英文名称
          └ descriptioni18n能力项描述
            └ zh_cnstring能力项中文描述
            └ en_usstring能力项英文描述
      └ dimension_typeint维度评价方式
可选值有
- 1: 单选题 - 2: 多选题 - 3: 描述题 - 4: 单行文本 - 5: 职级范围 - 6: 打分题(单选) - 7: 打分题(填空) - 10: 系统预设题目 - 结论 - 11: 系统预设题目 - 得分 - 12: 系统预设题目 - 记录

响应体示例

json
{
    "code": 0,
    "msg": "SUCCESS",
    "data": {
        "interview_record": {
            "id": "6949805467799537964",
            "user_id": "ou_d5a80ec46044e4454036308c8e19dc64",
            "content": "代码能力强,思维逻辑清晰",
            "commit_status": 1,
            "feedback_submit_time": 1659318415000,
            "conclusion": 1,
            "interview_score": {
                "id": "6949805467799537964",
                "level": 3,
                "zh_name": "3",
                "zh_description": "通过, 能力达到要求, 建议录用",
                "en_name": "three",
                "en_description": "Pass, ability to meet the requirements, suggest to hire"
            },
            "assessment_score": {
                "calculate_type": 1,
                "score": 1,
                "full_score": 100
            },
            "question_list": [
                {
                    "id": "7270798542321666367",
                    "title": {
                        "zh_cn": "你从业几年了?",
                        "en_us": "How long have you been working?"
                    },
                    "description": {
                        "zh_cn": "当时具体是什么情况?",
                        "en_us": "What was the specific situation at that time?"
                    },
                    "content": "没有",
                    "ability_list": [
                        {
                            "id": "7270798542321666366",
                            "name": {
                                "zh_cn": "创新思维",
                                "en_us": "Creative Thinking"
                            },
                            "description": {
                                "zh_cn": "创新思维",
                                "en_us": "Creative Thinking"
                            }
                        }
                    ]
                }
            ],
            "code_question_list": [
                {
                    "id": "7270798542321666367",
                    "title": {
                        "zh_cn": "是否遇到过团队成员没有达到目标的情况",
                        "en_us": "Have you ever encountered a situation where a team member did not meet their goals?"
                    },
                    "description": {
                        "zh_cn": "当时具体是什么情况?",
                        "en_us": "What was the specific situation at that time?"
                    },
                    "content": "没有"
                }
            ],
            "interviewer": {
                "id": "1213213123123",
                "name": {
                    "zh_cn": "赵鹏",
                    "en_us": "Tom cruise"
                }
            },
            "image_list": [
                {
                    "id": "7270798542321666364",
                    "url": "https://open.feishu.cn/hire/file/blob/xxxx/",
                    "name": "成绩单",
                    "mime": "image/jpg",
                    "create_time": "1693884103327"
                }
            ],
            "dimension_assessment_list": [
                {
                    "id": "6949805467799537964",
                    "name": {
                        "zh_cn": "执行力",
                        "en_us": "Execution capability"
                    },
                    "full_score": 100,
                    "content": "这个候选人还不错",
                    "dimension_id": "11111111",
                    "dimension_score": {
                        "id": "6949805467799537964",
                        "name": {
                            "zh_cn": "选项 1",
                            "en_us": "Option 1"
                        },
                        "score_val": 10
                    },
                    "dimension_score_list": [
                        {
                            "id": "6949805467799537964",
                            "name": {
                                "zh_cn": "选项 1",
                                "en_us": "Option 1"
                            }
                        }
                    ],
                    "dimension_custom_score": 10,
                    "ability_list": [
                        {
                            "id": "7270798542321666366",
                            "name": {
                                "zh_cn": "创新思维",
                                "en_us": "Creative Thinking"
                            },
                            "description": {
                                "zh_cn": "创新思维",
                                "en_us": "Creative Thinking"
                            }
                        }
                    ],
                    "question_list": [
                        {
                            "id": "7270798542321666367",
                            "title": {
                                "zh_cn": "是否遇到过团队成员没有达到目标的情况",
                                "en_us": "Have you ever encountered a situation where a team member did not meet their goals?"
                            },
                            "description": {
                                "zh_cn": "当时具体是什么情况?",
                                "en_us": "What was the specific situation at that time?"
                            },
                            "content": "没有",
                            "ability_list": [
                                {
                                    "id": "7270798542321666366",
                                    "name": {
                                        "zh_cn": "创新思维",
                                        "en_us": "Creative Thinking"
                                    },
                                    "description": {
                                        "zh_cn": "创新思维",
                                        "en_us": "Creative Thinking"
                                    }
                                }
                            ]
                        }
                    ],
                    "dimension_type": 1
                }
            ]
        }
    }
}

错误码

HTTP状态码错误码描述排查建议
5001002001系统错误请根据实际报错信息定位或咨询技术支持
4001002002参数错误检查参数是否正确,例如类型,大小

更多错误码信息,参见通用错误码

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