获取网关连接的设备列表
https://euapi.ttlock.com/v3/gateway/listDevice
网关会自动搜索附近属于同一管理员的设备,并上报云端建立连接关系,该接口返回所有和网关连接的设备。
连接关系会缓存30分钟(后续有可能会调整),即只要30分钟内网关有搜索到设备上报云端(rssi updateDate对应的时间在30分钟内),云端就判定网关和设备是有连接的,所以网关下电30分钟后,该接口才不会返回相应设备。
设备包括 锁、电表、水表
1 HTTP请求方法及示例
javascript
curl --location --request GET 'https://euapi.ttlock.com/v3/gateway/listDevice?clientId=4773aa036f7f49c68d876bb4be85c80c&accessToken=dfd5489d0cee31f0bdfaf59d0d42d71f&gatewayId=78979&date=1626674054000'2 参数说明
| 名称 | 类型 | 是否必需 | 描述 |
|---|---|---|---|
| clientId | String | Y | 创建应用分配的client_id |
| accessToken | String | Y | 访问令牌,通过获取访问令牌接口获取 |
| gatewayId | Int | Y | 网关ID |
| date | Long | Y | 当前时间(时间戳,单位毫秒) |
3 返回参数及示例
| 参数 | 类型 | 描述 |
|---|---|---|
| list | JSONArray | 记录列表 |
列表中的对象:
| 参数 | 类型 | 描述 |
|---|---|---|
| deviceType | Int | 设备类型 0 :锁 。1:电表。2:水表。 |
| deviceId | Int | 设备ID |
| deviceMac | String | 设备mac地址 |
| deviceName | String | 设备的蓝牙名称 |
| deviceAlias | String | 设备别名 |
| rssi | Int | 网关与设备之间信号强度,参考标准:大于-75为强,大于-85小于-75为中,小于-85为弱。 |
| updateDate | Long | RSSI信号强度更新时间 |
{
"list": [
{
"deviceType": 0,
"deviceId": 532323,
"deviceName":"YS1003_c18c9c",
"deviceAlias":"大门锁",
"deviceMac": "C5:40:E0:9C:8C:C1",
"rssi":-65,
"updateDate": 1626674053000
}
]
}