Skip to content

更新二维码 ​

https://euapi.ttlock.com/v3/qrCode/update

更新二维码的名称、有效期、循环设置,类型不可更新。

当changeType=0的时候,使用云端的方式修改二维码。 当changeType=1,需要先使用APPsdk 用蓝牙的方式修改二维码。然后调用本接口。 当changeType=2,调用本接口的时候,会直接通过网关到锁里修改二维码。

1 HTTP请求方法及示例 ​

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

javascript
curl --location -g --request POST 'https://euapi.ttlock.com/v3/qrCode/update' \
--data-urlencode 'clientId=4773aa036f7f49c68d876bb4be85c80c' \
--data-urlencode 'accessToken=dfd5489d0cee31f0bdfaf59d0d42d71f' \
--data-urlencode 'qrCodeId=34242' \
--data-urlencode 'startDate=1625025703000' \
--data-urlencode 'endDate=1645025703000' \
--data-urlencode 'date=1625025703000'

2 参数说明 ​

名称类型是否必需描述
clientIdStringY创建应用分配的client_id
accessTokenStringY访问令牌,通过获取访问令牌接口获取
qrCodeIdIntY二维码ID,由添加二维码接口生成
nameStringN二维码名称,锁管理员给二维码的命名。
startDateLongN有效期开始时间(时间戳,单位毫秒)
endDateLongN有效期结束时间(时间戳,单位毫秒)
refreshTimeIntN二维码刷新时间,单位为分钟
cyclicConfigJSONArray StringN循环时间设置,目前只支持每天开始时间和结束时间一样的设置,示例: [{"weekDay":1, "startTime":480,"endTime":1080},{"weekDay":2, "startTime":480,"endTime":1080}] 表示周一和周二8:00到18:00有效
dateLongY当前时间(时间戳,单位毫秒)
typeIntY二维码类型,1-限时、2-永久、4-循环
changeTypeIntY修改方式: 1-通过APP蓝牙修改,必需先通过APP蓝牙修改后再调用该接口 2-通过网关或WiFi锁远程修改,如果是WiFi锁或有连接网关,则可以传2,直接调用该接口从锁里修改 0-云端方式,不填默认0,从云端修改。

cyclicConfig中的参数:

参数类型描述
startTimeInt开始时间,分钟数, 例如 480 代表 8:00
endTimeInt结束时间,分钟数, 例如 1080 代表 18:00
weekDayInt星期:1-7, 1-星期一...7-星期天

3 返回参数及示例 ​

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