密码开锁

本文将对密码管理相关功能对接进行说明,包含获取随机密码、自定义密码、删除密码、修改密码或有效期等。

一、关于赛脑提供的两套密码方案

1、随机密码:

锁初始化会在锁里和云端同时生成一套统一的密码算法规则和初始化密码数据,可以通过获取键盘密码接口从云端获取一个6-9位数字的随机密码,密码位数主要由密码类型和有效期长短决定,密码随机生成,不可定制。在锁的数字键盘上输入密码后,锁上会通过密码算法规则和数据对密码进行校验,校验通过则开锁成功。

随机密码支持单次、永久、限期、删除、循环类型:

单次密码 只能在开始时间后6小时内使用一次,同一小时最多可以获取200个不同的单次密码;

永久密码 从开始时间开始永久有效,必需在开始时间24小时内使用一次,同一小时最多可以获取20个不同的永久密码;

限期密码 在开始和结束时间内有效,必需在开始时间24小时内使用一次,否则将失效,相同的开始和结束时间(小时)获取到的限期密码只有一个,只能通过调整开始和结束时间错开一个小时以上来获取不同的;

删除密码 在锁上使用后会删除之前在锁上使用过的密码;

注意:随机密码必需在锁上使用过才允许修改。

2、自定义密码:

这种密码方案允许用户自定义一个4-9位的密码,需要把密码写入到锁里,由于存储空间有限,最多只能写入150个。

自定义密码只支持限期、永久类型,有效期可以精确到分钟,没有像随机密码方案那样必需在24小时内使用的限制和同时间段个数限制。

自定义密码有两种添加方式:

(1)通过APP或小程序蓝牙连接锁添加:

开发者可以集成APP SDK开发APP,调用添加密码方法将密码添加到锁里,再调用云端添加自定义密码接口(addType传1),将密码添加到云端,方便后续管理。

(2)通过网关WiFi锁远程添加:

如果是WiFi锁或有连接网关设备,则可以直接调用云端添加自定义密码接口(addType传2),通过网关WiFi锁把密码添加到锁里。

 

随机密码方案不支持自定义,但有更多的密码类型,并且可以直接通过云端接口获取密码去开锁,不需要到锁边上,也不依赖网关设备。

由于锁本身不连网,自定义密码方案比较依赖网络,如果不是WiFi锁并且没连接网关,则需要到锁边上通过APP或小程序蓝牙连接锁,把密码写到锁里,有网关可以通过网关WiFi锁远程写到锁里。

二、修改和删除密码

获取的随机密码和添加的自定义密码都可以通过获取锁的键盘密码列表接口来查看。

不管是随机密码还是自定义密码,远程修改和删除密码都需要网关设备支持,否则只能到锁边上通过APP或小程序蓝牙连接锁进行修改和删除。

修改密码删除密码如果想只通过调用云端API远程删除,changeTypedeleteType 两个参数必需传2表示通过网关WiFi锁修改,否则只调用云端接口是没用的。

三、重置密码

想让之前所有的密码失效,有两种方式,一种是生成一个“删除”类型的随机密码,这种密码在锁上使用后会使之前在锁上使用过的所有密码失效;

还有一种就是重置密码,重置密码会清空锁里存储的密码列表,并重新生成一套密码初始化数据写到锁里。

重置密码不能通过网关WiFi锁远程操作,只能通过APP SDK或小程序在锁边上完成,重置成功后用回调拿到的lockData调用云端的更新锁数据接口,将密码初始化数据上传到云端,这样从云端获取的随机密码才能开锁。

四、密码常见问题

请参考文档:Q&A