获取面试信息

获取面试信息。可通过「投递 ID」、「面试 ID」以及「面试开始时间」进行条件筛选，筛选条件不能同时为空。

请求

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

请求头

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

查询参数

名称	类型	必填	描述
page_size	int	否	分页大小 示例值：10 默认值：10 数据校验规则： - 最大值：100
page_token	string	否	分页标记，第一次请求不填，表示从头开始遍历；分页查询结果还有更多项时会同时返回新的 page_token，下次遍历可采用该 page_token 获取查询结果 示例值：eyJiaXpfdGltZSI6MTcxMDAzNjAwMDAwMCwiaWQiOiI3MzQzMDI3OTMyODE4NjcxOTE2In0
application_id	string	否	投递 ID，可通过获取投递列表接口获取（不允许 application_id、interview_id、start_time、end_time 同时为空） 示例值：6134134355464633
interview_id	string	否	面试 ID（不允许 application_id、interview_id、start_time、end_time 同时为空） 示例值：6888217964693309704
start_time	string	否	面试最早开始时间，毫秒时间戳，必须大于 0（不允许 application_id、interview_id、start_time、end_time 同时为空） 示例值：1609489908000
end_time	string	否	面试最晚开始时间，毫秒时间戳，必须大于 0（不允许 application_id、interview_id、start_time、end_time 同时为空） 示例值：1610489908000
job_level_id_type	string	否	此次调用中使用的「职级 ID」的类型 示例值：people_admin_hob_level_id 可选值有： - people_admin_job_level_id: 「人力系统管理后台」适用的职级 ID。人力系统管理后台逐步下线中，建议不继续使用此 ID。 - job_level_id: 「飞书管理后台」适用的职级 ID，通过获取租户职级列表 接口获取 默认值：people_admin_job_level_id
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？ 默认值：open_id 当值为 user_id，字段权限要求： contact:user.employee_id:readonly 获取用户 user ID

响应

响应体

