Skip to content

获取面试记录列表

根据投递 ID 获取面试记录列表

请求

项目
HTTP URLhttps://open.feishu.cn/open-apis/hire/v1/applications/:application_id/interviews
HTTP MethodGET
权限要求 调用该 API 所需的权限。开启其中任意一项权限即可调用 开启任一权限即可获取面试信息 更新面试信息
字段权限要求 接口返回的部分字段受权限控制,开启字段权限才可获取对应字段数据;如无需获取这些字段,则无需开启。 根据要获取的字段开启相应权限获取用户 user ID

请求头

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

路径参数

名称类型描述
application_idstring投递ID 示例值:"6949805467799537964"

查询参数

名称类型必填描述
page_sizeint分页大小,不能超过 50 示例值:10
page_tokenstring分页标记,第一次请求不填,表示从头开始遍历;分页查询结果还有更多项时会同时返回新的 page_token,下次遍历可采用该 page_token 获取查询结果 示例值:"xx"
user_id_typestring用户 ID 类型 示例值:"open_id" 可选值有: - open_id:用户的 open id - union_id:用户的 union id - user_id:用户的 user id 默认值open_id 当值为 user_id,字段权限要求: 获取用户 user ID

响应

响应体

名称类型描述
codeint错误码,非 0 表示失败
msgstring错误描述
data\--
∟ page_tokenstring分页标志
∟ has_moreboolean是否有更多
∟ itemsinterview\[\]面试列表
∟ idstring面试id
∟ begin_timeint面试开始时间(ms)
∟ end_timeint面试结束时间(ms)
∟ roundint面试轮次(从0开始计数)
∟ stage_idstring面试关联的投递阶段
∟ interview_record_listinterview_record\[\]面试官记录列表
∟ idstring面试记录 ID
∟ user_idstring面试官用户 ID
∟ contentstring系统预设「记录」题目内容
∟ min_job_level_idstring建议定级下限的职级 ID
∟ max_job_level_idstring建议定级上限的职级 ID
∟ commit_statusint提交状态 可选值有: - 1:已提交 - 2:未提交
∟ conclusionint面试结论 可选值有: - 1:通过 - 2:未通过 - 3:未开始 - 4:未提交 - 5:未到场
∟ interview_scoreinterview_score面试评分
∟ idstring面试评分 ID
∟ levelint分数级别
∟ zh_namestring中文名称
∟ zh_descriptionstring中文描述
∟ en_namestring英文名称
∟ en_descriptionstring英文描述

响应体示例

json
{
    "code": 0,
    "msg": "success",
    "data": {
        "page_token": "xx",
        "has_more": false,
        "items": [
            {
                "id": "6949805467799537964",
                "begin_time": 1618899376474,
                "end_time": 1618999376474,
                "round": 0,
                "stage_id": "634324253532232",
                "interview_record_list": [
                    {
                        "id": "6949805467799537964",
                        "user_id": "1618899376474",
                        "content": "代码还行,只是不够聪明",
                        "min_job_level_id": "6435238827342432",
                        "max_job_level_id": "643523885843573",
                        "commit_status": 1,
                        "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"
                        }
                    }
                ]
            }
        ]
    }
}

错误码

HTTP状态码错误码描述排查建议
400180001param is invalis检查参数

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