添加人脸

https://api.sciener.com/v3/face/add 向锁里添加人脸，添加成功后可以用人脸进行开锁，主要有两种添加方式：

（1）通过APP或者蓝牙连接锁添加：

开发者可以通过SDK添加人脸，再调用该接口（addType传1）将录入的人脸上同步到云端，方便后续管理。

（2）通过网关或WiFi锁远程添加：

如果是WiFi锁或连有网关的设备，可以调用该接口（addType传2）远程添加人脸。

1 HTTP请求方法及示例

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


xxxxxxxxxx
curl --location -g --request POST 'https://api.sciener.com/v3/face/add' \
--data-urlencode 'clientId=4773aa036f7f49c68d876bb4be85c80c' \
--data-urlencode 'accessToken=dfd5489d0cee31f0bdfaf59d0d42d71f' \
--data-urlencode 'lockId=163377' \
--data-urlencode 'name=妈妈的正脸' \
--data-urlencode 'startDate=1625025703000' \
--data-urlencode 'endDate=1645025703000' \
--data-urlencode 'type=1' \
--data-urlencode 'featureData=F0E41DEAEDF7F31420D5F6FD0403ECF0F4EEF7E6010BF3E5EDEDE5E6F4ED1006FBEDFF02DFF4F3EB09DEF408D6FEE7061616FFFF0008FCE807F6040DF01116FAFFF112DEF9180600FE00F5F41126FCE70CE0071401F715F9FDDF0EEBFB1CFA0BF112FF0E040619010FFCC6DCFBFFD0FFF5EAF600FEF4081E15FF03ECEF1705FC05E0120AEDFCF304ED16F2DF0610FDF4060FFBE1E70CF0FD10EA04EEEB080E0E1117F5F3EF05010D0E02FB0EEBF70F01101507F6F20CFBFBF8162836010BFAFD0603E7F519EFFEF4D514EAFF0107DFEF05F519FC0A08FC11FEFEF3FC0E00FCFB0602F0F20809F6020EF00E0EFD01F2FEF70723E100F10AFFF6D7EBF5FBF7ECF7' \
--data-urlencode 'addType=2' \
--data-urlencode 'date=1625025703000'

2 参数说明

名称	类型	是否必需	描述
clientId	String	Y	创建应用分配的client_id
accessToken	String	Y	访问令牌，通过获取访问令牌接口获取
lockId	Int	Y	锁ID，由锁初始化接口生成
name	String	N	人脸名称
faceNumber	String	N	人脸编号通过APP SDK在锁上添加时，SDK成功回调会返回人脸编号；通过网关或WiFi锁远程添加时，该参数不传
startDate	Long	Y	有效期开始时间（时间戳，单位毫秒）, startDate和endDate都传0 表示永久有效
endDate	Long	Y	有效期结束时间（时间戳，单位毫秒）, startDate和endDate都传0 表示永久有效
type	Int	N	1-普通，4-循环(不传默认1)
cyclicConfig	JsonArray	N	循环操作时间设置（循环类型的才需要传）
featureData	String	N	人脸特征值数据，通过人脸照片获取人脸特征值接口获取，远程添加时需要传
addType	Int	Y	添加方式: 1-通过APP蓝牙添加，不传则默认1，必需先通过APP蓝牙添加后再调用该接口 2-通过网关或WiFi锁远程添加，如果是WiFi锁或有连接网关，则可以传2，直接调用该接口添加到锁里
date	Long	Y	当前时间（时间戳，单位毫秒）

cyclicConfig中的参数：

参数	类型	描述
startTime	Int	开始时间，分钟数, 例如 480 代表 8:00
endTime	Int	结束时间，分钟数, 例如 1080 代表 18:00
weekDay	Int	星期：1-7, 1-星期一...7-星期天

3 返回参数及示例

参数	类型	描述
faceId	Int	人脸ID


xxxxxxxxxx
{
    "faceId": 124242
}