新增物业人员

功能描述

新增物业人员信息。

备注：调用物业人员添加接口，就是在云眸平台注册了一个可以登陆的物业人员账号；返回的参数中appId和secret两个参数是在第三方跳转的时候需要用到的参数，具体用法详见：第三方跳转登录云眸社区对接规范。

返回码

返回码	返回消息	描述
510001	参数错误	必填项为空、参数长度不符合等参数异常情况
511015	手机格式错误
511061	有效社区id不能为空	若 communityIds字段为“0”时报错，则是因为本租户未添加社区，请先调用添加社区接口，添加社区；若不为“0”时报错，则是因为根据所传id无法查到社区，请检查数据；若为空，则提示510001
511068	角色信息不合法	角色信息包含不符合约定的信息
511082	用户名或手机号已被使用
511091	用户名不合法	用户名包含数字字母之外的非法字符

curl --location --request POST 'https://api2.hik-cloud.com/api/v1/estate/system/property' \ --header 'Authorization: Bearer ' \ --header 'Content-Type: application/json' \ --data-raw '{ "userName": "zhangsan", "phoneNumber": "15029936331", "communityIds": "00a795f4a25d4de09edd091f28747eb4,e09edd091f28747eb400a795f4a25d4d", "roleKeys": "COMMUNITY_ROLE_A,COMMUNITY_ROLE_B", "personName": "张三" }'

{ "code": 200, "message": "操作成功", "data": { "personId": "00a795f4a25d4de09edd091f28747eb4", "appId": "8F91BEFC7CA5473E86353EC8269E1884", "secret": "5F9D6E2DCA8243709189D57B47A2DF22" } }

请求参数

Header 参数

Authorization

string

可选

默认值:

Bearer {{access_token}}

Body 参数application/json

userName

string

账号

可选

只支持数字和字母，建议不要填写，云眸后台支持自动填充

phoneNumber

string

联系电话

必需

communityIds

string

管辖社区

必需

多个社区id之间以逗号相隔；若传值为“0”，则默认管理所有小区

roleKeys

string

角色

必需

多个角色之间以逗号相隔，角色列表见附录

personName

string

姓名

必需

示例

application/json

Body

code

integer

返回码

必需

message

string

返回消息

必需

data

object

节点对象

必需

personId

string

人员id

必需

appId

string

第三方登陆ID

必需

secret

string

第三方登陆密钥

必需

请求参数

返回响应