拉取从startDate
(包含)至endDate
(包含)的面试列表 列表内容为可读的中文描述信息
HTTP请求
GET https://api.mokahr.com/api-platform/v1/interviews?startDate={startDate}&endDate={endDate}
请求Query参数
字段 | 必填 | 描述 |
---|---|---|
startDate | 否 | 面试日期,格式: ISO8601 |
endDate | 否 | 面试日期,格式: ISO8601 |
createStartDate | 否 | 面试创建日期,格式: ISO8601 |
createEndDate | 否 | 面试创建日期,格式: ISO8601 |
注意,startDate与endDate, createStartDate与createEndDate确定的日期范围不得超过30天, 并且这两对参数必须有一对参数必填。
且我们会按照该时间的年月日取值,只能精确到天。
返回数据
data为面试数组,按照面试开始时间由早到晚排序。其中每一项的数据结构为:
字段 | 类型 | 描述 |
---|---|---|
id | String | 面试id,md5字符串,唯一标识一场面试 |
startTime | String | 面试开始时间。格式遵从ISO8601标准 |
type | String | 面试类型,例如:现场面试、视频面试、电话面试、集体面试 |
duration | Number | 面试时长,单位为分钟,例如:30 |
jobTitle | String | 面试职位 |
stageName | String | 面试所在阶段名称,例如:面试、技术面、HR面等 |
address | String | 面试地址 |
theme | String | 面试主题,格式为 {面试职位}-{面试类型}-{面试轮次} |
status | String | 面试状态。例如:未结束(代表面试尚未开始)、已结束(代表面试已结束)、已取消(代表面试已被取消) |
createdAt | String | 面试创建时间 |
hr | Object | 安排面试的HR |
hr.name | String | 姓名 |
hr.email | String | 邮箱 |
hr.phone | String | 电话。格式为:+{区号} {电话号码} |
candidates | Array | 参加面试的候选人 |
canddiates[].name | String | 姓名 |
candidates[].email | String | 邮箱 |
candidates[].phone | String | 电话。格式为:+{区号} {电话号码} |
candidates[].status | String | 参加面试的状态。例如:候选人未反馈、候选人已接受、候选人已拒绝 |
candidates[].jobTitle | String | 申请职位名称 |
candidates[].applicationId | Number | 申请id, 唯一标识该候选人的一份申请 |
candidates[].groupId | Number | 面试id |
interviewers | Array | 面试官。结构同hr |
注意,字段若为空,则内容为空字符串
请求样例
$ curl https://api.mokahr.com/api-platform/v1/interviews\?startDate\=2018-01-02T00:00:00.000Z\&endDate\=2018-01-04T00:00:00.000Z \
-u 'your_api_key:' \
-X GET
2
3
请求返回数据样例:
{ "data": [ { "id": "d3d9446802a44259755d38e6d163e820", "startTime": "2017-01-03T00:00:00.000Z", "type": "现场面试", "duration": 30, "jobTitle": "Mac开发工程师", "stageName": "技术面", "address": "北京市 海淀区 北京市海淀区海淀西大街", "theme": "Mac开发工程师-现场面试-复试", "status": "已取消", "createdAt": "2019-06-26 21:37:04", "hr": { "name": "李明", "email": "liming@example.com", "phone": "+86 1234567890" }, "candidates": [ { "name": "邓新宇", "email": "dxy@example.com", "phone": "+86 0123456789", "status": "候选人未反馈", "jobTitle": "Mac开发工程师", "applicationId": 1022, "groupId": 1 } ], "interviewers": [ { "name": "旭东", "email": "xudong@example.com", "phone": "" }, { "name": "柳丁", "email": "liuding@example.com", "phone": "+86 1234567890" } ] }, { "startTime": "2017-01-03T02:00:00.000Z", "type": "集体面试", "duration": 60, "jobTitle": "iOS工程师、PHP工程师等3个职位", "stageName": "一面", "address": "北京市 海淀区 北京市海淀区海淀西大街", "theme": "iOS工程师等3个职位-集体面试-初试", "status": "未结束", "hr": { "name": "李明", "email": "liming@example.com", "phone": "+86 1234567890" }, "candidates": [ { "name": "邓新宇", "email": "dxy@example.com", "phone": "+86 0123456789", "status": "候选人已拒绝", "jobTitle": "Mac开发工程师", "applicationId": 1022, "groupId": 2 }, { "name": "金清", "email": "jq@gmail.com", "phone": "", "status": "候选人已接受", "jobTitle": "Android多媒体软件工程师", "applicationId": 1432, "groupId": 3 }, { "name": "应婉蓉", "email": "ywr@gmail.com", "phone": "", "status": "候选人未反馈", "jobTitle": "web前端工程师", "applicationId": 4422, "groupId": 4 } ], "interviewers": [ { "name": "旭东", "email": "xudong@example.com", "phone": "" } ] } ] }