Skip to content

获取网关连接的锁列表 ​

https://euapi.ttlock.com/v3/gateway/listLock

网关会自动搜索附近属于同一管理员的锁,并上报云端建立连接关系,该接口返回所有和网关连接的锁。

连接关系会缓存30分钟(后续有可能会调整),即只要30分钟内网关有搜索到锁上报云端(rssi updateDate对应的时间在30分钟内),云端就判定网关和锁是有连接的,所以网关下电30分钟后,该接口才不会返回相应锁。

1 HTTP请求方法及示例 ​

javascript
curl --location --request GET 'https://euapi.ttlock.com/v3/gateway/listLock?clientId=4773aa036f7f49c68d876bb4be85c80c&accessToken=dfd5489d0cee31f0bdfaf59d0d42d71f&gatewayId=78979&date=1626674054000'

2 参数说明 ​

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

3 返回参数及示例 ​

参数类型描述
listJSONArray记录列表

列表中的对象:

参数类型描述
lockIdInt锁ID
lockMacString锁mac地址
lockNameString锁的蓝牙名称
lockAliasString锁别名
rssiInt网关与锁之间信号强度,参考标准:大于-75为强,大于-85小于-75为中,小于-85为弱。
updateDateLongRSSI信号强度更新时间
{
    "list": [
        {
            "lockId": 532323,
            "lockName":"YS1003_c18c9c",
            "lockAlias":"大门锁",
            "lockMac": "C5:40:E0:9C:8C:C1",
            "rssi":-65,
            "updateDate": 1626674053000
        }
    ]
}