名称	类型	描述
code	int	错误码，非 0 表示失败
msg	string	错误描述
data	\-	-
└ items	interview_extend\[\]	面试列表
└ id	string	面试 ID
└ begin_time	int	面试开始时间，毫秒时间戳
└ end_time	int	面试结束时间，毫秒时间戳
└ round	int	面试轮次
└ interview_record_list	interview_record\[\]	面试评价信息
└ id	string	面试评价 ID
└ user_id	string	面试官用户 ID，与入参user_id_type类型一致
└ content	string	系统预设题目内容，来自面试评价表中预设字段「记录」，详情参考获取面试评价表列表
└ commit_status	int	面试评价的提交状态 可选值有： - 1: 已提交 - 2: 未提交
└ conclusion	int	面试结论 可选值有： - 1: 通过 - 2: 未通过 - 3: 未开始 - 4: 未提交 - 5: 未到场 - 6: 待定
└ interview_score	interview_score	面试评分
└ id	string	面试评分 ID，对应获取面试评价表列表接口返回数据中的 data.items.modules.dimensions.option_items.id 字段
└ level	int	分数级别
└ zh_name	string	面试评分中文名称
└ zh_description	string	面试评分中文描述
└ en_name	string	面试评分英文名称
└ en_description	string	面试评分英文描述
└ interviewer	id_name_object	面试官信息
└ id	string	面试官 ID，与入参user_id_type类型一致
└ name	i18n	面试官姓名
└ zh_cn	string	面试官中文姓名
└ en_us	string	面试官英文姓名
└ feedback_submit_time	int	面试评价提交时间，毫秒时间戳
└ stage_id	string	面试关联的投递阶段，详情请查看：获取招聘流程信息
└ application_id	string	投递 ID，详情参考获取投递信息
└ stage	id_name_object	阶段信息
└ id	string	投递阶段 ID，详情请查看：获取招聘流程信息
└ name	i18n	阶段信息名称
└ zh_cn	string	阶段信息中文名称
└ en_us	string	阶段信息英文名称
└ creator	id_name_object	创建人信息
└ id	string	创建人 ID，与入参user_id_type类型一致
└ name	i18n	创建人姓名
└ zh_cn	string	创建人中文姓名
└ en_us	string	创建人英文姓名
└ biz_create_time	int	创建时间，毫秒时间戳
└ biz_modify_time	int	最近更新时间，毫秒时间戳
└ interview_round_summary	int	面试状态 可选值有： - 2: 未开始 - 3: 全部未评价 - 4: 全部通过 - 5: 全部淘汰 - 6: 爽约 - 7: 部分评价且均评价通过 - 8: 部分评价且评价中有通过有淘汰的 - 9: 部分评价且均评价淘汰 - 10: 所有面试官都提交评价且评价中有通过有淘汰的 - 11: 部分评价且评价中有通过和待定的 - 12: 部分评价且评价中有淘汰和待定的 - 13: 部分评级且评价均为待定 - 14: 部分评价且评价中有通过、待定和淘汰的 - 15: 所有面试官都提交评价且评价中有通过和待定的 - 16: 所有面试官都提交评价且评价中有待定和淘汰的 - 17: 所有面试官都提交评价且评价均为待定 - 18: 所有面试官都提交评价且评价中有通过、待定、淘汰的
└ interview_arrangement_id	string	面试安排 ID
└ interview_type	int	面试类型 可选值有： - 1: 现场面试 - 2: 电话面试 - 3: 视频面试
└ talent_time_zone	code_name_object	候选人时区
└ code	string	编码
└ name	i18n	候选人时区名称
└ zh_cn	string	候选人中文时区名称
└ en_us	string	候选人英文时区名称
└ contact_user	id_name_object	面试联系人
└ id	string	面试联系人 ID，与入参user_id_type类型一致
└ name	i18n	面试联系人姓名
└ zh_cn	string	面试联系人中文姓名
└ en_us	string	面试联系人英文姓名
└ contact_mobile	string	面试联系人电话
└ remark	string	备注
└ address	interview_address	面试地点
└ id	string	地址 ID，可通过获取地址列表获取
└ name	i18n	地址名称
└ zh_cn	string	地址中文名称
└ en_us	string	地址英文名称
└ district	code_name_object	地址区域
└ code	string	地址编码
└ name	i18n	区域名称
└ zh_cn	string	区域中文名称
└ en_us	string	区域英文名称
└ city	code_name_object	城市
└ code	string	城市编码
└ name	i18n	城市名称
└ zh_cn	string	城市中文名称
└ en_us	string	城市英文名称
└ state	code_name_object	省
└ code	string	省编码
└ name	i18n	省名称
└ zh_cn	string	省中文名称
└ en_us	string	省英文名称
└ country	code_name_object	国家
└ code	string	国家编码
└ name	i18n	国家名称
└ zh_cn	string	国家中文名称
└ en_us	string	国家英文名称
└ video_type	int	视频面试工具 可选值有： - 1: Zoom - 2: 牛客技术类型 - 3: 牛客非技术类型 - 4: 赛码 - 5: 飞书 - 8: Hackerrank - 9: 飞书（含代码考核） - 100: 不使用系统工具
└ arrangement_status	int	当安排类型为集中面试时，此值表示集中面试的安排状态。非集中面试该字段无含义。 可选值有： - 1: 未开始 - 2: 进行中 - 3: 已结束
└ arrangement_type	int	安排类型 可选值有： - 1: 社招单面 - 2: 集中面试
└ arrangement_appointment_kind	int	安排方式（是否使用自助约面） 可选值有： - 1: 直接安排 - 2: 自助约面
└ meeting_room_list	interview_meeting_room\[\]	面试会议室
└ room_id	string	会议室 ID，详情可查看：查询会议室列表
└ room_name	string	会议室名称
└ building_name	string	建筑名称
└ reserved_status	int	会议室预定状态 可选值有： - 1: 预约中 - 2: 预约成功 - 3: 预约失败
└ floor_name	string	楼层
└ interview_round_type	id_name_object	面试轮次类型，详情可查看：获取面试轮次类型列表
└ id	string	面试轮次类型 ID
└ name	i18n	面试轮次类型名称
└ zh_cn	string	面试轮次类型中文名称
└ en_us	string	面试轮次类型英文名称
└ has_more	boolean	是否还有更多项
└ page_token	string	分页标记，当 has_more 为 true 时，会同时返回新的 page_token，否则不返回 page_token

