aitori-web-v2/doc/USER_FEEDBACK_API.md

用户反馈 API 文档

本文档专门描述用户反馈管理相关的接口。

1. 基础信息

• URL 前缀: /v2/user/feedback
• 响应格式: 统一使用 GlobalResponseWrapper

---

2. 接口列表

2.1 获取用户反馈列表

• URL: /list
• Method: GET
• 描述: 分页查询用户反馈列表。接口会同时返回提交反馈的用户详细信息（昵称、邮箱、苹果ID、平台、语言等），并支持通过这些用户属性进行搜索。

请求参数

字段名	类型	必填	说明
page	integer	否	页码，默认 1
size	integer	否	每页大小，默认 10
userId	integer	否	精确筛选用户ID
platform	string	否	筛选用户平台 (如 "IOS", "ANDROID")
language	string	否	筛选用户语言 (如 "zh-CN", "en-US")
keyword	string	否	多字段模糊搜索。支持匹配： 1. 反馈标题 (title) 2. 反馈内容 (content) 3. 用户昵称 (nickname) 4. 用户邮箱 (email) 5. 苹果ID (appleUserId) 6. 原始交易ID (originalTransactionId)
startTime	string	否	开始时间 (yyyy-MM-dd HH:mm:ss)
endTime	string	否	结束时间 (yyyy-MM-dd HH:mm:ss)

响应参数 (data 字段)

返回 Mybatis-Plus Page 对象，records 列表中的元素结构如下：

字段名	类型	说明
id	integer	反馈ID
userId	integer	用户ID
title	string	反馈标题
content	string	反馈内容
createTime	string	创建时间
nickname	string	用户昵称
email	string	用户邮箱
appleUserId	string	苹果ID
originalTransactionId	string	原始交易ID
platform	string	用户平台
language	string	用户语言

示例响应

{
  "code": 200,
  "message": "success",
  "data": {
    "records": [
      {
        "id": 101,
        "userId": 10086,
        "title": "充值未到账",
        "content": "我刚刚充值了会员，但是没有生效...",
        "createTime": "2023-10-27 10:00:00",
        "nickname": "测试用户A",
        "email": "test@example.com",
        "appleUserId": "000000.89347589237589.0000",
        "originalTransactionId": "200000000000000",
        "platform": "IOS",
        "language": "zh-CN"
      }
    ],
    "total": 1,
    "size": 10,
    "current": 1
  }
}