HC小区接口文档

API接口文档：修改业主信息

添加家庭成员
 修改家庭成员
 删除家庭成员
 查询家庭成员

1. 接口名称

修改业主信息（第三方系统同步）

2. 接口描述

该接口用于第三方系统（如招商系统）同步业主信息到物业管理平台，支持修改业主基本信息、人脸照片、手机号等，并自动更新关联账户和绑定信息。

3. 接口路径

POST http://{ip}:{port}/app/owner.editOwnerMember

4. 请求方法

POST

5. 请求头

参数名称	必填	类型	描述
Authorization	是	String	用户认证Token（Base Token）
app-id	是	String	应用ID（由系统分配）
transaction-id	是	String	请求流水号（格式：`1000000000+YYYYMMDDhhmmss+6位序列`）
sign	是	String	签名（防篡改校验）
req-time	是	String	请求时间（格式：`YYYYMMDDhhmmss`）

6. 请求参数

请求体（JSON格式）

参数名称	必填	类型	长度限制	描述
communityId	是	String	30	小区ID
name	是	String	64	业主姓名
link	是	String	11	业主手机号（若含`*`则忽略）
idCard	否	String	30	身份证号（若含`*`则忽略）
address	否	String	512	住址
sex	否	String	12	性别（`0`女，`1`男）
ownerTypeCd	是	String	12	业主类型（`1001`业主，`2002`家庭成员；家庭成员需传`ownerId`）
remark	否	String	512	备注
memberId	是	String	30	业主ID（修改时必须传入）
ownerPhoto	否	String	-	人脸照片Base64（用于门禁系统）
ownerPhotoUrl	否	String	500	人脸照片URL（与`ownerPhoto`二选一，超长会报错）
attrs	否	Array	-	业主扩展属性（格式见下方说明）

attrs字段说明

[
  {
    "attrId": "可选，属性ID（新增时自动生成）",
    "specCd": "属性编码",
    "value": "属性值"
  }
]

7. 返回值

参数名称	类型	描述
code	int	状态码（`0`成功）
msg	String	提示信息（如错误原因）

示例响应

{
  "code": 0,
  "msg": "成功"
}

8. 示例请求

{
  "communityId": "2022121921870161",
  "name": "王王",
  "link": "18909718888",
  "idCard": "",
  "address": "张三",
  "sex": "0",
  "ownerTypeCd": "1001",
  "remark": "",
  "memberId": "123123123",
  "ownerPhoto": "",
  "attrs": [
    {
      "attrId": "112233",
      "specCd": "AGE",
      "value": "30"
    }
  ]
}

9. 业务逻辑说明

校验逻辑
- 必填字段检查（memberId、name、link、communityId）。
- 手机号去敏（含*时忽略）。
- 身份证号去敏（含*时忽略）。
- 人脸照片URL长度限制（≤500字符）。
更新逻辑
- 修改业主基本信息（OwnerPo表）。
- 同步更新关联账户的手机号和姓名（AccountPo表）。
- 处理扩展属性（新增或修改OwnerAttrPo表）。
- 若业主已绑定APP用户，同步更新绑定手机号（OwnerAppUserPo和UserPo表）。
事务控制
- 使用@Java110Transactional注解保证所有操作原子性。

10. 错误码说明

错误码	原因
非0	具体错误信息见`msg`字段（如“手机号重复”）

基础接口

资产接口

业主接口

费用接口

工单接口

API接口文档：修改业主信息

1. 接口名称

2. 接口描述

3. 接口路径

4. 请求方法

5. 请求头

6. 请求参数

7. 返回值

8. 示例请求

9. 业务逻辑说明

10. 错误码说明