Skip to content

获取锁操作记录 ​

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

分页获取上传到云端的锁操作记录,可以通过开始和结束时间过滤获取某段时间的记录。

注意:云端只保留半年内的操作记录,半年之前的无法获取。

1 HTTP请求方法及示例 ​

javascript
curl --location --request GET 'https://euapi.ttlock.com/v3/lockRecord/list?clientId=4773aa036f7f49c68d876bb4be85c80c&accessToken=dfd5489d0cee31f0bdfaf59d0d42d71f&lockId=163377&startDate=1526674054000&endDate=1626674054000&pageNo=1&pageSize=20&date=1626674054000'

2 参数说明 ​

名称类型是否必需描述
clientIdStringY创建应用分配的client_id
accessTokenStringY访问令牌,通过获取访问令牌接口获取
lockIdIntY锁ID,由锁初始化接口生成
startDateLongN开始时间(时间戳,单位毫秒)
endDateLongN结束时间(时间戳,单位毫秒)
pageNoIntY页码,从1开始
pageSizeIntY每页数量,默认20,最大200
uidIntN用户ID,用于搜索某个用户的操作记录
recordTypeIntN记录类型:-5-人脸、-4-二维码、4-键盘密码开锁、7-IC卡开锁、8-指纹开锁、55-遥控,不传默认返回所有记录
searchStrStringN搜索字符串:人脸号、二维码号、密码、IC卡号、指纹号、遥控Mac
dateLongY当前时间(时间戳,单位毫秒)

3 返回参数及示例 ​

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

列表中的对象

参数类型描述
recordIdLong记录ID
lockIdInt锁ID
recordTypeFromLockInt锁记录类型,请参考锁里的记录类型
recordTypeInt记录类型,请参考云端锁记录类型
successInt是否成功:0-否,1-是
usernameString操作人用户名: APP蓝牙开关锁记录为开锁用户账号 密码记录为密码名称 IC卡记录为IC卡名称 指纹记录为指纹名称
keyboardPwdString密码、IC卡号或指纹号
lockDateLong操作时锁上的时间(时间戳,单位毫秒)
serverDateLong记录上传到服务器的时间(时间戳,单位毫秒)
subRecordTypeLong当recordType=123,网络异常的时候: 1-芯片异常复位 2-数据发送失败 3-WiFi 意外断开 4-IP 地址丢失或冲突 5-网关不可达(请检查路由器) 6-运营商网络超时 7-WiFi 密码错误 8-服务器断开连接 9-服务器拒绝连接 10-网络心跳超时 11-防火墙重置
{
    "list": [
        {
            "recordId": 1635556821,
            "lockId": 163377,
            "recordTypeFromLock": 1,
            "recordType": 1,
            "success":1,
            "username": "alex@google.com",
            "lockDate": 1616674054000,
            "serverDate": 1616674056000
        },
        {
            "recordId": 1635539709,
            "lockId": 163377,
            "recordTypeFromLock": 4,
            "recordType": 4,
            "success":1,
            "username": "小明",
            "keyboardPwd": "383834",
            "lockDate": 1616675054000,
            "serverDate": 1616676056000
        }
    ],
    "pageNo":1,
    "pageSize":20,
    "pages":1,
    "total":2
}