业主反馈接口

新增业主反馈

接口地址:/openapi/houseOwnerFeedback/create

请求方式:POST

请求数据类型:application/json

响应数据类型:application/json

接口描述:

请求示例:

{
  "projectId":"123",
  "feedbackDesc":"一张图",
  "feedbackImages":"[\"https://reiniot-dcp.oss-cn-zhangjiakou.aliyuncs.com/ALI/aaa.png\"]",
  "houseOwnerPhone": "13013001300"
}

请求参数:工地ID和工地合同号不能同时为空

响应参数:

{
    "code": 200,
    "data": "123456789522562",
    "message": "",
    "successful": true
}

查询业主反馈

接口地址:/openapi/houseOwnerFeedback/page?pageNo=1&pageSize=10

请求方式:POST

请求数据类型:application/json

响应数据类型:application/json

接口描述:

分页查询业主反馈。支持三类筛选条件，可任意组合（多个条件之间是 AND 关系）：

1. 按工地精确定位：projectId（优先）或 contractNo
2. 按反馈时间范围：startDate / endDate
3. 模糊搜索：contractNoLike（合同号）/ projectNameLike（工地名称）

结果按反馈ID（id）升序返回，适合增量翻页拉取。数据自动限定在调用方所属租户内。

请求参数:

参数校验规则（不满足会返回 code: 300）：

注意：contractNoLike / projectNameLike 不算「按工地精确定位」。只传模糊条件而不传日期范围，仍会因为缺日期而报错——模糊条件可能命中大量工地，日期范围是必要的数据量闸门。

请求示例:

• 按工地ID查（日期可不传，行为与改造前一致）：

{
  "projectId": 1234567890123456789
}

• 按合同号精确查某个工地某段时间的反馈：

{
  "contractNo": "HT20260101001",
  "startDate": "2026-06-01",
  "endDate": "2026-08-31"
}

• 单纯根据时间范围查询

{
  "startDate": "2026-08-01",
  "endDate": "2026-08-31"
}

• 不指定工地，按时间范围 + 工地名称/合同号模糊搜索：

{
  "startDate": "2026-08-01",
  "endDate": "2026-08-31",
  "projectNameLike": "阳光小区",
  "contractNoLike": "HT2026"
}

响应参数:

枚举取值：

响应体中 projectStatus、projectStatusDesc、orgId、orgName、companyName、deptName、supervisorId、supervisorName、thirdTenantId 本接口不查询，恒为 null，请勿依赖。

响应示例:

{
  "code": 200,
  "message": "成功",
  "data": {
    "records": [
     {
        "id": "1",
        "houseOwnerName": "张先生",
        "houseOwnerPhone": "13800138000",
        "createdTime": "2026-08-06 16:37:05",
        "projectId": "1234567890123456789",
        "projectName": "阳光小区3栋1单元502",
        "contractNo": "HT20260101001",
        "projectStatus": null,
        "projectStatusDesc": null,
        "orgId": null,
        "orgName": null,
        "companyName": null,
        "deptName": null,
        "supervisorId": null,
        "supervisorName": null,
        "feedbackDesc": "业主反馈1106第二条",
        "feedbackImages": "["https://reiniot-dcp.oss-cn-zhangjiakou.aliyuncs.com/ALI/202407/42913519-2312-4d2c-a6fc-9d1ecb20e6af.jpg"]",
        "feedbackProjectStatus": "IN_BUILDING",
        "feedbackProjectStatusName": "在建",
        "replyUserId": null,
        "replyUserName": null,
        "replyStatus": "REPLIED",
        "replyStatusName": "已处理",
        "replyTime": "2026-08-06 16:39:36",
        "replyDesc": null,
        "replyImages": null,
        "replyConsumeDay": 0,
        "replyConsumeHours": 0,
        "evaluationDesc": null,
        "evaluationStar": null
      },
      {
        "id": "2",
        "houseOwnerName": "李女士",
        "houseOwnerPhone": "13900139000",
        "createdTime": "2026-08-18 18:18:01",
        "projectId": "1234567890123456790",
        "projectName": "阳光小区5栋2单元301",
        "contractNo": "HT20260101002",
        "projectStatus": null,
        "projectStatusDesc": null,
        "orgId": null,
        "orgName": null,
        "companyName": null,
        "deptName": null,
        "supervisorId": null,
        "supervisorName": null,
        "feedbackDesc": "业主第三次反馈，测试数据",
        "feedbackImages": null,
        "feedbackProjectStatus": "IN_BUILDING",
        "feedbackProjectStatusName": "在建",
        "replyUserId": null,
        "replyUserName": null,
        "replyStatus": "REPLIED",
        "replyStatusName": "已处理",
        "replyTime": "2026-08-18 18:18:34",
        "replyDesc": null,
        "replyImages": null,
        "replyConsumeDay": 0,
        "replyConsumeHours": 0,
        "evaluationDesc": null,
        "evaluationStar": null
      }
    ],
    "total": "11",
    "size": "10",
    "current": "1",
    "orders": [],
    "optimizeCountSql": true,
    "hitCount": false,
    "countId": null,
    "maxLimit": null,
    "searchCount": true,
    "pages": "2"
  },
  "successful": true
}

参数校验失败响应示例:

{
  "code": 300,
  "message": "工地ID、工地合同号都为空时，开始日期不能为空！",
  "successful": false
}

业主问题处理推送

接口地址:(第三方提供)

请求方式:POST

请求数据类型:application/json

响应数据类型:*/*

接口描述:

请求参数:

正常响应示例:

{
    "code":200,
    "message":"成功"
}