更新人员信息

POST

https://api2.hik-cloud.com/api/v1/community/access/persons/actions/update

功能描述

更新平台上的人员、人脸、卡信息。

说明：人脸信息或卡信息更新时不存在，默认新增；

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api2.hik-cloud.com/api/v1/community/access/persons/actions/update' \
--header 'Authorization: Bearer ' \
--header 'Content-Type: application/json' \
--data-raw '{

         
   "employeeNo": "A011",        

         
   "personName": "xiaoer11",    

         
   "userType": "visitor",      

         
   "validEnable": true,       

         
   "validBeginTime": "2019-06-04T17:30:00",   

         
   "validEndTime": "2019-06-08T17:30:00",     

         
   "roomNumber": 9,

         
   "floorNumber": 6,  

         
   "templateNo": 1,

         
   "face": {

         
       "faceName": "AF011",  

         
       "faceUrl": "http://xxxx.com/xxx/xxx.jpg"

         
   },

         
   "card": {

         
       "cardNo": "1832711",  

         
       "cardType": "normalCard"  

         
   }

         
}'

响应示例

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

请求参数

Header 参数

Authorization

string

可选

默认值:

Bearer {{access_token}}

Body 参数application/json

employeeNo

string

人员编号，唯一

必需

personName

string

人员姓名

必需

userType

string

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

必需

validEnable

boolean

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

必需

validBeginTime

string

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

必需

有效期使能时必填

validEndTime

string

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

必需

有效期使能时必填

roomNumber

integer

房间号

必需

floorNumber

integer

层号

必需

templateNo

integer

计划模板编号

可选

face

object

人脸信息

必需

faceName

string

人脸名称

必需

faceUrl

string

人脸图片地址

必需

card

object

卡信息

必需

cardNo

string

卡号（只支持纯数字），唯一

必需

cardType

string

卡类型，normalCard-普通卡，patrolCard-巡更卡，hijackCard-胁迫卡，superCard-超级卡，dismissingCard-解除卡，emergencyCard-应急管理卡（用于授权临时卡权限，本身不能开门）

必需

示例

返回响应

🟢200成功

application/json

Body

code

integer

返回码

必需

message

string

返回消息

可选

data

object

空对象

可选

修改于 2022-05-27 08:57:44

批量注册人员信息

查询人员列表

更新人员信息

功能描述#

请求参数

返回响应

功能描述