Skip to content

获取锁连接的网关列表 ​

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

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

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

当用户对锁发起远程操作时,云端系统会从所有锁连接的网关中选择连接信号强度最好的网关下发指令。

1 HTTP请求方法及示例 ​

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

2 参数说明 ​

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

3 返回参数及示例 ​

参数类型描述
listJSONArray记录列表

列表中的对象:

参数类型描述
gatewayIdInt网关ID
gatewayMacString网关mac地址
gatewayNameString网关名称
rssiInt网关与锁之间信号强度,参考标准:大于-75为强,大于-85小于-75为中,小于-85为弱。
rssiUpdateDateLongRSSI信号强度更新时间(时间戳,单位毫秒)
{
    "list": [
        {
            "gatewayId": 78979,
            "gatewayMac": "C5:40:E0:9C:8C:C1",
            "gatewayName": "民宿1-101-网关",
            "rssi": -65,
            "rssiUpdateDate": 1626674053000
        }
    ]
}