Skip to content

获取锁详细信息 ​

https://euapi.ttlock.com/v3/lock/detail

  • 只有管理员才能获取锁的详细信息。注意:如果锁不支持该功能,或从未配置过相关功能,配置信息可能不会出现在该列表当中

  • 要获取一把锁的lockData锁数据,请调用获取单把钥匙接口。

1 HTTP请求方法及示例 ​

javascript
curl --location -g --request GET 'https://euapi.ttlock.com/v3/lock/detail?clientId=fd2ff35ee3d8424c8665c07b7b9a7f45&accessToken=780f7671b6e6be3010d9787f19207aca&lockId=10&date=1625025703000'

2 参数说明 ​

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

3 返回参数及示例 ​

只有管理员才能获取锁的详细信息。注意:如果锁不支持该功能,或从未配置过相关功能,配置信息可能不会出现在该列表当中。

参数类型描述
lockIdInt锁ID
lockNameString锁的蓝牙名称
lockAliasString锁别名
lockMacString锁mac地址
noKeyPwdString管理员钥匙会有,管理员键盘密码,管理员用该密码开门
electricQuantityInt锁电量
featureValueString锁特征值,用于表示锁支持的功能
timezoneRawOffsetLong锁所在时区和UTC时区时间的差数,单位毫秒
modelNumString产品型号(用于固件升级)
hardwareRevisionString硬件版本号(用于固件升级)
firmwareRevisionString固件版本号(用于固件升级)
autoLockTimeInt自动闭锁时间(单位秒),-1代表关闭自动闭锁
lockSoundInt锁声音开关:0-未知、1-开启、2-关闭
soundVolumeInt锁声音大小:1-5
hasGatewayInt是否连接网关:0-无、1-有
privacyLockInt反锁开关:0-未知、1-开启、2-关闭
tamperAlertInt防撬开关:0-未知、1-开启、2-关闭
resetButtonInt重置按键开关:0-未知、1-开启、2-关闭
openDirectionInt开门方向:0-未知、1-左开、2-右开
passageModeInt常开模式:1-开启、2-关闭
passageModeAutoUnlockInt常开模式自动开锁开关:1-开启、2-关闭
dateLong锁初始化时间(时间戳,单位毫秒)
{
    "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"}