Skip to content

查询独立门磁列表 ​

https://cnapi.ttlock.com/v3/standaloneDoorSensor/list

1 HTTP请求方法及示例 ​

POST, ContentType:application/x-www-form-urlencoded

javascript
curl --location -g --request POST 'https://cnapi.ttlock.com/v3/standaloneDoorSensor/list' \
--data-urlencode 'clientId=4773aa036f7f49c68d876bb4be85c80c' \
--data-urlencode 'accessToken=dfd5489d0cee31f0bdfaf59d0d42d71f' \
--data-urlencode 'pageNo=1' \
--data-urlencode 'pageSize=20' \
--data-urlencode 'date=1625025703000'

2 参数说明 ​

名称类型是否必需描述
clientIdStringY创建应用分配的client_id
accessTokenStringY访问令牌,通过获取访问令牌接口获取
pageNoIntY页码,从1开始
pageSizeIntY每页数量,最大200
searchStrStringN搜索门磁名称
dateLongY当前时间(时间戳,单位毫秒)

3 返回参数及示例 ​

参数类型描述
listJSONObject列表

列表中的对象

参数类型描述
macStringmac
featureValueString特征值
statusDelayFlagInt1:设备状态长期未更新,0:否
electricQuantityInt电量
doorSensorStateInt门磁状态,0:-闭合,1-打开 2:未知
wifiNameStringWIFI 名称
doorSensorNumberString门磁编号
doorSensorIdInt门磁ID
nameString名称
recordUpdateDateLong记录更新时间
wifiMacStringWIFI MAC地址
userTypeString用户类型,ADMIN:管理员,USER:被分享的用户
firmwareRevisionString固件版本
{
    "list": [
        {
            "mac": "8C:1F:64:12:5D:2E",
            "featureValue": "00000001",
            "statusDelayFlag": 0,
            "electricQuantity": 100,
            "doorSensorState": 1,
            "wifiName": "@Ruijie-sAFEF",
            "doorSensorNumber": "DS3_2e5d12",
            "doorSensorId": 67,
            "name": "门磁",
            "recordUpdateDate": 1763459321000,
            "wifiMac": "2F:5D:12:64:1F:8C",
            "userType": "ADMIN",
            "firmwareRevision": "1.0.06.251112"
        }
    ]
}

3.1 特征值说明 ​

与锁特征值类似,独立门磁特征值也是一个16进制的字符串,说明这个独立门锁支持什么功能

高低位转换后每个字节位(从0开始计算)表示的功能说明: ​
位说明
0支持2.4G WiFi