Change the period of validity of a face data

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

Change the period of validity of face data , there are two methods to do it：

(1) Change by APP nearby the lock via bluetooth：

You can develop your own APP based on our APP SDK，call Modify a face's validity method to change it in the lock, then request this API ( with type=1) to sync it to cloud.

(2) Change by cloud API via gateway or WiFi lock：

If the lock is WiFi lock or it's connected to a gateway, you can change it remotely，just request this API ( with type=2) .

1 Request example


xxxxxxxxxx
curl --location -g --request POST 'https://api.sciener.com/v3/fingerprint/changePeriod' \
--data-urlencode 'clientId=fd2ff35ee3xxxxxx' \
--data-urlencode 'accessToken=780f7671b6e6bxxxxxxx' \
--data-urlencode 'lockId=24451' \
--data-urlencode 'faceId=224242' \
--data-urlencode 'startDate=1626945087000' \
--data-urlencode 'endDate=1846945087000' \
--data-urlencode 'type=2' \
--data-urlencode 'date=1626945087000'

2 Request parameters

Name	Type	Required	Description
clientId	String	Y	client_id from Create application
accessToken	String	Y	Access token，refer to: Get access token
lockId	Int	Y	Lock ID, generated by Lock init
faceId	Int	Y	Face ID, generated from Add face API
startDate	Long	Y	The time when it becomes valid (timestamp in millisecond), you can't change it to permanent
endDate	Long	Y	The time when it is expired (timestamp in millisecond), you can't change it to permanent
cyclicConfig	String	N	Recurring time period, the valid time period of each week day must be the same, for example: `[{"weekDay":1, "startTime":480,"endTime":1080},{"weekDay":2, "startTime":480,"endTime":1080}]` for valid from 8:00 to 18:00 in Monday and Tuesday.
type	Int	Y	Method: 1-via phone bluetooth, you should call APP SDK method first 2- via gateway or WiFi lock, you can call this api directly if it's a WiFi lock or it's connected to gateway The default value is 1.
date	Long	Y	Current time (timestamp in millisecond)

Description of parameters in cyclicConfig：

Parameter	Type	Description
startTime	Int	The time when it becomes valid, in minute, for example 480 for 8:00
endTime	Int	The time when it becomes validit is expired, in minute, for example 1080 for 18:00
weekDay	Int	Week day：1-7, 1-Monday, 2-Tuesday...7-Sunday

3 Response and example

Parameter	Type	Description
errcode	Int	Error code
errmsg	String	Error message


xxxxxxxxxx
{
    "errcode": 0, 
    "errmsg": "none error message"
}