批量注册人员信息

POST

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

功能描述

将人员基础信息注册到平台上，注册人员总数上限为10000个（实际留存的数量，非累计值），仅对通过该接口和注册人员接口注册人员数量限制，与设备无相关性。

接口支持列表最大值为500。

请求示例

Shell

JavaScript

Java

Swift

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

         
   "personnel": [

         
       {

         
           "employeeNo": "MJH77",

         
           "personName": "MJH77",

         
           "userType": "visitor",

         
           "validEnable": true,

         
           "validBeginTime": "2019-10-26T17:30:00",

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

         
           "roomNumber": 9,

         
           "floorNumber": 6,

         
           "face": {

         
               "faceName": "MJH77",

         
               "faceUrl": "https://xxxxx/xxxx/xxx.jpg"

         
           },

         
           "templateNo": 1

         
       }

         
   ]

         
}'

响应示例

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

请求参数

Header 参数

Authorization

string

可选

默认值:

Bearer {{access_token}}

Body 参数application/json

personnel

array [object {11}]

人员列表

必需

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

层号

必需

face

object

人脸信息

必需

templateNo

integer

计划模板编号，从1开始，不填默认为1

可选

card

array [object {2}]

卡信息

必需

示例

返回响应

🟢200成功

application/json

Body

code

integer

返回码

必需

message

string

返回消息

可选

data

object

节点对象

可选

注册人员信息

更新人员信息

批量注册人员信息

功能描述#

请求参数

返回响应

功能描述