Skip to content

获取锁的密码列表 ​

https://euapi.ttlock.com/v3/lock/listKeyboardPwd

管理员或授权管理员查看这把锁上生成的所有密码,包含随机密码和自定义密码。

1 HTTP请求方法及示例 ​

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

2 参数说明 ​

名称类型是否必需描述
clientIdStringY创建应用分配的client_id
accessTokenStringY访问令牌,通过获取访问令牌接口获取
lockIdIntY锁ID,由锁初始化接口生成
searchStrStringN搜索关键词,通过密码名称模糊搜索或通过密码精准匹配
pageNoIntY页码,从1开始
pageSizeIntY每页数量,最大200
orderByIntY排序方式:0-按名称正序、1-按生成时间倒序、2-按名称倒序
dateLongY当前时间(时间戳,单位毫秒)

3 返回参数及示例 ​

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

列表中的对象

参数类型描述
keyboardPwdIdInt键盘密码ID
lockIdInt锁ID,由锁初始化接口生成
keyboardPwdString键盘密码
keyboardPwdNameString键盘密码名称
keyboardPwdTypeInt键盘密码类型
startDateLong有效期开始时间(时间戳,单位毫秒)
endDateLong有效期结束时间(时间戳,单位毫秒)
sendDateLong发送时间(时间戳,单位毫秒)
isCustomInt是否自定义密码: 1-是, 0-否
senderUsernameString发送者用户名
{
    "list": [
        {
            "keyboardPwdId": 3234293,
            "lockId": 532323,
            "keyboardPwd": "034234",
            "keyboardPwdName":"陈文亮",
            "keyboardPwdType": "3",
            "startDate": 1528878944000,
            "endDate": 1628878944000,
            "sendDate": 1528878944000,
            "senderUsername": "alexa@google.com"
        }
    ],
    "pageNo":1,
    "pageSize":20,
    "pages":1,
    "total":1
}