锁操作记录说明

对锁的操作,锁上会生成记录并存储在锁里,用科技侠APP蓝牙开锁后APP会自动读取锁里新生成未读取过的记录并上传到云端。

开发者也可以集成APP SDK来实现读取锁操作记录,然后调用云端上传锁记录接口,将记录上传到云端。

开发者可以通过获取锁记录列表接口获取云端的锁记录。

如果是WiFi锁或锁有连接网关,当锁上有新记录产生时,记录会被自动读取并上传到云端。

1、锁操作记录存储数量和时间限制

由于锁上存储空间有限,锁上最多存储500条记录(新出的锁可能支持更大的容量),超出最大限制后,老的记录会被新记录挤掉,所以如果不是WiFi锁并且没连接网关,需要按时用APP去读取记录,否者记录可能丢失。

锁操作记录上传到云端后,云端会保存半年的记录,超过半年之前的记录会被归档,不可读取。

2、锁记录的通知与回调

如果不是WiFi锁并且没连接网关,大部分锁操作记录只存储在锁里,云端无法实时给到用户或开发者通知。

对于科技侠APP或我司定制的APP,用普通用户电子钥匙APP蓝牙开锁,开锁成功即会通知云端,云端系统会给管理员APP推送消息。

如果是WiFi锁或锁有连接网关,网关会实时去读取所有新生成的记录,并上传到云端,锁管理员APP用户可以实时收到开锁推送消息,防撬报警记录还会触发短信或邮件通知(根据用户账号是手机号还是电子邮箱);

云端实时收到的锁操作记录都支持实时回调通知开发者,应用审核通过后,开发者可以在管理中心的应用详情页里设置回调地址,用来接收记录回调通知,接口的具体实现请参考文档:锁记录回调通知

3、操作记录类型说明

记录上传到云端时云端会对记录处理和过滤,开发者用APP SDK读取并上传时的记录和获取锁记录列表接口获取的记录是有差别的。

APP SDK读取到的锁里原始的记录类型(recordType)说明请参考:锁里的记录类型

从云端获取的记录类型请参考云端锁记录类型