透传人员权限删除

  • 接口功能

从智能锁直接删除人员权限信息；
同一时间，一个智能锁只允许被一个用户操作，若未指定设备序列号，则同一时间只能有一个第三方企业用户调用该接口；
参数（设备序列号、工号）必填一项，支持删除指定设备上所有用户权限信息，支持删除用户指定用户在所有设备的权限信息（异步交互）；

  • 请求地址

https://open.ys7.com/api/component/saas/smartlock/person/delete

  • 请求方式

POST

  • 参数列表
参数名 类型 描述 是否必填
accessToken String 开放平台授权获取的访问令牌 Y
deviceSerial String 智能锁设备序列号 N
employeeNo String 工号 N
  • 请求报文
POST https://open.ys7.com/api/component/saas/smartlock/person/delete HTTP/1.1
Host: open.ys7.com
content-type: application/x-www-form-urlencoded
accessToken=at.29jzy7vi88yfsuh85io56p9i4dkqsb0d-8z5uqcucl2-1fhh9lp-xh6a59hqv&deviceSerial=K03323778&employeeNo=aaaaaaaaaaaaa111111111112
  • 返回数据
{
    "code": "200",
    "msg": "操作成功",
    "data": [{
        "cmdId": {
                "cmdId": "KNsm5GHjTdMTdHtRpP2ef5",
                "code": "12",
                "msg": "权限删除中",
                "operation": "person"
            },
        "id": "ef8cc40a74f54117b104e3baa9956791",
        "isDelete": "1",
        "saasUserId": "3002",
        "deviceSerial": "C74528358",
        "saasPersonId": "20290",
        "saasPersonName": "测试",
        "userType": "2",
        "validEnable": "1",
        "authorityStatus": "1",
        "remarks": "成功",
        "createBy": "3002",
        "createTime": "2019-06-25 11:22:15",
        "updateTime": "2019-06-25 11:24:23"
    }]
}
  • 参数说明
参数名 类型 描述 是否必须
code int 状态码-200，表示通过云端校验，成功开始与设备交互;
权限是否删除成功请根据data中authorityStatus判断		 Y
msg String 具体错误描述信息 Y
data Object[] 业务结果 N
data[i].cmdId Object NB锁相关命令信息 N
data[i].cmdId.cmdId String NB锁命令id N
data[i].cmdId.code String NB锁命令状态码 N
data[i].cmdId.msg String NB锁命令状态描述 N
data[i].cmdId.operation String 具体操作：person-人员；password-密码；card-卡；face-人脸；finger-指纹（指纹会分包） N
data[i].saasUserId String 企业用户ID N
data[i].deviceSerial String 设备序列号 N
data[i].saasPersonId String 人员ID N
data[i].saasPersonName String 人员姓名 N
data[i].validEnable String 有效期使能,0-TRUE,1-FALSE N
data[i].beginTime String 有效期起始时间,yyyy-MM-dd HH:mm:ss N
data[i].endTime String 有效期结束时间,yyyy-MM-dd HH:mm:ss N
data[i].cardPassword String 密码 N
data[i].cardNo String 卡号 N
data[i].fingerNo String 手指编号:1-10 N
data[i].fingerType String 指纹类型:0-普通指纹,1-胁迫指纹 N
data[i].authorityStatus String 权限下发状态(1-删除成功，其他-删除失败) N
data[i].remarks String 权限状态信息 N
data[i].createTime String 创建时间 N
data[i].updateTime String 更新时间 N

results matching ""

    No results matching ""