接入说明

• 条件

必须先把HTLock部署完成。

• 申请账号，并请求鉴权

联系门锁供应商提供账号文件。 然后把账号、卡片等文件导入到HTLock本地系统上。 然后使用注册好的账号对接口进行鉴权，调接口的时候需要注意接口协议。

• 设置回调

设置回调地址，该地址在网关上报门锁日志时，会推送到该地址设置回调地址。除了门锁日志，还有删除网关的通知、删除门锁的通知、网关下发指纹、人脸的进度和结果通知，都会推送到该地址。

• ##HTLock添加房源、安装门锁等操作视频

• 远程操作

完成以上操作后，就可以对门锁调用远程功能API，HTTP接口功能如下： 房间列表查询 授权离线密码 授权手机 下发卡片 远程开锁 房间操作记录 房间入住列表 待处理列表 入住详情

• 离线发卡

在离线发卡之前需要先在该账号下关联发卡器。 关联成功后把卡片放在发卡器上，调离线发卡接口即可完成发卡操作。 注意：需要退房的时候要把卡片回收后才能继续使用，防止卡片里面的数据发生错误。

• 修改授权有效期

想对客户进行续住处理的话可以调修改授权有效期接口进行修改。 注意1：该接口只支持对离线卡片和手机授权进行续住。 注意2：离线卡片需要把卡片放在关联的发卡器上才能完成续住。 注意3：房间封房状态不能进行续住。

• 制作多门卡

在制作多门卡之前需要先在该账号下关联发卡器。 关联成功后把卡片放在发卡器上，调制作多门卡接口即可完成发卡操作。 注意：需要退房的时候要把卡片回收后才能继续使用，防止卡片里面的数据发生错误。

• 下发指纹

在下发指纹之前需要先在该账号下关联发卡器。 关联成功后需要调发卡器录入指纹模式接口，然后方手指上去进行按压。 按压过程中可以通过回调地址查看到发卡器按压指纹推送。 在推送中拿到指纹标识或指纹特征值给到指纹下发接口进行下发，下发结果可以在回调地址上查看下发指纹结果推送。 注意：发卡器按压指纹的时候只有最后一包才会有指纹标识和指纹特征值推送。

• 下发人脸

把需要下发的人脸转换成baes64编码，然后调我们的图片处理接口对编码进行处理。 拿到图片处理返回的baes64编码后调下发人脸接口进行下发，下发的结果会通过下发人脸结果通知传到回调地址上。

• 梯控二维码

调用前提是需要在HTLock上先安装梯控，安装完毕后即可调梯控授权。

• 退房

根据业务需求可以分为单个退房和全部退房，这个只需要调取消权限接口即可。 注意：单个退房需要传checkInId参数，该参数可以通过房间入住列表拿到。