HC小区接口文档

业主房屋认证审核接口文档

一、接口名称

业主房屋认证审核

二、接口描述

该接口用于审核业主或家庭成员提交的房屋认证申请，支持通过或拒绝操作。审核通过后，系统会更新业主/成员信息并建立房屋绑定关系。

三、接口路径

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

四、请求方法

POST

五、请求头

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

六、请求参数

6.1 请求体参数（JSON格式）

参数名称	必填	类型	描述	取值说明
appUserId	是	String	认证申请记录ID
state	是	String	审核状态	"1200"：拒绝，"其他"：通过
remark	是	String	审核说明
communityId	是	String	小区ID

七、返回值

7.1 响应格式（JSON）

参数名称	类型	描述
code	String	返回码（0成功，其他失败）
msg	String	返回信息
data	Object	返回数据（通常为空对象）

八、业务逻辑说明

验证阶段
- 检查appUserId对应的申请记录是否存在且状态为"待审核"（STATE_AUDITING）
- 校验所有必填参数
处理逻辑
- 拒绝操作：更新申请状态为STATE_AUDIT_ERROR
- 通过操作：
  - 如果是业主（OWNER_TYPE_CD_OWNER）：更新业主联系方式和账户信息
  - 如果是成员（如OWNER_TYPE_CD_MEMBER）：创建新的成员记录并绑定房屋
  - 更新用户姓名和申请状态为STATE_AUDIT_SUCCESS
数据库操作
- 更新：owner_app_user表状态
- 新增/更新：owner表业主/成员信息
- 更新：user表姓名信息
- 查询：房屋绑定关系、业主账户信息

九、示例请求

{
  "appUserId": "123456789",
  "state": "1200",
  "remark": "身份证照片不清晰",
  "communityId": "70202204190001"
}

十、示例响应

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

十一、状态码说明

状态码	描述
0	操作成功
1001	参数验证失败
2001	申请记录不存在
3001	房屋未绑定业主
9001	系统异常

十二、注意事项

审核拒绝时只需更新申请状态
成员绑定需要房屋已有业主
通过审核会自动更新用户姓名（取自申请记录）
事务注解保证数据一致性（@Java110Transactional）