Skip to content

通过网关添加指纹 ​

https://cnapi.ttlock.com/v3/fingerprint/add

目前只支持添加中正指纹采集仪采集的指纹,也只有安装了中正指纹头的锁才支持。

集成中正指纹SDK采集指纹数据,通过网关或WiFi锁远程下发指纹数据到锁里。

添加的指纹,可以通过获取锁名下指纹列表接口查询。

1 HTTP请求方法及示例 ​

POST, ContentType:application/x-www-form-urlencoded

javascript
curl --location -g --request POST 'https://cnapi.ttlock.com/v3/fingerprint/add' \
--data-urlencode 'clientId=4773aa036f7f49c68d876bb4be85c80c' \
--data-urlencode 'accessToken=dfd5489d0cee31f0bdfaf59d0d42d71f' \
--data-urlencode 'lockId=163377' \
--data-urlencode 'fingerprintData=xxxxxxxxxxxxxxxxx' \
--data-urlencode 'fingerprintType=1' \
--data-urlencode 'addType=2' \
--data-urlencode 'fingerprintName=妈妈的指纹' \
--data-urlencode 'startDate=1625025703000' \
--data-urlencode 'endDate=1645025703000' \
--data-urlencode 'date=1625025703000'

2 参数说明 ​

名称类型是否必需描述
clientIdStringY创建应用分配的client_id
accessTokenStringY访问令牌,通过获取访问令牌接口获取
lockIdIntY锁ID,由锁初始化接口生成
fingerprintDataStringY指纹数据,来源于中正指纹采集仪
fingerprintTypeIntY指纹类型:1-普通、4-循环
addTypeIntY添加方式,固定传2,表示通过网关或WiFi锁下发
fingerprintNameStringN指纹名称
startDateLongY有效期开始时间(时间戳,单位毫秒), startDate和endDate都传0 表示永久有效
endDateLongY有效期结束时间(时间戳,单位毫秒), startDate和endDate都传0 表示永久有效
cyclicConfigJSONArrayN循环时间设置,目前只支持每天开始时间和结束时间一样的设置,示例: [{"weekDay":1, "startTime":480,"endTime":1080},{"weekDay":2, "startTime":480,"endTime":1080}] 表示周一和周二8:00到18:00有效
dateLongY当前时间(时间戳,单位毫秒)

cyclicConfig中的参数:

参数类型描述
startTimeInt开始时间,分钟数, 例如 480 代表 8:00
endTimeInt结束时间,分钟数, 例如 1080 代表 18:00
weekDayInt星期:1-7, 1-星期一...7-星期天

3 返回参数及示例 ​

参数类型描述
fingerprintIdInt指纹ID
{
    "fingerprintId": 224242
}