Open Platform
Skip to content

Query the list of DS3 ​

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

1 Request example ​

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

javascript
curl --location -g --request POST 'https://euapi.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 Request parameters ​

NameTypeRequiredDescription
clientIdStringYclient_id from Create application
accessTokenStringYAccess token,refer to: Get access token
pageNoIntYPage numbers start from 1
pageSizeIntYNumber of pages per page, maximum 200
searchStrStringNSearch door sensor name
dateLongYCurrent time (timestamp, in milliseconds)

3 Response and example ​

ParameterTypeDescription
listJSONObjectlist

objects in the list

ParameterTypeDescription
macStringMAC
featureValueStringFeature value
statusDelayFlagInt1: Device status has not been updated for a long time; 0: No
electricQuantityIntBattery level
doorSensorStateIntDoor sensor status: 0 - Closed, 1 - Open, 2 - Unknown
wifiNameStringWIFI name
doorSensorNumberStringDoor sensor number
doorSensorIdIntDoor sensor ID
nameStringName
recordUpdateDateLongRecord update time
wifiMacStringWIFI MAC address
userTypeStringUser type: ADMIN: Administrator, USER: User being shared with.
firmwareRevisionStringFirmware version
{
    "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": "door sensor",
            "recordUpdateDate": 1763459321000,
            "wifiMac": "2F:5D:12:64:1F:8C",
            "userType": "ADMIN",
            "firmwareRevision": "1.0.06.251112"
        }
    ]
}

3.1 Feature value description ​

Similar to the lock's characteristic value, the individual door sensor's characteristic value is also a hexadecimal string, indicating what functions this individual door lock supports.

The function represented by each byte bit (counting from 0) after high-low bit conversion is as follows:

Bitexplanation
0support 2.4G WiFi
CopyRight © 2012-2026 TTLock.All Rights Reserved