权限信息分页查询

  • 接口功能

分页查询智能锁关联的人员权限信息列表

  • 请求地址

https://open.ys7.com/api/component/saas/smartlock/authority/v2/list/page

  • 请求方式

POST

  • 参数列表
参数名 类型 描述 是否必填
accessToken String 开放平台授权获取的访问令牌 Y
deviceSerial String 设备序列号 N
personId Long 人员ID N
crNo String 读卡器编号,默认所有 N
isDistinguishCr String 是否区分读卡器:1或true-区分,0或false-不区分,默认不区分 N
isShowAuthority String 是否显示权限属性信息:1或true-显示,0或false-不显示,默认不显示 N
isNeedCard String 是否必须有卡权限:1或true-是，0或false-否，默认否 N
isNeedFace String 是否必须有人脸权限:1或true-是，0或false-否，默认否 N
isNeedFinger String 是否必须有指纹权限:1或true-是，0或false-否，默认否 N
isNeedPassWord String 是否必须有密码权限:1或true-是，0或false-否，默认否 N
pageNo Integer 页番号(默认1) N
pageSize Integer 每页记录数(默认10) N
  • 请求报文
POST https://open.ys7.com/api/component/saas/smartlock/authority/v2/list/page HTTP/1.1
Content-Type: application/x-www-form-urlencoded
Host: open.ys7.com
accessToken=at.90i2w04n3jqsl56e0d2znrmt5ztylx6z-5q56tj2ssr-0q7ad23-3ugpqsuup
  • 返回数据
{
    "code": "200",
    "data": [
        {
            "deviceSerial": "K03323759",
            "employeeNo": "4b440f81958d450aa8da04cf9ad864d5",
            "userEnable": "1",
            "cardAuth": "1",
            "cardNo": "2350637686",
            "cardRemarks": "成功",
            "cardUpdate": "2022-10-22 19:28:51.0",
            "userType": "2",
            "validEnable": "0",
            "beginTime": "2022-10-22 18:29:51",
            "endTime": "2023-10-22 18:29:51",
            "cardPassword": "******",
            "passwordRemarks": "成功",
            "passwordStatus": "1",
            "passwordUpdate": "2022-10-22 19:28:50.0",
            "dvcFinger": "1,2",
            "fingerAuth": "1,1",
            "fingerNo": "1,2",
            "fingerRemarks": "成功,成功",
            "fingerUpdate": "2022-11-16 18:55:23,2022-11-16 18:55:22",
            "updateTime": "2022-11-16 18:55:23",
            "localFingerStatus": 1,
            "authorityStatus": "1",
            "remarks": "成功",
            "person": {
                "id": "8930588",
                "seq": "5",
                "isDelete": "0",
                "saasCompanyId": "58244",
                "personName": "金阿建",
                "isValidateFace": false,
                "faceImageUrl": "https://saas-client.oss-cn-beijing.aliyuncs.com/e384/186dfe97-eacc-4b0c-8644-41c80eda5755.jpg",
                "phoneNumber": "13588213932",
                "certificateType": "1",
                "maritalStatus": -1,
                "createBy": "945322",
                "createTime": "2022-09-15 16:30:32",
                "saasUserId": "945322",
                "updateTime": "2022-12-19 11:37:28",
                "userId": "4b440f81958d450aa8da04cf9ad864d5"
            }
        }
    ],
    "msg": "操作成功",
    "page": {
        "page": 1,
        "size": 10,
        "total": 1
    }
}
  • 参数说明

没有说明的参数大概率使用不上，有需要再询问。

参数名 类型 描述 是否必须
code int 状态码-200表示成功 Y
msg String 具体错误描述信息 Y
data Object 业务结果 Y
data[i].deviceSerial String 设备序列号 Y
data[i].employeeNo String 工号 Y
data[i].userEnable Integer 人员是否冻结：0-冻结；1-未冻结 Y
data[i].cardAuth String 卡权限状态码：1-成功；10-下发中；其它-异常状态 N
data[i].cardRemarks String 卡权限状态描述 N
data[i].cardNo String 卡号，没有就是没有对应权限 N
data[i].validEnable String 是否校验有效期：0-校验；1-不校验 Y
data[i].beginTime String 权限开始时间 N
data[i].endTime String 权限结束时间 N
data[i].cardPassword String 密码内容，保护隐私都为6个*，没有就是没有对应权限 N
data[i].passwordStatus String 密码状态码 N
data[i].passwordRemarks String 密码状态描述 N
data[i].fingerNo String 指纹编号，两个由,分隔，状态也是对应的 N
data[i].fingerAuth String 指纹状态码 N
data[i].fingerRemarks String 指纹状态描述 N
data[i].facePicUrl String 人脸图片地址 N
data[i].faceAuth String 人脸状态码 N
data[i].faceRemarks String 人脸状态描述 N
data[i].authorityStatus String 人员状态码 Y
data[i].remarks String 人员状态描述 Y
data[i].person Object 人员信息 Y

results matching ""

    No results matching ""