Skip to content

设置常开模式 ​

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

在设置的常开时间段内,锁被打开后将一直处于打开的状态,直到被手动关闭。

1 HTTP请求方法及示例 ​

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

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

2 参数说明 ​

名称类型是否必需描述
clientIdStringY创建应用分配的client_id
accessTokenStringY访问令牌,通过获取访问令牌接口获取
lockIdIntY锁ID,由锁初始化接口生成
passageModeIntY常开模式:1-开启、2-关闭
cyclicConfigStringNJsonArray转成String,可参考上方示例 循环时间设置,最多只能设置五段时间
autoUnlockIntN自动开锁:1-开启、2-关闭,开启后锁将在常开模式开始时自动打开
typeIntY设置方式: 1-通过APP蓝牙,必需先通过APP SDK蓝牙设置常开模式后再调用该接口 2-通过网关或WiFi锁,如果是WiFi锁或有连接网关,传2可通过云端接口直接设置生效, 不传默认1。
dateLongY当前时间(时间戳,单位毫秒)

cyclicConfig中的参数:

参数类型描述
isAllDayInt是否全天常开:1-是、2-否
startTimeInt开始时间,分钟数, 例如 480 代表 8:00
endTimeInt结束时间,分钟数, 例如 1080 代表 18:00
weekDaysJsonArray[Int]循环有效星期:1-7,如[1,2,3]

3 返回参数及示例 ​

参数类型描述
errcodeInt错误码
errmsgString错误信息
descriptionString错误描述
{
    "errcode": 0, 
    "errmsg": "none error message",
    "description":"表示成功或是"
}