接入指南

飞书人事（标准版）接口简介

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

我们提供了安全、可靠的 API，来方便你获取飞书人事（标准版）中的员工花名册信息，使用我们的 API 接口，可将企业原有的平台和飞书人事（标准版）打通。

调用飞书人事（标准版）接口

调用前提

1. 已开通飞书人事（标准版）应用
2. 需先获取飞书开放平台的 ==tenant_access_token==

获取 ==tenant_access_token== 的步骤

• Step 1：在「飞书开放平台」创建「企业自建应用」；
• Step 2：在「权限管理」页面打开飞书人事（标准版） Open API 的权限，并申请上线，企业管理员审核后方可使用；
• Step 3：使用该应用的 API 访问凭证，调用获取 tenant_access_token 接口，获取 token。

接口列表

批量获取员工花名册信息

根据员工飞书用户 ID/员工状态/雇员类型等搜索条件 ，批量获取员工花名册字段信息。

• 最佳实践：获取所有「已离职实习生」的员工信息
  • 搜索条件：==status=5==（已离职），==type=2==（实习）
  • 请求地址：https://open.feishu.cn/open-apis/ehr/v1/employees?status=5&type=2&view=full

下载文件

根据文件 token 下载文件

• 最佳实践：下载员工张三的身份证照片
  • 使用批量获取员工花名册信息接口查询张三的信息，返回中 system_fields.id_photo.id 的值是身份证照片的 token
  • 使用下载文件接口，下载张三的身份证照片。请求地址：https://open.feishu.cn/open-apis/ehr/v1/attachments/8b3f3056515b4439a07858bd10cd0b80