新增人员
POST
https://api2.hik-cloud.com/api/v1/estate/system/person
| 返回码 | 返回消息 | 描述 | |
|---|---|---|---|
| 510001 | 参数错误 | 必填项为空、参数长度不符合等参数异常情况 | |
| 511000 | 社区不存在 | ||
| 511011 | 证件类型为空 | ||
| 511012 | 证件号为空 | ||
| 511013 | 证件格式错误 | ||
| 511015 | 手机格式错误 | ||
| 511016 | 英文名称格式错误 | ||
| 511017 | 社区ID不能为空 | ||
| 511018 | 身份类型为租客时，离开时间不能为空 | ||
| 511021 | 姓名和手机号在平台中已存在，请判断证件信息与平台证件信息是否匹配 | ||
| 511025 | 参数不合法 | 一些必填字段为空等参数异常情况，比如楼栋ID、单元ID、户室ID、身份类型为空等现象 | |
| 511027 | 该房间没有业主 | ||
| 511038 | 证件信息在平台中已存在 ，请判断姓名与证件信息是否匹配 | ||
| 511040 | 日期格式错误 | ||
| 511053 | 楼栋不存在 | ||
| 511054 | 单元不存在 | ||
| 511056 | 你所添加的房屋已存在业主 | ||
| 511059 | 租户信息不匹配 | 不能关联其他租户的房屋 | |
| 511083 | 社区不包含楼栋 | ||
| 511084 | 楼栋不包含单元 | ||
| 511086 | 房间不存在 | ||
| 511096 | 没有填写身份信息 | 身份信息应至少包含：1、姓名+证件类型+证件号码2、手机号+姓名两组中的一组 | |
| 511099 | 身份类型为租客时，离开时间必须大于入住时间 | ||
| 511115 | 入住时间为空 | ||
| 511143 | 证件类型错误 | ||
| 511146 | 民族名称填写错误 | ||
| 511095 | 人脸URL不合法 | ||
| 511100 | 人脸图片质量不合格 | ||
| 511117 | 人脸评分校验失败 | ||
| 511118 | 人脸特征点置信度校验失败 | ||
| 511119 | 人脸眼间距校验失败 | ||
| 511120 | 人脸俯仰角校验失败 | ||
| 511121 | 人脸左右角校验失败 | ||
| 511122 | 人脸可见性校验失败 | ||
| 511123 | 人脸清晰度校验失败 | ||
| 511189 | 离开时间必须大于入住时间 | ||
| 511113 | 卡号长度超过20 | ||
| 511116 | 卡号只能是数字和字母 | ||
| 511104 | 住户只能有三张卡 | ||
| 511106 | 卡号已被使用 |
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api2.hik-cloud.com/api/v1/estate/system/person' \
--header 'Authorization: Bearer ' \
--header 'Content-Type: application/json' \
--data-raw '{
"unionId": "",
"personName": "张三",
"gender": 1,
"credentialType": 1,
"credentialNumber": "522128547844512369",
"mobile": "13358745129",
"faceUrl": "https://hik-cloud.com/img1.jpg",
"birthday": "2001-02-02",
"personRemark": "备注信息",
"nation": "汉族",
"educationalLevel": 3,
"workUnit": "海康威视",
"position": "研发总监",
"religion": 2,
"englishName": "Bob",
"email": "12345@qq.com",
"addressDetail": "北京市天通苑详细地址",
"provinceCode": "130000",
"cityCode": "130100",
"countyCode": "130102",
"personCommunityRels": [
{
"communityId": "c242a6d58bb4485e99cd5c3e8c1cc570",
"buildingId": "c242a6d58bb4485e99cd5c3e8c1cc570",
"unitId": "fd8fe4f53fa449c4b9e640956030478b",
"roomId": "4b7c226f000146189ff76f445a7cc268",
"identityType": 2,
"checkInDate": "2019-04-07",
"checkOutDate": "2029-05-07"
}
],
"cardNumbers": ["1234567", "2234567"]
}'响应示例响应示例
{
"code": 200,
"message": "操作成功",
"data": {
"personId": "00a795f4a25d4de09edd091f28747eb4",
"cardIds": [
"00a795f4a25d4de09edd091f28747eb4",
"541295f4a25d4de09edd091f287436e5"
]
}
}请求参数
Header 参数
Authorization
string
可选
默认值:
Bearer {{access_token}}
Body 参数application/json
返回响应
扫码加入交流群