获取人才面试信息

获取人才下所有面试信息。

请求

项目	值
HTTP URL	https://open.feishu.cn/open-apis/hire/v1/interviews/get_by_talent
HTTP Method	GET
接口频率限制	1000 次/分钟、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

查询参数

名称	类型	必填	描述
talent_id	string	是	人才 ID，可通过获取人才列表接口获取 示例值：6949805467799537964
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
job_level_id_type	string	否	此次调用中使用的「职级 ID」的类型 示例值：job_level_id 可选值有： - people_admin_job_level_id: 「人力系统管理后台」适用的职级 ID。人力系统管理后台逐步下线中，建议不继续使用此 ID。 - job_level_id: 「飞书管理后台」适用的职级 ID，通过「获取租户职级列表」接口获取 默认值：people_admin_job_level_id

响应

响应体

名称	类型	描述
code	int	错误码，非 0 表示失败
msg	string	错误描述
data	\-	-
└ items	talent_interview\[\]	投递面试列表
└ application_id	string	投递 ID，详情可查看：获取投递信息
└ interview_list	interview_extend\[\]	面试列表
└ id	string	面试 ID，详情请查看：获取面试信息
└ begin_time	int	面试开始时间，毫秒时间戳（字段类型为：int64）
└ end_time	int	面试结束时间，毫秒时间戳（字段类型为：int64）
└ 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	面试评价提交时间，毫秒时间戳（字段类型为：int64）
└ 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	创建时间，毫秒时间戳（字段类型为：int64）
└ biz_modify_time	int	最近更新时间，毫秒时间戳（字段类型为：int64）
└ 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	面试轮次类型英文名称

响应体示例

{
	"code": 0,
	"msg": "ok",
	"data": {
		"items": [{
			"application_id": "6949805467799537964",
			"interview_list": [{
				"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": "3",
						"zh_description": "通过, 能力达到要求, 建议录用",
						"en_name": "three",
						"en_description": "Pass, ability to meet the requirements, suggest to hire"
					},
					"interviewer": {
						"id": "ou_266ed047ed37f24554e5a0afdbb15556",
						"name": {
							"zh_cn": "段誉",
							"en_us": "Yu Duan"
						}
					}
				}],
				"stage_id": "634324253532232",
				"application_id": "634324253532232",
				"stage": {
					"id": "634324253532232",
					"name": {
						"zh_cn": "待入职",
						"en_us": "Prehire"
					}
				},
				"creator": {
					"id": "ou_266ed047ed37f24554e5a0afdbb15556",
					"name": {
						"zh_cn": "段誉",
						"en_us": "Yu Duan"
					}
				},
				"biz_create_time": 1618999376474,
				"biz_modify_time": 1618999376474,
				"interview_round_summary": 1,
				"interview_arrangement_id": "634324253532232",
				"interview_type": 1,
				"talent_time_zone": {
					"code": "Asia/Shanghai",
					"name": {
						"zh_cn": "(GMT+08:00) 中国标准时间 - 北京",
						"en_us": "(GMT+08:00) China Standard Time - Beijing"
					}
				},
				"contact_user": {
					"id": "ou_266ed047ed37f24554e5a0afdbb15556",
					"name": {
						"zh_cn": "段誉",
						"en_us": "Yu Duan"
					}
				},
				"contact_mobile": "13333333333",
				"remark": "test",
				"address": {
					"id": "6949805467799537964",
					"name": {
						"zh_cn": "中国四川成都天府二街155号",
						"en_us": "No. 155, Tianfu 2nd Street, Chengdu, Sichuan, China"
					},
					"district": {
						"code": "DS_1",
						"name": {
							"zh_cn": "武侯区",
							"en_us": "Wuhou"
						}
					},
					"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": "6949805467799537964",
					"name": {
						"zh_cn": "一面",
						"en_us": "Round one"
					}
				}
			}]
		}]
	}
}

错误码

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