Skip to content

获取锁名下二维码列表 ​

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

通过该接口查询锁上添加的二维码。

1 HTTP请求方法及示例 ​

javascript
curl --location -g --request GET 'https://euapi.ttlock.com/v3/qrCode/list?clientId=fd2ff35ee3d8424c8665c07b7b9a7f45&accessToken=780f7671b6e6be3010d9787f19207aca&lockId=163377&pageNo=1&pageSize=20&date=1625025703000'

2 参数说明 ​

名称类型是否必需描述
clientIdStringY创建应用分配的client_id
accessTokenStringY访问令牌,通过获取访问令牌接口获取
lockIdIntY锁ID,由锁初始化接口生成
pageNoIntY页码,从1开始
pageSizeIntY每页数量,默认20,最大200
dateLongY当前时间(时间戳,单位毫秒)
nameStringN二维码名称

3 返回参数及示例 ​

参数类型描述
listJSONArray记录列表
pageNoInt页码,从1开始
pageSizeInt每页数量,最大200
pagesInt总页数
totalInt总条数

返回列表中的对象

参数类型描述
qrCodeIdInt二维码ID
lockIdInt锁ID
typeInt二维码类型,1-限时、2-永久、4-循环
qrCodeNumberString二维码号,同一把锁的每个二维码对应一个唯一的二维码号,用于区分开锁日志。
nameString二维码名称,锁管理员给二维码的命名。
startDateLong有效期开始时间
endDateLong有效期结束时间
refreshTimeInt二维码刷新时间,单位为分钟
cyclicConfigJSONArray循环时间设置,目前只支持每天开始时间和结束时间一样的设置,示例: [{"weekDay":1, "startTime":480,"endTime":1080},{"weekDay":2, "startTime":480,"endTime":1080}] 表示周一和周二8:00到18:00有效
createDateLong创建时间
statusInt状态:1-正常、2-已失效、3-待生效
creatorString创建者
linkInt二维码H5页面链接
qrCodeVersionInt二维码版本 1-云端随机二维码 3-自定义二维码

cyclicConfig中的参数:

参数类型描述
startTimeInt开始时间,分钟数, 例如 480 代表 8:00
endTimeInt结束时间,分钟数, 例如 1080 代表 18:00
weekDayInt星期:1-7, 1-星期一...7-星期天.
{
    "list": [
        {
            "qrCodeId": 34242,
            "lockId": 163377,
            "type": 1,
            "qrCodeNumber": 2,
            "name": "给小明的二维码",
            "startDate": 1625025703000,
            "endDate": 1665025703000,
            "status": 1,
            "createDate": 1625025703000,
            "creator": "二房东",
            "link":"https://ttekey.com/q?k=Gc5Wg6Hh"
        }
    ],
    "pageNo":1,
    "pageSize":20,
    "pages":1,
    "total":1
}