招聘¶
获取面试日程列表¶
使用场景:该接口用于获取面试日程列表
请求方式: GET(HTTPS)
请求地址:https://openapi.2haohr.com/api/recruitment/interview/?access_token=ACCESS_TOKEN
请求参数说明:
| 参数 | 类型 | 是否必须 | 说明 | 参数说明 |
|---|---|---|---|---|
| access_token | String | 是 | 调用接口凭证 | |
| name | String | 否 | 候选人姓名 | 支持模糊查询 |
| mobile | String | 否 | 候选人手机号 | 支持模糊查询 |
| String | 否 | 候选人邮箱 | 支持模糊查询 | |
| start_date | String | 否 | 日程开始日期 | yyyy-MM-dd |
| end_date | String | 否 | 日程结束日期 | yyyy-MM-dd |
| interview_count | Int | 否 | 面试轮次 | |
| status | Int | 否 | 候选人状态 | 30-待初筛; 31-初筛通过; 32-初筛淘汰; 40-已安排面试; 41-已面试; 42-面试通过; 43-面试淘汰; 50-拟录用; 51-已发Offer; 52-待入职; 53-已入职; 54-放弃录用 |
| interview_way | Int | 否 | 面试方式 | 1-现场面试;2-电话面试;3-视频面试; |
| is_sign | Boolean | 否 | 签到情况 | false-未签到;true-已签到 |
| p | Int | 否 | 页码 | 默认:1 |
| limit | Int | 否 | 每页条数 | 默认:10;最大一页不能超过50 |
- 参数详细说明
start_dt和end_dt- 不传默认只查询当前日期的面试日程;
- 需要同时都传值或都不传值,不能只传其中一个,传一个都会被直接忽略按都不传处理;
- 传值格式:yyyy-MM-dd,查询指定日期的面试日程;
- 最大查询范围为31天。
响应结构体示例:
{
"data": {
"totalpage": 1,
"total_count": 1,
"p": 1,
"objects": [
{
"add_by_name": "唐后台",
"interview_province_name": "广东",
"dep_name": "蓝蚁部门",
"interview_count": 1,
"job_position": {
"status": 1,
"dep_name": "蓝蚁部门",
"name": "蓝蚁部",
"dep_id": "70e691d5-2976-49fd-a7b7-5093b96d36fd",
"id": "44339c3c-0b6d-489d-89d9-d7d0be69c8b5"
},
"mobile": "13852615236",
"candidate_name": "飞飞飞",
"interview_is_comment": false,
"is_sign": false,
"interview_comment_count": 0,
"interview_address": "4245",
"interview_city_name": "深圳",
"interview_id": "7423e768d5ee45e0bb0d788623382d3c",
"is_group_interview": false,
"interview_participant": [
{
"interview_type": 1,
"id": "0bcf70c97a81470380101e5a5089ef79",
"name": "牛爱华",
"participant_refer_id": "f7c9f801980c420e8c68bac2c1fa16b0",
"participant_id": "0bcf70c97a81470380101e5a5089ef79"
}
],
"interview_linkname": "CoderF",
"interview_dt": "2025-04-10 11:00:00",
"interview_town_name": "南山区",
"dep_id": "70e691d5-2976-49fd-a7b7-5093b96d36fd",
"interview_way": 1,
"email": "13852615236@qq.com",
"candidate_record_status": 40
}
],
"limit": 10,
"offset": 0
},
"errcode": 0,
"errmsg": ""
}
响应参数说明:
| 参数 | 类型 | 是否必须 | 说明 | 参数说明 |
|---|---|---|---|---|
| p | Int | 是 | 当前页码 | |
| total_count | Int | 是 | 数据总条数 | |
| totalpage | Int | 是 | 总页数 | |
| errcode | Int | 是 | 返回码 | |
| errmsg | String | 是 | 对返回码的文本描述内容 | |
| data | Object | 是 | 返回数据 | |
| objects | List | 是 | 数据明细 | |
| └interview_id | String | 是 | 面试日程id | |
| └candidate_name | String | 是 | 候选人姓名 | |
| └mobile | String | 是 | 候选人手机号 | |
| String | 是 | 候选人邮箱 | ||
| └interview_count | Int | 是 | 面试轮次 | |
| └interview_is_comment | Boolean | 是 | 面试评价状态 | false-未评价;true-已评价 |
| └interview_comment_count | Int | 是 | 面试评价次数 | |
| └interview_way | Int | 是 | 面试方式 | 1-现场面试;2-电话面试;3-视频面试; |
| └candidate_record_status | Int | 是 | 候选人状态 | 30-待初筛; 31-初筛通过; 32-初筛淘汰; 40-已安排面试; 41-已面试; 42-面试通过; 43-面试淘汰; 50-拟录用; 51-已发Offer; 52-待入职; 53-已入职; 54-放弃录用 |
| └interview_dt | String | 是 | 面试时间 | |
| └is_sign | Boolean | 是 | 签到情况 | false-未签到;true-已签到 |
| └is_group_interview | Boolean | 否 | 是否群面 | false-否;true-是 |
| └interview_linkname | String | 是 | 联系人 | |
| └interview_province_name | String | 是 | 面试地点所在省份 | |
| └interview_city_name | String | 是 | 面试地点所在城市 | |
| └interview_town_name | String | 是 | 面试地点所在区/县 | |
| └interview_address | String | 是 | 面试地点所在详细地址 | |
| └add_by_name | String | 是 | 面试日程添加人姓名 | |
| └job_position | Object | 是 | 招聘职位信息 | |
| └└id | String | 是 | 招聘职位id | |
| └└status | Int | 是 | 招聘职位状态 | 1-招聘中;2-停止招聘 |
| └└work_type | Int | 是 | 招聘职位工作性质 | 0-全职; 1-兼职; 2-实习生; |
| └└name | String | 是 | 招聘职位名称 | |
| └└dep_id | String | 是 | 招聘职位所属部门id | |
| └└dep_name | String | 是 | 招聘职位所属部门名称 | |
| └└job_title_id | String | 是 | 关联岗位id | |
| └└job_title_name | String | 是 | 关联岗位名称 | |
| └└work_place_id | String | 是 | 工作地点id | |
| └└work_place_name | String | 是 | 工作地点名称 | |
| └interview_participant | List | 否 | 面试官信息集合 | |
| └└id | String | 是 | 面试官信息id | |
| └└name | String | 是 | 面试官姓名 | |
| └└interview_type | Int | 是 | 面试官类型 | |
| └└participant_id | String | 是 | 面试官id | |
| └└participant_refer_id | String | 是 | 面试官关联id | 与面试官类型相关,员工类型为员工id,HR类型为HR |