人员更新

功能描述

更新设备上已下发的人员信息。

curl --location --request GET 'https://api2.hik-cloud.com/api/v1/community/access/personnels' \ --header 'Authorization: Bearer ' \ --data-urlencode 'deviceSerial=' \ --data-urlencode 'employeeNo=' \ --data-urlencode 'name=' \ --data-urlencode 'userType=' \ --data-urlencode 'validEnable=' \ --data-urlencode 'validBeginTime=' \ --data-urlencode 'validEndTime=' \ --data-urlencode 'roomNumber=' \ --data-urlencode 'floorNumber='

请求参数

Header 参数

Authorization

string

可选

默认值:

Bearer {{access_token}}

Body 参数application/x-www-form-urlencoded

deviceSerial

string

设备序列号

必需

employeeNo

string

工号（人员ID）

必需

name

string

姓名

必需

userType

string

必需

人员类型，normal-普通人（主人），visitor-来宾（访客），blackList-黑名单人，当人员类型为normal时，有效期为永久，validenable字段将失效

validEnable

string

必需

使能有效期，false-不使能，true-使能，不使能代表长期有效

validBeginTime

string

必需

有效期起始时间，时间格式：2017-08-01T17:30:08

validEndTime

string

必需

有效期结束时间，时间格式：2017-08-01T17:30:08

roomNumber

string

房间号

必需

floorNumber

string

层号

必需

templateNo

string

可选

计划模板编号（根据设备能力集获取），不传默认为1

phoneNumber

string

可选

手机号（云电话功能使用）

checkUser

string

可选

设备是否进行人员重复添加校验，false-不校验，true-校验（如果不配置该字段，则设备默认进行人员重复校验）（如果确认设备端不存在任何人员信息，可将其置为false，则设备不进行重复校验，这样会加快下发速度；如果不确认，则不建议配置该字段）

belongGroup

string

可选

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

功能描述#

请求参数

返回响应

功能描述