添加人员 - 海康云眸 IoT API

接口描述
添加人员

curl --location --request POST 'https://api2.hik-cloud.com/api/v1/open/basic/persons/create' \ --header 'Authorization: Bearer ' \ --header 'Content-Type: application/json' \ --data-raw '{ "employeeNo": "712", "personName": "bei", "personPhone":"17775302114", "faceImageBase64":"/9j/4AAQSkZJRgABAQEAYABgAAD/4RDcRXhpZgAATU0AKgAAA....", "verifyImage":true }'

{ "code": 200, "message": "操作成功", "data": { "employeeNo": "712", "personName": "bei", "personPhone": "17775302114", "faceUrl": "https://pbpics.hik-cloud.com/open/basic/person/face/d3ec23507c814a238f6104f47e281a30/123456.jpg?timestamp=1722aafcba7&v=1&signature=084283223e5c400b1bfac49d9364df93&moduleId=poseidon-basic-face", "personType": "normal", "floorNo": 33, "roomNo": 1, "validBeginTime": "2020-01-11T00:00:59+08:00", "validEndTime": "2030-12-30T00:00:59+08:00", "planTemplateNos": [ 1 ], "dynamicCode": "123456", "maxOpenDoorTime": 10, "callNumbers": [ "1-1-1-101", "1-1-1-302" ], "floorNumbers": [ 1, 3 ], "localUIRight": 1 } }

请求参数

Header 参数

Authorization

string

可选

默认值:

Bearer {{access_token}}

Body 参数application/json

employeeNo

string

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

必需

personName

string

人员姓名

必需

personPhone

string

人员手机号

可选

faceImageBase64

string

base64编码的人脸图片，图片大小需小于200kB，数据需去除base64前缀

可选

verifyImage

boolean

是否进行人脸质量校验，默认：true；如果调用方能保证人脸的质量符合标准那么可以配置为false,注意：如果调用方不能保证人脸质量，而且不对人脸质量校验，那么图片质量差的人脸可能会下发到设备，可能导致人脸下发失败

可选

示例

返回响应

🟢200成功

application/json

Body

code

integer

必需

message

string

必需

data

object

必需

employeeNo

string

必需

personName

string

必需

personPhone

string

必需

faceUrl

string

必需

personType

string

必需

floorNo

integer

必需

roomNo

integer

必需

validBeginTime

string

必需

validEndTime

string

必需

planTemplateNos

array[integer]

必需

dynamicCode

string

必需

maxOpenDoorTime

integer

必需

callNumbers

array[string]

必需

floorNumbers

array[integer]

必需

localUIRight

integer

必需