Skip to content

获取名下酒店锁列表 ​

https://cnapi.sciener.com/v3/lock/listByHotel

通过该接口获取用户在通通酒店APP里添加的锁,或是对接APP SDK通过云端初始化锁接口初始化的锁。

通通酒店APP添加的锁,在通通酒店客户端对接界面导出的账号和密码获取访问令牌后调用该接口。

云端初始化锁接口初始化的锁,请使用初始化锁时相同用户的访问令牌。

1 HTTP请求方法及示例 ​

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

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

2 参数说明 ​

名称类型是否必需描述
clientIdStringY通通酒店申请对接获取的client_id
accessTokenStringY访问令牌,通过获取访问令牌接口获取
typeIntN锁类型,1-酒店锁 2-梯控 3-取电,不传默认为1
lockAliasStringN锁别名模糊匹配
groupIdIntN分组ID,获取某个分组下的锁,来源于添加分组接口
pageNoIntY页码,从1开始
pageSizeIntY每页数量,最大1000
dateLongY当前时间(时间戳,单位毫秒)

3 返回参数及示例 ​

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

列表中的对象

参数类型描述
lockIdInt锁ID,由锁初始化接口生成
lockNameString锁的蓝牙名称
lockAliasString锁别名
lockMacString锁mac地址
electricQuantityInt锁电量
featureValueString锁特征值,用于表示锁支持的功能
hasGatewayInt是否有连接网关,1-是、0-否
lockDataString锁数据,用于操作锁
sectorString锁扇区
electricQuantityUpdateDateLong电量更新时间
buildingNameString楼栋名称
buildingNumberInt楼栋号buildNo,用于写卡
floorNameString楼层名称
floorNumberInt楼层号floorNo,用于写卡
groupIdInt分组ID
groupNameString分组名称
dateLong锁初始化时间
{
    "list": [
        {
            "lockId": 532323,
            "lockName":"YS1003_c18c9c",
            "lockAlias":"大门锁",
            "lockMac": "C5:40:E0:9C:8C:C1",
            "electricQuantity": 55,
            "featureValue":"3F0421C4F5F3",
            "hasGateway": 1,
            "lockData": "xxxxxxxxxxxxx",
            "sector": "1,2,3,4,5,6,7,8,9,10",
            "buildNumber": 1,
            "floorNumber": 1,
            "groupId": 456,
            "groupName": "4栋2楼",
            "date": 1528878944000}
    ],
    "pageNo":1,
    "pageSize":20,
    "pages":1,
    "total":1
}