Skip to content

获取网关连接的设备列表 ​

https://cnapi.ttlock.com/v3/gateway/listDevice

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

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

设备包括 锁、电表、水表

1 HTTP请求方法及示例 ​

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

2 参数说明 ​

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

3 返回参数及示例 ​

参数类型描述
listJSONArray记录列表

列表中的对象:

参数类型描述
deviceTypeInt设备类型 0 :锁 。1:电表。2:水表。
deviceIdInt设备ID
deviceMacString设备mac地址
deviceNameString设备的蓝牙名称
deviceAliasString设备别名
rssiInt网关与设备之间信号强度,参考标准:大于-75为强,大于-85小于-75为中,小于-85为弱。
updateDateLongRSSI信号强度更新时间
{
    "list": [
        {
            "deviceType": 0,
            "deviceId": 532323,
            "deviceName":"YS1003_c18c9c",
            "deviceAlias":"大门锁",
            "deviceMac": "C5:40:E0:9C:8C:C1",
            "rssi":-65,
            "updateDate": 1626674053000
        }
    ]
}