Open Platform
Skip to content

Configure Working Mode ​

https://euapi.ttlock.com/v3/lock/configWorkingMode

During working hours: The lock can be unlocked using ekeys, passwords, and other methods.

During non-working hours: The lock automatically enters freeze mode, allowing only mechanical keys to be used, and all other unlocking methods are disabled.

Modify the lock's operating hours, including: 1: All-day operation, 2: All-day off, 3: Custom, etc.

You can modify the lock's operating hours via the App SDK and then call this API to synchronize the settings to the cloud, or you can remotely modify the lock's operating hours directly via a gateway or WiFi lock.

The modified settings can be queried using the Get Working Mode API.

1 Request example ​

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

javascript
curl --location -g --request POST 'https://euapi.ttlock.com/v3/lock/configWorkingMode' \
--data-urlencode 'clientId=4773aa036f7f49c68d876bb4be85c80c' \
--data-urlencode 'accessToken=dfd5489d0cee31f0bdfaf59d0d42d71f' \
--data-urlencode 'lockId=3001' \
--data-urlencode 'workingMode=3' \
--data-urlencode 'type=1' \
--data-urlencode 'cyclicConfig=[{"isAllDay":2,"startTime":480,"endTime":1080,"weekDays":[1,2]}]' \
--data-urlencode 'date=1625025703000'

2 Request parameters ​

NameTypeRequiredDescription
clientIdStringYclient_id from Create application
accessTokenStringYAccess token,refer to: Get access token
lockIdIntYLock ID
workingModeStringYWorking status, 1: working all day, 2: not working all day, 3: custom
typeStringYMethod: 1-via phone bluetooth,should call APP SDK method to add card first. 2-via gateway or WiFi lock,you can call this api with type = 2 directly if it's a WiFi lock or it's connected to gateway. The default value is 1.
cyclicConfigStringNTime period configuration
dateLongYCurrent time (timestamp in millisecond)

cyclicConfig:

ParameterTypeDescription
isAllDayIntWhether it is always open all day: 1-Yes, 2-No
startTimeIntStart time in minutes, e.g. 480 means 8:00
endTimeIntEnd time in minutes, e.g. 1080 means 18:00
weekDaysJsonArray[Int]Cycle validity period: 1-7, such as [1,2,3]

3 Response and example ​

ParameterTypeDescription
errcodeIntError code
errmsgStringError message
{
    "errcode": 0, 
    "errmsg": "none error message"}
CopyRight © 2012-2026 TTLock.All Rights Reserved