HC小区接口文档

基础接口

登陆接口 接口签名 员工接口

资产接口

小区接口 物业接口 楼栋接口 单元接口 房屋接口 交房 退房 车位接口 车辆接口

业主接口

业主接口 家庭成员 查询房屋认证 认证审核 账户接口 撤销账户明细

费用接口

费用项接口 创建费 查询费用 缴费接口 结束费用 缴费记录 水电抄表

工单接口

报修接口 投诉接口

API接口文档：查询待审核的业主绑定信息列表

一、接口名称

查询待审核的业主绑定信息列表

二、接口描述

该接口用于查询待审核的业主与App用户绑定信息列表，支持分页查询，并对敏感信息（如身份证号、手机号）进行脱敏处理。

三、接口路径

owner.listAuditAppUserBindingOwners（Java110Cmd中的服务编码）

四、请求方法

POST

五、请求头

参数名称 必填 类型 描述
Authorization 是 String 用户认证token，通过登录接口获取
app-id 是 String 应用ID，系统dev账户分配
transaction-id 是 String 请求流水号，格式：1000000000+YYYYMMDDhhmmss+6位序列（不能重复）
sign 是 String 签名，用于请求合法性校验
req-time 是 String 请求时间，格式：YYYYMMDDhhmmss

六、请求参数

6.1 查询参数（JSON Body）
参数名称 必填 类型 描述
communityId 是 String 小区ID，用于筛选指定小区的绑定信息
page 否 int 当前页码（默认1）
row 否 int 每页记录数（默认10）
userId 否 String 用户ID，用于权限校验（敏感信息脱敏依据）
appType 否 String 绑定类型：WECHAT（公众号）或 WECHAT_MINA（小程序）

七、返回值

7.1 响应格式

JSON格式，包含分页信息和数据列表： 

{
  "code": 0,
  "msg": "成功",
  "data": {
    "total": 100,
    "records": 10,
    "list": [
      {
        "appType": "WECHAT",
        "appTypeName": "公众号",
        "idCard": "320102**********1234",
        "link": "138****1234",
        "ownerName": "张三",
        "communityId": "123456789"
      }
    ]
  }
}
7.2 状态码
  • 200：请求成功
  • 400：参数缺失（如未传communityId）
  • 500：服务器内部错误
7.3 数据字段说明
字段名 类型 描述
appType String 绑定类型：WECHAT或WECHAT_MINA
appTypeName String 类型名称（自动转换）
idCard String 业主身份证号（无权限时脱敏）
link String 业主手机号（无权限时脱敏）
ownerName String 业主姓名
communityId String 小区ID

八、示例请求

POST /api/owner/listAuditAppUserBindingOwners
Headers:
{
  "Authorization": "Bearer xxxxxx",
  "app-id": "hc_user",
  "transaction-id": "100000000020231001123456000001",
  "req-time": "20231001123456",
  "sign": "xxxxxx"
}
Body:
{
  "communityId": "123456789",
  "page": 1,
  "row": 10
}

九、示例响应

{
  "code": 0,
  "msg": "成功",
  "data": {
    "total": 15,
    "records": 10,
    "list": [
      {
        "appType": "WECHAT_MINA",
        "appTypeName": "小程序",
        "idCard": "320102**********5678",
        "link": "139****5678",
        "ownerName": "李四",
        "communityId": "123456789"
      }
    ]
  }
}

十、业务逻辑说明

  1. 权限校验：通过userId检查用户是否有/roomCreateFee权限，若无权限则对敏感字段脱敏。
  2. 数据脱敏：
    • 身份证号：保留前6位和后4位，中间用**********替换。
    • 手机号：保留前3位和后4位，中间用****替换。
  3. 分页处理：根据page和row参数返回分页结果。

十一、数据库操作

  • 调用IOwnerAppUserInnerServiceSMO.queryOwnerAppUsers查询绑定列表。
  • 调用IMenuInnerServiceSMO.checkUserHasResource校验权限。