获取锁操作记录
https://cnapi.ttlock.com/v3/lockRecord/list
分页获取上传到云端的锁操作记录,可以通过开始和结束时间过滤获取某段时间的记录。
注意:云端只保留半年内的操作记录,半年之前的无法获取。
1 HTTP请求方法及示例
javascript
curl --location --request GET 'https://cnapi.ttlock.com/v3/lockRecord/list?clientId=4773aa036f7f49c68d876bb4be85c80c&accessToken=dfd5489d0cee31f0bdfaf59d0d42d71f&lockId=163377&startDate=1526674054000&endDate=1626674054000&pageNo=1&pageSize=20&date=1626674054000'2 参数说明
| 名称 | 类型 | 是否必需 | 描述 |
|---|---|---|---|
| clientId | String | Y | 创建应用分配的client_id |
| accessToken | String | Y | 访问令牌,通过获取访问令牌接口获取 |
| lockId | Int | Y | 锁ID,由锁初始化接口生成 |
| startDate | Long | N | 开始时间(时间戳,单位毫秒) |
| endDate | Long | N | 结束时间(时间戳,单位毫秒) |
| pageNo | Int | Y | 页码,从1开始 |
| pageSize | Int | Y | 每页数量,默认20,最大200 |
| uid | Int | N | 用户ID,用于搜索某个用户的操作记录 |
| recordType | Int | N | 记录类型:-5-人脸、-4-二维码、4-键盘密码开锁、7-IC卡开锁、8-指纹开锁、55-遥控,不传默认返回所有记录 |
| searchStr | String | N | 搜索字符串:人脸号、二维码号、密码、IC卡号、指纹号、遥控Mac |
| date | Long | Y | 当前时间(时间戳,单位毫秒) |
3 返回参数及示例
| 参数 | 类型 | 描述 |
|---|---|---|
| list | JSONArray | 记录列表 |
| pageNo | Int | 页码,从1开始 |
| pageSize | Int | 每页数量,最大200 |
| pages | Int | 总页数 |
| total | Int | 总条数 |
列表中的对象
| 参数 | 类型 | 描述 |
|---|---|---|
| recordId | Long | 记录ID |
| lockId | Int | 锁ID |
| recordTypeFromLock | Int | 锁记录类型,请参考锁里的记录类型 |
| recordType | Int | 记录类型,请参考云端锁记录类型 |
| success | Int | 是否成功:0-否,1-是 |
| username | String | 操作人用户名: APP蓝牙开关锁记录为开锁用户账号 密码记录为密码名称 IC卡记录为IC卡名称 指纹记录为指纹名称 |
| keyboardPwd | String | 密码、IC卡号或指纹号 |
| lockDate | Long | 操作时锁上的时间(时间戳,单位毫秒) |
| serverDate | Long | 记录上传到服务器的时间(时间戳,单位毫秒) |
| subRecordType | Long | 当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
}