Get lock details
https://cnapi.sciener.com/v3/lock/detail
Only lock's administrator is allowed to get lock details. Note: If the lock does not support certain feature, or has never been configured, the configuration information may not appear in this list.
The ekey user can request cloud API: Get one ekey to get the lockData of a lock.
1 Request example
javascript
curl --location -g --request GET 'https://cnapi.sciener.com/v3/lock/detail?clientId=fd2ff35ee3d8424c8665c07b7b9a7f45&accessToken=780f7671b6e6be3010d9787f19207aca&lockId=10&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 |
| date | Long | Y | Current time (timestamp in millisecond) |
3 Response and example
Only lock's administrator is allowed to get lock details. Note: If the lock does not support certain feature, or has never been configured, the configuration information may not appear in this list.
| Parameter | Type | Description |
|---|---|---|
| lockId | Int | Lock ID |
| lockName | String | Lock name |
| lockAlias | String | Lock alias |
| lockMac | String | Lock MAC |
| noKeyPwd | String | Super passcode, which only belongs to the admin ekey, can be entered on the keypad to unlock |
| electricQuantity | Int | Lock battery |
| featureValue | String | characteristic value. it is used to indicate what kinds of feature do a lock support. |
| timezoneRawOffset | Long | The offset between your time zone and UTC, in millisecond |
| modelNum | String | Product model (for firmware update) |
| hardwareRevision | String | Hardware version (for firmware update) |
| firmwareRevision | String | Firmware version (for firmware update) |
| autoLockTime | Int | Auto lock time (in seconds), -1 for disable auto lock |
| lockSound | Int | Lock sound: 0-unknow、1-on, 2-off |
| soundVolume | Int | Sound Volume:1-5 |
| hasGateway | Int | Connected to a gateway:0-false、1-true |
| privacyLock | Int | Privacy lock:0-unknow、1-on, 2-off |
| tamperAlert | Int | Tamper alert:0-unknow、1-on, 2-off |
| resetButton | Int | Reset button:0-unknow、1-on, 2-off |
| openDirection | Int | Open direction:0-unknow、1-left open、2-right open |
| passageMode | Int | Passage mode:1-enable、2-disable |
| passageModeAutoUnlock | Int | Passagemode auto unlock:1-on, 2-off, set to 1 then the lock will auto unlock at the time the passage mode start |
| date | Long | Lock init time (timestamp in millisecond) |
{
"date": 1749195089000,
"lockAlias": "S202F_55ce63",
"lockSound": 1,
"modelNum": "SN284-FINGER-T0_PV53",
"lockMac": "ED:AE:90:63:CE:55",
"privacyLock": 2,
"featureValue": "344CD5F7",
"soundVolume": 5,
"hasGateway": 0,
"autoLockTime": 5,
"lockName": "S202F_55ce63",
"resetButton": 1,
"firmwareRevision": "5.1.0.200705",
"tamperAlert": 1,
"noKeyPwd": "7780189",
"passageMode": 2,
"passageModeAutoUnlock": 2,
"timezoneRawOffset": 28800000,
"lockId": 3466251,
"electricQuantity": 100,
"hardwareRevision": "1.1"}