修改指纹有效期

https://api.sciener.com/v3/fingerprint/changePeriod

修改指纹有效期,主要有两种修改方式:

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

开发者可以集成APP SDK开发自己的APP,通过蓝牙修改指纹有效期,再调用该接口(changeType传1),将修改后的有效期同步到云端。

(2)通过网关WiFi锁远程修改:

如果是WiFi锁或有连接网关设备,则可以直接调用该接口(changeType传2),通过网关WiFi锁直接修改锁里指纹的有效期。

1 HTTP请求方法及示例

2 参数说明

名称类型是否必需描述
clientIdStringY创建应用分配的client_id
accessTokenStringY访问令牌,通过获取访问令牌接口获取
lockIdIntY锁ID,由锁初始化接口生成
fingerprintIdIntY指纹ID,由添加指纹接口生成
startDateLongY修改后指纹有效期开始时间(时间戳,单位毫秒),不支持修改成永久
endDateLongY修改后指纹有效期结束时间(时间戳,单位毫秒),不支持修改成永久
cyclicConfigJSONArrayN循环时间设置,目前只支持每天开始时间和结束时间一样的设置,示例:
[{"weekDay":1, "startTime":480,"endTime":1080},{"weekDay":2, "startTime":480,"endTime":1080}] 表示周一和周二8:00到18:00有效
changeTypeIntY修改方式:
1-通过APP走蓝牙修改,不传默认1,必需先通过APP SDK蓝牙修改后调用该接口
2-通过网关WiFi锁修改,如果是WiFi锁或有连接网关,则可以传2,直接调用该接口修改生效
3-NB-IoT,如果是NB-IoT锁,可以传3,通过NB网络下发指令,要等NB唤醒才会下发生效,NB不支持修改循环指纹有效期。
dateLongY当前时间(时间戳,单位毫秒)

cyclicConfig中的参数:

参数类型描述
startTimeInt开始时间,分钟数, 例如 480 代表 8:00
endTimeInt结束时间,分钟数, 例如 1080 代表 18:00
weekDayInt星期:1-7, 1-星期一...7-星期天,示例:[1,2,3,4,5] 表示周一到周五有效

3 返回参数及示例

参数类型描述
errcodeInt错误码
errmsgString错误信息
descriptionString错误描述