# 接入指南
## 飞书人事（标准版）接口简介
飞书人事（标准版），旨在为客户提供完整、闭环的人事管理方案，提升 HR 人事管理的效率和体验。产品功能包含员工管理、统计分析、待办提醒等，帮助 HR 以更低的成本，更高效地完成日常人事管理。

我们提供了安全、可靠的 API，来方便你获取飞书人事（标准版）中的员工花名册信息，使用我们的 API 接口，可将企业原有的平台和飞书人事（标准版）打通。
## 调用飞书人事（标准版）接口
### 调用前提
1. 已开通飞书人事（标准版）应用
2. 需先获取飞书开放平台的 ==tenant_access_token==
>  
> 获取 ==tenant_access_token== 的步骤
> - Step 1：在「[飞书开放平台](https://open.feishu.cn/app/)」创建「[企业自建应用](https://open.feishu.cn/document/home/introduction-to-custom-app-development/self-built-application-development-process)」；
> - Step 2：在「权限管理」页面打开飞书人事（标准版） Open API 的权限，并[申请上线](https://open.feishu.cn/document/uQjL04CN/ukzM04SOzQjL5MDN#%E5%9C%A8%E4%BC%81%E4%B8%9A%E5%86%85%E5%8F%91%E5%B8%83%E4%B8%8A%E7%BA%BF)，企业管理员审核后方可使用；
> - Step 3：使用该应用的 API 访问凭证，调用[获取 tenant_access_token](https://open.feishu.cn/document/ukTMukTMukTM/ukDNz4SO0MjL5QzM/auth-v3/auth/tenant_access_token_internal) 接口，获取 token。

### 接口列表
#### [批量获取员工花名册信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/ehr/ehr-v1/employee/list)
根据员工飞书用户 ID/员工状态/雇员类型等搜索条件 ，批量获取员工花名册字段信息。

- 最佳实践：获取所有「已离职实习生」的员工信息
  - 搜索条件：==status=5==（已离职），==type=2==（实习）
  - 请求地址：https://open.feishu.cn/open-apis/ehr/v1/employees?status=5&type=2&view=full
#### [下载文件](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/ehr/ehr-v1/attachment/get)
根据文件 token 下载文件
  - 最佳实践：下载员工张三的身份证照片
    - 使用[批量获取员工花名册信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/ehr/ehr-v1/employee/list)接口查询张三的信息，返回中 `system_fields.id_photo.id` 的值是身份证照片的 token
    - 使用下载文件接口，下载张三的身份证照片。请求地址：https://open.feishu.cn/open-apis/ehr/v1/attachments/8b3f3056515b4439a07858bd10cd0b80

<br>