导出锁操作记录
https://cnapi.sciener.com/v3/lockRecord/listForExport
获取全量的锁操作记录,用于导出。
云端只保存最近半年的记录,因此只允许导出最近半年的记录。
由于是不分页,全量获取,在记录很多时接口会很重,因此该接口有访问频次限制:接口限制一个用户一分钟最多调用5次,一天100次;一个应用一天最多调用500次,超过调用频次限制,会返回错误码:30006。
1 HTTP请求方法及示例
javascript
x
curl --location --request GET 'https://cnapi.sciener.com/v3/lockRecord/listForExport?clientId=4773aa036f7f49c68d876bb4be85c80c&accessToken=dfd5489d0cee31f0bdfaf59d0d42d71f&lockId=163377&startDate=1526674054000&endDate=1626674054000&date=1626674054000'2 参数说明
| 名称 | 类型 | 是否必需 | 描述 |
|---|---|---|---|
| clientId | String | Y | 创建应用分配的client_id |
| accessToken | String | Y | 访问令牌,通过获取访问令牌接口获取 |
| lockId | Int | Y | 锁ID,由锁初始化接口生成 |
| startDate | Long | N | 开始时间(时间戳,单位毫秒) |
| endDate | Long | N | 结束时间(时间戳,单位毫秒) |
| date | Long | Y | 当前时间(时间戳,单位毫秒) |
3 返回参数及示例
| 参数 | 类型 | 描述 |
|---|---|---|
| list | JSONArray | 记录列表 |
列表中的对象:
| 参数 | 类型 | 描述 |
|---|---|---|
| lockId | Int | 锁ID |
| recordTypeFromLock | Int | 锁记录类型,请参考锁里的记录类型 |
| recordType | Int | 记录类型,请参考云端锁记录类型 |
| success | Int | 是否成功:0-否,1-是 |
| username | String | 操作人用户名: APP蓝牙开关锁记录为开锁钥匙名称(没取名的,返回用户昵称) 密码记录为密码名称 IC卡记录为IC卡名称 指纹记录为指纹名称 |
| keyboardPwd | String | 密码、IC卡号或指纹号 |
| date | Long | 操作时锁上的时间(时间戳,单位毫秒) |
{
"list": [
{
"lockId": 163377,
"recordTypeFromLock": 1,
"recordType": 1,
"success":1,
"username": "alex@google.com",
"date": 1616674054000},
{
"lockId": 163377,
"recordTypeFromLock": 4,
"recordType": 4,
"success":1,
"username": "小明",
"keyboardPwd": "383834",
"date": 1616675054000}
]
}