获取名下锁列表

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

通过该接口获取用户在科技侠APP里添加的锁，或是对接APP SDK通过云端初始化锁接口初始化的锁。

科技侠APP添加的锁，请用添加锁时的科技侠APP的账号和密码获取访问令牌后调用该接口。
云端初始化锁接口初始化的锁，请使用初始化锁时相同用户的访问令牌。

注意！该接口只返回最高管理员的锁（即锁是该账户添加），授权的锁不会在返回列表中；对于普通用户和授权管理员，请通过获取名下钥匙列表接口获取。

如果对接通通酒店，该接口也可以获取取电开关或者梯控列表，只需新增参数type，type = 1 为锁列表，type = 2 为梯控列表， type = 3 为取电开关列表。

1 HTTP请求方法及示例

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


1
curl --location -g --request GET 'https://api.sciener.com/v3/lock/list?clientId=fd2ff35ee3d8424c8665c07b7b9a7f45&accessToken=780f7671b6e6be3010d9787f19207aca&pageNo=1&pageSize=20&date=1625025703000&groupId=1719'

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	总条数

列表中的对象

参数	类型	描述
lockId	Int	锁ID，由锁初始化接口生成
lockName	String	锁的蓝牙名称
lockAlias	String	锁别名
lockMac	String	锁mac地址
electricQuantity	Int	锁电量
featureValue	String	锁特征值，用于表示锁支持的功能
hasGateway	Int	是否有连接网关，1-是、0-否
lockData	String	锁数据，用于操作锁
groupId	Int	分组ID
groupName	String	分组名称
date	Long	锁初始化时间


xxxxxxxxxx
21
1
{
2
    "list": [
3
        {
4
            "lockId": 532323,
5
            "lockName":"YS1003_c18c9c",
6
            "lockAlias":"大门锁",
7
            "lockMac": "C5:40:E0:9C:8C:C1",
8
            "electricQuantity": 55,
9
            "featureValue":"3F0421C4F5F3",
10
            "hasGateway": 1,
11
            "lockData": "xxxxxxxxxxxxx",
12
            "groupId": 456,
13
            "groupName": "4栋2楼",
14
            "date": 1528878944000,
15
        }
16
    ],
17
    "pageNo":1,
18
    "pageSize":20,
19
    "pages":1,
20
    "total":1
21
}