获取产品/订单评价列表接口

获取产品或订单的评价列表，支持按商品、用户等条件筛选和分页查询。

注意事项

该接口采用GET方法
支持按商品ID、用户ID、订单ID等条件筛选
支持自定义排序方式
支持分页查询，默认每页10条记录
只返回已审核通过的评价（状态为1）

请求地址

{域名地址}/api/review/list

说明：{域名地址} 需要替换成你的域名地址，如 https://www.anqicms.com/api/review/list

请求语法

GET {域名地址}/api/review/list

请求头

此接口还涉及公共请求头。更多信息，请参见公共请求头（Common Request Headers）。

请求参数

字段名	类型	必填	说明
id	int	否	文档ID，指定要获取评价的商品
user_id	int	否	用户ID，获取指定用户的评价
order	string	否	评论排序方式，默认 `id desc`
page	int	否	页码，默认为 1
limit	int	否	每页显示数量，默认为 10

响应头

此接口仅涉及公共响应头。更多信息，请参见公共请求头（Common Request Headers）。

返回参数

字段名	类型	说明
code	int	错误码
msg	string	错误原因说明
data	object[]	评价列表数组

data 结果 item 参数

字段名	类型	说明
id	int	评论ID
order_id	string	订单ID
archive_id	int	文档ID
archive_sku_id	int	SKU ID
user_id	int	用户ID
ip	string	用户IP地址
score	int	评分（1-5分）
content	string	评价内容
images	string[]	评价图片列表
user_name	string	用户名
email	string	用户邮箱
created_time	int	发布时间戳
updated_time	int	更新时间戳
status	int	审核状态，1 已审核，0 审核中

使用示例

请求示例

GET /api/review/list?archive_id=1&page=1&limit=10 HTTP/1.1
Host: www.anqicms.com

响应示例

{
  "code": 0,
  "msg": "获取成功",
  "data": [
    {
      "id": 45,
      "order_id": "20231101000001",
      "archive_id": 1,
      "archive_sku_id": 1,
      "user_id": 123,
      "ip": "192.168.1.100",
      "score": 5,
      "content": "商品质量很好，非常满意！",
      "images": [
        "https://www.anqicms.com/uploads/review/2023/11/image1.jpg",
        "https://www.anqicms.com/uploads/review/2023/11/image2.jpg"
      ],
      "user_name": "张三",
      "email": "zhangsan@example.com",
      "created_time": 1698825600,
      "updated_time": 1698825600,
      "status": 1
    },
    {
      "id": 44,
      "order_id": "20231031000005",
      "archive_id": 1,
      "archive_sku_id": 2,
      "user_id": 124,
      "ip": "192.168.1.101",
      "score": 4,
      "content": "商品不错，物流也很快。",
      "images": [],
      "user_name": "李四",
      "email": "lisi@example.com",
      "created_time": 1698739200,
      "updated_time": 1698739200,
      "status": 1
    }
  ]
}

错误代码

错误码	说明
0	OK
-1	错误，错误原因在 msg 中指出
1001	未登录
1002	未授权
200	API 请求 OK