投诉列表查询接口文档

投诉
查询投诉

一、接口名称

投诉列表查询

二、接口描述

查询小区内的投诉记录，支持分页查询，并返回投诉相关的图片和负责人员信息。

三、接口路径

http://ip:port/app/complaint.listComplaints

四、请求方法

GET

五、请求头

六、请求参数

6.1 查询参数

七、返回值

7.1 返回数据结构

7.2 ComplaintDto 结构

7.3 PhotoVo 结构

7.4 ComplaintTypeUserDto 结构

八、示例请求

GET /app/complaint.listComplaints?communityId=123456&page=1&row=10 HTTP/1.1
Authorization: Bearer xxxxxxxx
app-id: micro-community
transaction-id: 100000000020231001120000000001
sign: xxxxxxxx
req-time: 20231001120000

九、示例响应

{
  "code": "0",
  "msg": "成功",
  "data": {
    "total": 5,
    "records": 2,
    "rows": [
      {
        "complaintId": "10001",
        "communityId": "123456",
        "typeCd": "1001",
        "state": "待处理",
        "content": "楼道灯坏了",
        "createTime": "2023-10-01 10:00:00",
        "photos": [
          {
            "url": "http://xxx.com/photo1.jpg"
          }
        ],
        "staffs": [
          {
            "userId": "2001",
            "userName": "张三",
            "typeCd": "1001"
          }
        ]
      },
      {
        "complaintId": "10002",
        "communityId": "123456",
        "typeCd": "1002",
        "state": "处理中",
        "content": "电梯故障",
        "createTime": "2023-10-01 11:00:00",
        "photos": [],
        "staffs": [
          {
            "userId": "2002",
            "userName": "李四",
            "typeCd": "1002"
          }
        ]
      }
    ]
  }
}