Add remote

https://api.sciener.com/v3/remote/add

Request this API after successfully adding a remote to the lock via APP SDK, this API just upload the remote's info to the cloud server to facilitate follow-up management.

You can add multiple remotes to a lock.

1 Request example

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


xxxxxxxxxx
curl --location -g --request POST 'https://api.sciener.com/v3/remote/add' \
--data-urlencode 'clientId=4773aa036f7f49c68d876bb4be85c80c' \
--data-urlencode 'accessToken=dfd5489d0cee31f0bdfaf59d0d42d71f' \
--data-urlencode 'lockId=163377' \
--data-urlencode 'number=RC_a8179f' \
--data-urlencode 'name=Front door remote' \
--data-urlencode 'mac=33:33:33:33:33:33' \
--data-urlencode 'startDate=1625025703000' \
--data-urlencode 'endDate=1645025703000' \
--data-urlencode 'type=1' \
--data-urlencode 'electricQuantity=86' \
--data-urlencode 'firmwareInfo={"modelNum":"SN351_PV53","hardwareRevision":"1.1","firmwareRevision":"6.0.0.210311"}' \
--data-urlencode 'date=1625025703000'

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
number	String	Y	Remote serial number
name	String	N	Name
mac	String	Y	Mac
startDate	Long	Y	The time when it becomes valid (timestamp in millisecond)
endDate	Long	Y	The time when it becomes valid (timestamp in millisecond)
type	Int	N	Type: 1-normal, 4-recurring
cyclicConfig	JsonArray	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.
electricQuantity	Int	Y	Battery
firmwareInfo	JSONObject	Y	Fireware info
date	Long	Y	Current time (timestamp in millisecond)

3 Response and example

Parameter	Type	Description
remoteId	Int	Remote ID


{
    "remoteId": 4242
}