Open Platform
Skip to content

Get remotes of a lock ​

https://cnapi.sciener.com/v3/remote/listByLock

List all remotes added to a lock.

1 Request example ​

javascript
curl --location -g --request GET 'https://cnapi.sciener.com/v3/remote/listByLock?clientId=fd2ff35ee3d8424c8665c07b7b9a7f45&accessToken=780f7671b6e6be3010d9787f19207aca&lockId=1719&date=1625025703000'

2 Request parameters ​

NameTypeRequiredDescription
clientIdStringYclient_id from Create application
accessTokenStringYAccess token,refer to: Get access token
lockIdIntYLock ID, generated by Lock init
orderByIntYSort by: 0-by name, 1-reverse order by time, 2-reverse order by name
dateLongYCurrent time (timestamp in millisecond)

3 Response and example ​

ParameterTypeDescription
listJSONObject list of records

The objects in the list

ParameterTypeDescription
remoteIdIntRemote ID
nameStringName
macStringMac address
electricQuantityIntBattery
statusStringStatus:1-normal、2-expirex、3-pending
nicknameStringCreator nickname
userIdStringCreator username
startDateLongThe time when it becomes valid (timestamp in millisecond)
endDateLongThe time when it becomes valid (timestamp in millisecond)
typeIntType: 1-normal, 4-recurring
cyclicConfigJsonArrayRecurring 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.
createDateLongCreate date
{
    "list": [
        {
            "remoteId": 4242,
            "number": "RC_a8179f",
            "name":"Front door remote",
            "mac": "33:33:33:33:33:33",
            "electricQuantity": 85,
            "type":1,
            "nickname":"张三",
            "status":1,
            "userid":"zhangsan@gmail.com",
            "startDate":1625025703000,
            "endDate":1645025703000,
            "createDate":1625025703000
        }
    ]
}
CopyRight © 2012-2026 Sciener.All Rights Reserved