Skip to content

获取名下网关列表 ​

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

分页获取用户名下的网关,用户初始化的网关,或转移给该用户的网关都属于该用户。

1 HTTP请求方法及示例 ​

javascript
curl --location --request GET 'https://euapi.ttlock.com/v3/gateway/list?clientId=4773aa036f7f49c68d876bb4be85c80c&accessToken=dfd5489d0cee31f0bdfaf59d0d42d71f&pageNo=1&pageSize=20&date=1626674054000'

2 参数说明 ​

名称类型是否必需描述
clientIdStringY创建应用分配的client_id
accessTokenStringY访问令牌,通过获取访问令牌接口获取
pageNoIntY页码,从1开始
pageSizeIntY每页数量,默认20,最大200
orderByIntY排序方式:0-按名称正序、1-按生成时间倒序、2-按名称倒序
dateLongY当前时间(时间戳,单位毫秒)

3 返回参数及示例 ​

参数类型描述
listJSONArray记录列表
pageNoInt页码,从1开始
pageSizeInt每页数量,最大200
pagesInt总页数
totalInt总条数

列表中的对象

参数类型描述
gatewayIdInt网关ID
gatewayMacString网关mac地址
gatewayNameString网关名称
gatewayVersionInt网关版本号:1-G1,2-G2,3-G3(有线网关),4-G4(4G网关)
networkNameString网关连接的网络名称
networkMacString网关连接的网络Mac地址
lockNumInt网关连接的锁数量,网关会自动搜索附近属于同一管理员的锁,并上报云端建立连接关系,网关30分钟内有搜索到锁并上报给云端,则判断锁和网关有连接。
isOnlineInt是否在线:0-否,1-是。网关和网关服务器保持TCP长连接,云端根据长连接是否存在来判断网关是否在线,拔掉网关并不会导致长连接立即断开,所以网关在线状态会维持几分钟,要等到心跳时间(目前是8分钟)结束,网关服务器才会主动关闭死连接。
{
    "list": [
        {
            "gatewayId": 78979,
            "gatewayMac": "C5:40:E0:9C:8C:C1",
            "gatewayVersion":1,
            "networkName": "民宿1-101-WIFI",
            "lockNum": 2,
            "isOnline": 1
        }
    ],
    "pageNo":1,
    "pageSize":20,
    "pages":1,
    "total":1
}