门禁对接指南
概述
通过门禁组件,第三方仅需关注设备和人员本身、以及门禁设备与人员的权限关系,而人员权限下发至门禁设备的过程由组件内部的逻辑进行处理,第三方接收组件抛出的下发结果即可。
使用场景
概念说明
注:最终实际的通行权限,还受到人员权限和计 划模板的控制
接入流程




步骤5:更新人员权限信息。对于绑定权限组时指定权限信息的人员权限进行更新,该接口使用全量更新逻辑,不传的权限参数部分会使用默认值下发,目前仅支持单个人员权限信息的更新,详细使用说明请参考权限下发 >> 人员权限信息更新






syncStatus
为1,即同步失败,则需要调用下发失败记录查询接口查看失败原因,详见门禁服务能力 >> 权限下发#查询下发失败记录,如下图所示


详细使用说明
下发说明
下发过程

约束/注意说明
备注:由于放开了一个人员只能在一个权限组的限制,因此查询结果中的权限组ID并不完全。
常见权限操作
备注:
1、权限操作相关接口参考门禁服务能力 >> 权限分组和门禁服务能力 >> 权限下发。
2、以下图示中,序列线上的“开发者”表示开发者主动调用云眸外部独立应用开发接口,“云眸”表示操作由云眸开发者服务发起。
3、以下图示中,“反馈下发结果”表示权限处理完成后,会向开发者的消息通道中发送消息类型定义 >> 门禁权限下发结果消息,开发者需要根据消息通道的说明进行获取。以下过程中不再进行说明。
权限下发到设备

hasCapability
为false
,说明能力集不可用,请参考设备能力集说明中的指导进行原因排查以及重新获取能力集。从设备移除权限

人员相关操作
说明:
1、此处的操作包括:人员编辑、人员删除、人脸添加、人脸更新、人脸删除、卡号添加、卡号删除。相关接口见基础服务能力 >> 人员管理和门禁服务能力 >> 卡片操作。
2、开发者调用了以上接口时,门禁服务会自动触发相关权限的操作(前置条件:人员绑定了权限组),无需再调用权限分组和权限下发相关的接口进行权限操作。

设备上线
1、为避免设备下线造成权限下发异常,建议开发者关注设备上下线消息(消息类型定义 >> 设备上下线消息),及时知晓设备状态。
2、设备出现频繁上下线时,仅支持每隔30分钟进行一次权限下发。
3、由于设备上线时,设备内部会进行一些初始化操作,如果立马进行权限下发,设备可 能会响应超时。因此,会等待2分钟后再执行。