获取面试记录列表
根据投递 ID 获取面试记录列表
请求
| 项目 | 值 |
|---|---|
| HTTP URL | https://open.feishu.cn/open-apis/hire/v1/applications/:application_id/interviews |
| HTTP Method | GET |
| 权限要求 调用该 API 所需的权限。开启其中任意一项权限即可调用 开启任一权限即可 | 获取面试信息 更新面试信息 |
| 字段权限要求 接口返回的部分字段受权限控制,开启字段权限才可获取对应字段数据;如无需获取这些字段,则无需开启。 根据要获取的字段开启相应权限 | 获取用户 user ID |
请求头
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
| Authorization | string | 是 | tenant_access_token 值格式:"Bearer access_token" 示例值:"Bearer t-7f1bcd13fc57d46bac21793a18e560" 了解更多:如何选择与获取 access token |
路径参数
| 名称 | 类型 | 描述 |
|---|---|---|
application_id | string | 投递ID 示例值:"6949805467799537964" |
查询参数
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
page_size | int | 是 | 分页大小,不能超过 50 示例值:10 |
page_token | string | 否 | 分页标记,第一次请求不填,表示从头开始遍历;分页查询结果还有更多项时会同时返回新的 page_token,下次遍历可采用该 page_token 获取查询结果 示例值:"xx" |
user_id_type | string | 否 | 用户 ID 类型 示例值:"open_id" 可选值有: - open_id:用户的 open id - union_id:用户的 union id - user_id:用户的 user id 默认值:open_id 当值为 user_id,字段权限要求: 获取用户 user ID |
响应
响应体
| 名称 | 类型 | 描述 |
|---|---|---|
code | int | 错误码,非 0 表示失败 |
msg | string | 错误描述 |
data | \- | - |
∟ page_token | string | 分页标志 |
∟ has_more | boolean | 是否有更多 |
∟ items | interview\[\] | 面试列表 |
∟ id | string | 面试id |
∟ begin_time | int | 面试开始时间(ms) |
∟ end_time | int | 面试结束时间(ms) |
∟ round | int | 面试轮次(从0开始计数) |
∟ stage_id | string | 面试关联的投递阶段 |
∟ interview_record_list | interview_record\[\] | 面试官记录列表 |
∟ id | string | 面试记录 ID |
∟ user_id | string | 面试官用户 ID |
∟ content | string | 系统预设「记录」题目内容 |
∟ min_job_level_id | string | 建议定级下限的职级 ID |
∟ max_job_level_id | string | 建议定级上限的职级 ID |
∟ commit_status | int | 提交状态 可选值有: - 1:已提交 - 2:未提交 |
∟ conclusion | int | 面试结论 可选值有: - 1:通过 - 2:未通过 - 3:未开始 - 4:未提交 - 5:未到场 |
∟ interview_score | interview_score | 面试评分 |
∟ id | string | 面试评分 ID |
∟ level | int | 分数级别 |
∟ zh_name | string | 中文名称 |
∟ zh_description | string | 中文描述 |
∟ en_name | string | 英文名称 |
∟ en_description | string | 英文描述 |
响应体示例
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状态码 | 错误码 | 描述 | 排查建议 |
|---|---|---|---|
| 400 | 180001 | param is invalis | 检查参数 |
