接口列表

本节包含指纹门锁相关接口，这些接口只支持萤石联网指纹门锁，购买门锁。

接口列表如下:

启动指纹锁验证

• 接口功能

  该接口用于启动指纹锁的本地验证,指纹锁设备直接调用添加设备接口会返回错误.调用该接口启用本地验证(本地验证需要操作设备), 再轮询调用添加设备接口来关联指纹锁,这个流程需要在120S内完成。

• 请求地址

  https://open.ys7.com/api/lapp/keylock/local/verify

• 请求方式

  POST

• 子账户token请求所需最小权限

  "Permission":"Config" "Resource":"dev:序列号"

• 请求参数

• HTTP请求报文

POST /api/lapp/keylock/local/verify HTTP/1.1
Host: open.ys7.com
Content-Type: application/x-www-form-urlencoded

accessToken=at.dunwhxt2azk02hcn7phqygsybbw0wv6p&deviceSerial=427734203

• 返回数据

{
    "code": "200",
    "msg": "操作成功"
}

• 返回码

获取指纹锁用户列表

• 接口功能

  该接口用于获取指纹锁上注册的用户列表

• 请求地址

  https://open.ys7.com/api/lapp/keylock/user/list

• 请求方式

  POST

• 子账户token请求所需最小权限

  "Permission":"Get" "Resource":"dev:序列号"

• 请求参数

• HTTP请求报文
  

POST /api/lapp/keylock/user/list HTTP/1.1
Host: open.ys7.com
Content-Type: application/x-www-form-urlencoded

accessToken=at.dunwhxt2azk02hcn7phqygsybbw0wv6p&deviceSerial=427734203

• 返回数据

{
    "data": [
     {
         "lockUserIndex": "27",
         "lockUserName": "阿姨",
         "lockUserType":"0",
         "fingerCount": 10,
         "pwdCount": 0,
         "cardCount": 0,
         "expiredEnable": 0,
         "beginTime": 1457420564508,
         "endTime": 1457420564508,
         "lockType": 1
    }
       ],
       "code": "200",
       "msg": "操作成功!"
}

• 返回参数说明

• 返回码

分页获取开门记录

• 接口功能

  该接口用于分页获取指纹锁所在门的开门记录

• 请求地址

  https://open.ys7.com/api/lapp/keylock/open/list

• 请求方式

  POST

• 子账户token请求所需最小权限

  "Permission":"Get" "Resource":"dev:序列号"

• 请求参数

• HTTP请求报文

POST /api/lapp/keylock/open/list HTTP/1.1
Host: open.ys7.com
Content-Type: application/x-www-form-urlencoded

accessToken=at.dunwhxt2azk02hcn7phqygsybbw0wv6p&deviceSerial=427734203&pageStart=0&pageSize=2

• 返回数据

{
    "data": [
          {
             "lockUserName": "老公",
             "openType": 1,
             "openTime":1457420564508
         },
         {
             "lockUserName": "老公",
             "openType": 0,
             "openTime":1457420564508
         }
   ],
    "code": "200",
    "msg": "操作成功"
}

• 返回字段

• 返回码