人员权限信息更新

接口描述
对于绑定权限组时指定权限信息的人员权限进行更新
该接口使用全量更新逻辑,不传的权限参数部分会使用默认值下发
目前仅支持单个人员权限信息的更新

curl --location --request POST 'https://api2.hik-cloud.com/api/v1/open/accessControl/personPermission/update' \ --header 'Authorization: Bearer ' \ --header 'Content-Type: application/json' \ --data-raw '{ "employeeNo": "emp101", "groupId": "fa229f5c3e414d1ea5dbefc83dda6394", "personPhone": "17775302114", "personType": "normal", "floorNo": 22, "roomNo": 2, "validBeginTime": "2020-02-11", "validEndTime": "2032-12-30", "planTemplateNos": [ 1 ], "dynamicCode": "123456", "maxOpenDoorTime": 10, "belongGroup": 2418, "callNumbers": [ "1-1-1-101", "1-1-1-102" ], "floorNumbers": [ 1, 1 ], "localUIRight": 1 }'

请求参数

Header 参数

Authorization

string

可选

默认值:

Bearer {{access_token}}

Body 参数application/json

employeeNo

string

人员编号，同一个租户下不能重复，只支持英文、数字

必需

groupId

string

权限组id

必需

personPhone

string

人员手机号

可选

personType

string

人员类型， normal：普通人，visitor:访客，blackList:黑名单，默认：normal

可选

floorNo

integer

楼层号，取值1-999，不填时默认为1

可选

roomNo

integer

房间号，取值1-99，不填时默认为1

可选

validBeginTime

string

人员权限开始时间，日期格式只支持如下两种格式：(1)权限精确到天，示例：2020-01-01 (2)权限精确到秒并加上时区，示例：2019-01-29T00:00:59+08:00

可选

validEndTime

string

人员权限结束时间，日期格式只支持如下两种格式：(1)权限精确到天，示例：2020-01-01 (2)权限精确到秒并加上时区，例如：2019-01-29T00:00:59+08:00 ; 结束时间需早于2037-12-31

可选

planTemplateNos

array[integer]

人员计划模板列表，不填时默认为[1] 代表计划模板 1(全天候模板 )；调用计划模板修改接口，修改计划模板1可能会影响默认计划模板人员的权限。

可选

dynamicCode

string

人员开门码，仅支持6位纯数字，且必须是6位；门禁设备不支持该字段，可视对讲设备支持

可选

maxOpenDoorTime

integer

人员最大开门次数，0-代表无次数限制，默认无次数限制；门禁设备支持该字段，可视对讲设备不支持；只有当personType=visitor时该参数才会生效

可选

belongGroup

integer

所属群组，多个以英文逗号分隔，例如”1,3,5”，最多支持4个；该字段仅多重认证功能使用，其他场景禁止使用

可选

callNumbers

array[string]

呼叫号码列表;roomNumber的扩展，支持多房间号，两者同时存在时，优先解析callNumbers国内规则：1-1-1-层号+房间号。高三位表示层号，范围1~999；低两位表示房间号，范围1~99。eg：如层号为1，房间号为1，则为1-1-1-101；如层号为222，房间号为4，则为1-1-1-22204。国内eg：callNumbers为[“1-1-1-101”,”1-1-1-302”]，则floorNumbers为[1,3]；callNumbers为[“1-1-1-101”,”1-1-1-102”]，则floorNumbers为[1,1]；

可选

floorNumbers

array[integer]

房间层号；floorNumber的扩展，支持多层，两者同时存在时，优先解析floorNumbers。要求floorNumbers与callNumbers的数组元素个数一一对应。国内eg：callNumbers为[“1-1-1-101”,”1-1-1-302”]，则floorNumbers为[1,3]；callNumbers为[“1-1-1-101”,”1-1-1-102”]，则floorNumbers为[1,1]；

可选

localUIRight

integer

是否具有设备本地UI访问权限, 1-有权限，0-无权限;贯通梯权限，表示这个人有全楼层权限

可选

示例

请求参数

返回响应