Skip to content

获取单把钥匙 ​

https://cnapi.sciener.com/v3/key/get

获取用户某把锁的电子钥匙。

1 HTTP请求方法及示例 ​

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

2 参数说明 ​

名称类型是否必需描述
clientIdStringY创建应用分配的client_id
accessTokenStringY访问令牌,通过获取访问令牌接口获取
lockIdIntY锁ID,由锁初始化接口生成
dateLongY当前时间(时间戳,单位毫秒)

3 返回参数及示例 ​

参数类型描述
keyIdInt钥匙ID
lockDataString锁数据,用于操作锁
lockIdInt锁ID
userTypeString钥匙用户类型:110301-管理员钥匙,110302-普通用户钥匙。
keyStatusString钥匙状态
lockNameString锁的蓝牙名称
lockAliasString锁别名
lockMacString锁mac地址
noKeyPwdString管理员钥匙会有,管理员开锁密码
electricQuantityInt锁电量
startDateLong有效期开始时间(时间戳,单位毫秒)
endDateLong有效期结束时间(时间戳,单位毫秒)
remarksString备注,留言
keyRightInt钥匙是否被授权:0-否,1-是
featureValueString锁特征值,用于表示锁支持的功能
remoteEnableInt是否支持远程开锁:1-是、2-否
passageModeInt常开模式:1-开启、2-关闭
timezoneRawOffsetLong锁所在时区和UTC时区时间的差数,单位毫秒
groupIdInt分组ID
groupNameString分组名称
{
    "keyId": 3234293,
    "lockData": "xxxxxxx",
    "lockId": 532323,
    "userType": "110302",
    "keyStatus": "110401",
    "lockName": "M102_ed8e8d",
    "lockAlias": "大门锁",
    "lockMac": "68:9E:19:00:67:81",
    "noKeyPwd": "345634",
    "electricQuantity": 85,
    "startDate": 1528878944000,
    "endDate": 1628878944000,
    "remarks": "水费月底待交",
    "keyRight": 1,
    "featureValue": "6C4CD1F3",
    "remoteEnable": 0,
    "passageMode": 1,
    "groupId": 7619,
    "groupName": "家园4栋"
}