获取名下钥匙列表

https://api.sciener.com/v3/key/list

分页获取用户的所有电子钥匙，包括最高管理员钥匙及其他用户发送给当前用户的普通用户电子钥匙。

1 HTTP请求方法及示例

POST, ContentType:application/x-www-form-urlencoded


xxxxxxxxxx
curl --location -g --request POST 'https://api.sciener.com/v3/key/list' \
--data-urlencode 'clientId=4773aa036f7f49c68d876bb4be85c80c' \
--data-urlencode 'accessToken=dfd5489d0cee31f0bdfaf59d0d42d71f' \
--data-urlencode 'lockAlias=大门' \
--data-urlencode 'groupId=7619' \
--data-urlencode 'pageNo=1' \
--data-urlencode 'pageSize=20' \
--data-urlencode 'date=1625025703000'

2 参数说明

名称	类型	是否必需	描述
clientId	String	Y	创建应用分配的client_id
accessToken	String	Y	访问令牌，通过获取访问令牌接口获取
lockAlias	String	N	锁别名模糊匹配
groupId	Int	N	分组ID，获取某个分组下的钥匙，来源于添加分组接口
pageNo	Int	Y	页码，从1开始
pageSize	Int	Y	每页数量，最大1000
date	Long	Y	当前时间（时间戳，单位毫秒）

3 返回参数及示例

参数	类型	描述
list	JSONArray	记录列表
pageNo	Int	页码，从1开始
pageSize	Int	每页数量,最大1000
pages	Int	总页数
total	Int	总条数

列表中的对象

参数	类型	描述
keyId	Int	钥匙ID
lockData	String	锁数据，用于操作锁
lockId	Int	锁ID，由锁初始化接口生成
userType	String	钥匙用户类型：110301-管理员钥匙，110302-普通用户钥匙。
keyStatus	String	钥匙状态
lockName	String	锁的蓝牙名称
lockAlias	String	锁别名
lockMac	String	锁mac地址
noKeyPwd	String	管理员钥匙会有，管理员开锁密码
electricQuantity	Int	锁电量
startDate	Long	有效期开始时间（时间戳，单位毫秒）
endDate	Long	有效期结束时间（时间戳，单位毫秒）
remarks	String	备注，留言
keyRight	Int	钥匙是否被授权：0-否，1-是
featureValue	String	锁特征值，用于表示锁支持的功能
remoteEnable	Int	是否支持远程开锁：1-是、2-否
passageMode	Int	常开模式：1-开启、2-关闭
timezoneRawOffset	Long	锁所在时区和UTC时区时间的差数，单位毫秒
groupId	Int	分组ID
groupName	String	分组名称


xxxxxxxxxx
{
    "list": [
        {
            "keyId": 3234293,
            "lockData": "xxxxxxx",
            "lockId": 532323,
            "userType": "110302",
            "keyStatus": "110401",
            "lockName": "M102_ed8e8d",
            "lockAlias": "大门锁",
            "lockMac": "68:9E:19:00:67:81",
            "noKeyPwd": "345634",
            "electricQuantity": 85,
            "startDate": 1528878944000,
            "endDate": 1628878944000,
            "remarks": "水费月底待交",
            "keyRight": 1,
            "featureValue": "6C4CD1F3",
            "remoteEnable": 0,
            "passageMode": 1,
            "groupId": 7619,
            "groupName": "家园4栋"
        }
    ],
    "pageNo":1,
    "pageSize":20,
    "pages":1,
    "total":1
}