响应体示例

{
    "code": 0,
    "msg": "success",
    "data": {
        "items": [
            {
                "id": "6949805467799537964",
                "begin_time": 1618899376474,
                "end_time": 1618999376474,
                "round": 0,
                "interview_record_list": [
                    {
                        "id": "6949805467799537964",
                        "user_id": "1618899376474",
                        "content": "符合要求，推荐录用",
                        "commit_status": 1,
                        "conclusion": 1,
                        "interview_score": {
                            "id": "6949805467799537964",
                            "level": 3,
                            "zh_name": "第一轮面试",
                            "zh_description": "通过，能力达到要求， 建议录用",
                            "en_name": "English name",
                            "en_description": "Pass, ability to meet the requirements, suggest to hire"
                        },
                        "interviewer": {
                            "id": "1213213123123",
                            "name": {
                                "zh_cn": "周小二",
                                "en_us": "Tony Ma"
                            }
                        }
                    }
                ],
                "feedback_submit_time": 1659318415000,
                "stage_id": "634324253532232",
                "application_id": "634324253532232",
                "stage": {
                    "id": "1213213123123",
                    "name": {
                        "zh_cn": "笔试",
                        "en_us": "writing"
                    }
                },
                "creator": {
                    "id": "1213213123123",
                    "name": {
                        "zh_cn": "张二二",
                        "en_us": "Tony Ma"
                    }
                },
                "biz_create_time": 1618999376474,
                "biz_modify_time": 1618999376474,
                "interview_round_summary": 1,
                "interview_arrangement_id": "1111111",
                "interview_type": 1,
                "talent_time_zone": {
                    "code": "UTC+08:00",
                    "name": {
                        "zh_cn": "亚洲/上海",
                        "en_us": "Asia/Shanghai"
                    }
                },
                "contact_user": {
                    "id": "1213213123123",
                    "name": {
                        "zh_cn": "张三",
                        "en_us": "Tony Ma"
                    }
                },
                "contact_mobile": "13333333333",
                "remark": "这是一个备注",
                "address": {
                    "id": "6949805467799537964",
                    "name": {
                        "zh_cn": "中国",
                        "en_us": "China"
                    },
                    "district": {
                        "code": "DS_1",
                        "name": {
                            "zh_cn": "武侯区",
                            "en_us": "Wu Hou"
                        }
                    },
                    "city": {
                        "code": "CT_1",
                        "name": {
                            "zh_cn": "成都",
                            "en_us": "Chengdu"
                        }
                    },
                    "state": {
                        "code": "ST_1",
                        "name": {
                            "zh_cn": "四川省",
                            "en_us": "SiChuan"
                        }
                    },
                    "country": {
                        "code": "CN_1",
                        "name": {
                            "zh_cn": "中国",
                            "en_us": "China"
                        }
                    }
                },
                "video_type": 1,
                "arrangement_status": 1,
                "arrangement_type": 1,
                "arrangement_appointment_kind": 1,
                "meeting_room_list": [
                    {
                        "room_id": "6949805467799537964",
                        "room_name": "OCG111",
                        "building_name": "OCG",
                        "reserved_status": 1,
                        "floor_name": "17"
                    }
                ],
                "interview_round_type": {
                    "id": "1213213123123",
                    "name": {
                        "zh_cn": "第一轮",
                        "en_us": "Round 1"
                    }
                }
            }
        ],
        "has_more": true,
        "page_token": "1234452132"
    }
}

错误码

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