Open Platform
Skip to content

Configure alert ​

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

After saving the reminder configuration by calling this interface, you need to open and close the door sensor again for the configuration to take effect.

1 Request example ​

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

javascript
curl --location -g --request POST 'https://cnapi.ttlock.com/v3/standaloneDoorSensor/configAlertFlag' \
--data-urlencode 'clientId=4773aa036f7f49c68d876bb4be85c80c' \
--data-urlencode 'accessToken=dfd5489d0cee31f0bdfaf59d0d42d71f' \
--data-urlencode 'doorSensorId=100123' \
--data-urlencode 'notCloseAlertFlag=1' \
--data-urlencode 'notCloseAlertSecondNum=100' \
--data-urlencode 'longTimeNotOpenAlertFlag=1' \
--data-urlencode 'longTimeNotOpenDayNum=10' \
--data-urlencode 'date=1625025703000'

2 Request parameters ​

NameTypeRequiredDescription
clientIdStringYClient_id from Create application
accessTokenStringYAccess token,refer to: Get access token
doorSensorIdIntYDoor sensor ID
notCloseAlertFlagIntYDoor not closed reminder indicator: Value range 1 - Open, 2 - Closed
notCloseAlertSecondNumIntNDoor not closed reminder time, unit: seconds, range: 1~900 seconds.
longTimeNotOpenAlertFlagIntYLong-term inactivity reminder indicator: Value range 1 - On, 2 - Off
longTimeNotOpenDayNumIntNLong-term door inactivity reminder time, unit: days, range: 1-15 days.
dateLongYCurrent time (timestamp, in milliseconds)

3 Response and example ​

ParameterTypeDescription
errcodeIntError code
errmsgStringError message
errmsgStringError information
{
    "errcode": 0, 
    "errmsg": "none error message",
    "description":"表示成功或是"
}
CopyRight © 2012-2026 TTLock.All Rights Reserved