# 概述
## 功能介绍
智能门禁应用是飞书科技提供的一款官方应用，用于管理飞书人脸门禁考勤机，提供设备管理、权限组管理、人脸照片管理、开门记录管理等管理功能，帮助企业提升门禁管理效率。

> 注：如需购买飞书人脸门禁考勤机，请联系飞书客服。

## 名词解释
### 设备管理
应用管理员可以将人脸门禁考勤机绑定到本租户，智能门禁 API 提供[门禁设备](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/acs-v1/device/overview)接口用于获取绑定到租户的门禁设备列表。

### 权限组管理
应用管理员可以创建门禁权限组，给权限组添加成员，成员可以是租户全员、部门、个人。权限组绑定到设备后，权限组内的所有成员在绑定的设备上拥有开门/打卡权限。智能门禁 API 提供[用户接口](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/acs-v1/user/overview)，用于获取智能门禁用户列表，修改用户门禁卡号。

权限组内的用户信息变更，会通过[智能门禁用户变更事件](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/acs-v1/user/events/updated) 通知给订阅了该事件的企业应用。
**注意事项**：只能获取已加入门禁权限组的用户

### 人脸图片管理
用户需要录入人脸图片才可以使用门禁考勤机。智能门禁 API 提供[人脸图片接口](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/acs-v1/user-face/overview)，用于上传和下载门禁用户的人脸图片。

### 开门记录管理
用户在门禁考勤机上成功开门或打卡后，智能门禁应用都会生成一条门禁记录，通过[门禁访问记录事件](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/acs-v1/access_record/events/created) 通知给订阅了该事件的企业应用。 

智能门禁 API 提供[门禁记录接口](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/acs-v1/access_record/overview)用于获取指定时间和指定设备的门禁记录，提供[识别图片接口](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/acs-v1/access_record-access_photo/overview)用于下载对应门禁记录的抓拍图片。

## 权限说明

权限 | 描述
---|---
查看智能门禁设备列表 | 查看租户内所有门禁设备列表
查看、更新智能门禁用户 | 查看、修改智能门禁用户信息<br>上传、下载智能门禁用户人脸图片<br>订阅智能门禁用户变更事件
查看智能门禁记录 | 查看门禁记录列表      <br>下载门禁记录抓拍图片   <br>订阅门禁访问记录事件