获取锁连接的网关列表
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 参数说明
| 名称 | 类型 | 是否必需 | 描述 |
|---|---|---|---|
| clientId | String | Y | 创建应用分配的client_id |
| accessToken | String | Y | 访问令牌,通过获取访问令牌接口获取 |
| lockId | Int | Y | 锁ID,由锁初始化接口生成 |
| date | Long | Y | 当前时间(时间戳,单位毫秒) |
3 返回参数及示例
| 参数 | 类型 | 描述 |
|---|---|---|
| list | JSONArray | 记录列表 |
列表中的对象:
| 参数 | 类型 | 描述 |
|---|---|---|
| gatewayId | Int | 网关ID |
| gatewayMac | String | 网关mac地址 |
| gatewayName | String | 网关名称 |
| rssi | Int | 网关与锁之间信号强度,参考标准:大于-75为强,大于-85小于-75为中,小于-85为弱。 |
| rssiUpdateDate | Long | RSSI信号强度更新时间(时间戳,单位毫秒) |
{
"list": [
{
"gatewayId": 78979,
"gatewayMac": "C5:40:E0:9C:8C:C1",
"gatewayName": "民宿1-101-网关",
"rssi": -65,
"rssiUpdateDate": 1626674053000
}
]
}