# 招聘概述

飞书招聘是一款智能高效的招聘管理系统。提供招聘流程个性化配置、视频面试、企业人才库等功能，并与飞书深度打通。通过飞书招聘API，可以管理招聘生命周期的各个环节。

## 基础概念

-  人才（Talent）：企业的招聘对象，身份证号或邮箱账号或手机号唯一指定了一个人才。每个人才都有一个唯一的 `talent_id` 作为标识。
- 职位（Job）：招聘岗位、招聘要求、招聘流程等的集合体，每一个职位都有一个唯一的`job_id`作为标识。
- 投递（Application）：人才投递职位后，就形成一次投递。招聘核心流程（评估、笔试、面试、Offer、入职）都会通过投递与人才、职位关联，每一个投递都有一个唯一的`application_id`作为标识。

## 招聘流程

通常的招聘核心流程如下：
- 企业发布招聘**职位**到市场上
- 应聘者看到招聘信息后，对该职位进行**投递**，成为企业人才库中的一个**人才**
- 企业接收到**投递**后，对该投递进行**评估**，评估通过后进行**笔试**、**面试**，面试通过后发放**offer**，应聘者接受offer后，进入入职流程

总之，招聘是人才和职位的匹配过程。因此，飞书招聘以“职位”和“人才”为中心进行开放。关键业务模型关系图如下：

![openApi-ER图.png](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/fd1c5269f91079d33a0cbe8c8f39bac9_lMIL6FTww3.png?lazyload=true&width=3436&height=2415)

## 接入流程

|   | 步骤         | 操作方法                                                                                                                                                                                                                                                                                                                            |
| - | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 1 | 创建应用       | 根据应用的使用场景选择[创建企业自建应用](https://open.feishu.cn/document/home/introduction-to-custom-app-development/self-built-application-development-process) 或[创建应用商店应用](https://open.feishu.cn/document/uMzNwEjLzcDMx4yM3ATM/uYzNwEjL2cDMx4iN3ATM)                                                                                 |
| 2 | 申请应用接口调用权限 | 根据需要调用的接口文档中描述的「**权限要求**」到[开发者后台](https://open.feishu.cn/app)[申请应用权限](https://open.feishu.cn/document/ukTMukTMukTM/uQjN3QjL0YzN04CN2cDN#af863cb3)                                                                                                                                                                             |
| 3 | 访问接口       | 招聘目前大多数接口仅支持tenant_access_token的访问凭证，具体参见接口文档中的「请求头」-Authorization字段的描述                                                                                                                                                                                                                                                         |
| 4 | 接口测试       | 你可以在 [API 调试台![API cn.svg](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/90b013d1fc7c191381d3edd6cf147707_3VtIkELbfg.svg?height=24&lazyload=true&width=87)](https://open.feishu.cn/api-explorer?from=guide)中快速调试这些 API ，使用方法参见[API 调试台使用指南](https://open.feishu.cn/document/tools-and-resources/api-explorer-guide)                                                                                                                                                  |
| 5 | 事件订阅       | 需要到[开发者后台](https://open.feishu.cn/app)[配置事件回调地址](https://open.feishu.cn/document/ukTMukTMukTM/uUTNz4SN1MjL1UzM#2eb3504a),确保回调地址公网可访问。可参考[事件监听示例](https://open.feishu.cn/document/home/develop-a-bot-in-5-minutes/create-an-app)、[事件订阅概述](https://open.feishu.cn/document/ukTMukTMukTM/uUTNz4SN1MjL1UzM#2eb3504a)|
| 6 | 日志检索       | 当调用接口返回失败时，从返回的header部分获取 X-Tt-Logid: `20220501181xxx8035096193288FA`。再到应用管理后台，用[服务端日志检索](https://open.feishu.cn/document/tools-and-resources/open-api-log-query) 分析问题