新增人员

功能描述

新增住户人员信息。

注意：

1、本篇住户专指业主、家属、租客三个身份类别的人员。

2、“姓名”+“手机号”或者“证件类型”+“证件号码”至少有一组信息完整。

返回码

返回码	返回消息	描述
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	卡号已被使用

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

unionId

string

关联ID,保留字段

可选

personName

string

姓名

必需

gender

integer

性别

可选

[-1]无[0]女[1]男

credentialType

integer

证件类型

必需

[1]身份证[2护照[3]其他

credentialNumber

string

证件号码

必需

mobile

string

手机号

必需

faceUrl

string

人脸图片URL

可选

图片要求：大小：200k以内；格式：jpg

birthday

string

出生日期

可选

personRemark

string

备注

可选

nation

string

民族

可选

educationalLevel

integer

文化程度

可选

[1]中专;[2]大专;[3]本科;[4]硕士;[5]博士;[6]其他

workUnit

string

工作单位

可选

position

string

职务

可选

religion

integer

宗教信仰

可选

[1]基督教;[2]伊斯兰教;[3]佛教

englishName

string

英文名称

可选

string

邮箱

可选

addressDetail

string

详细地址

可选

provinceCode

string

现户籍地/省编码

可选

cityCode

string

现户籍地/市编码

可选

countyCode

string

现户籍地/区编码

可选

personCommunityRels

array [object {7}]

房屋信息

可选

communityId

string

社区ID

必需

buildingId

string

楼栋ID

必需

unitId

string

单元ID

必需

roomId

string

户室ID

必需

identityType

integer

身份类型

必需

[1]业主[2]租客[3]家属

checkInDate

string

入住时间

必需

checkOutDate

string

离开时间

可选

当身份类型为业主或家属时,无需离开时间

cardNumbers

array[string]

卡号列表

可选

示例

application/json

Body

code

integer

返回码

必需

message

string

返回消息

必需

data

object

节点对象

必需

personId

string

人员id

必需

cardIds

array[string]

卡号id列表

可选

请求参数

返回响应