商品评论-商品的评论列表

Product Review Get Product Review List API 文档

接口信息

  • 接口地址: {your-site-url}/api/skill/product-review/get-product-review-list
  • 基础 URL: {your-site-url} 需替换为你自己的独立站 URL 地址，如 https://your-domain.com/apimanager666
  • 请求方式: GET
  • 说明: 此接口用于获取指定商品的评论列表及评论汇总信息

认证

请求头中需要携带 skill-access-token：

Header 值
skill-access-token {your-skill-access-token} （请替换为你自己的 token）

请求参数 (Query String)

字段 类型 必填 说明
product_id string/int ✅ 必填 商品 ID
pageNum int 选填 第几页，不填写则默认第 1 页
pageSize int 选填 每页的数据个数，不填写则使用系统默认值
review_content string 选填 评论内容模糊搜索
star int 选填 评星筛选
status int 选填 评论状态。1 = 审核通过（显示），2 = 未审核（隐藏）

请求示例

cURL

curl --location --request GET '{your-site-url}/api/skill/product-review/get-product-review-list?product_id=7046&pageNum=1&pageSize=10' \
--header 'skill-access-token: {your-skill-access-token}' \
--data-raw ''

返回结果

code 为 200 表示调用成功；code 不为 200 表示调用失败。

成功响应

{
    "code": 200,
    "data": {
        "product": {
            "id": 7046,
            "title": "Diamond signet ring, Gold rings jewelry",
            "handle": "diamond-signet-ring-gold-rings-jewelry-faoqu8hv",
            "image": {
                "id": 40986,
                "product_id": 7046,
                "src": "/product/15/image/2026/05/23/xxx.jpg",
                "width": 840,
                "height": 1100,
                "ratio": "0.76",
                "alt": "",
                "position": 1,
                "created_at": 1779538004,
                "updated_at": 1779538004
            }
        },
        "review_summary": {
            "id": 107,
            "shop_id": 15,
            "product_id": 7046,
            "review_count": 8,
            "review_published_count": 7,
            "review_published_image_count": 8,
            "review_unpublished_count": 1,
            "review_published_star": "5.00",
            "review_published_star_info": {
                "s1": 0,
                "s2": 0,
                "s3": 0,
                "s4": 0,
                "s5": 7
            },
            "review_last_person": "John Doe",
            "created_at": "2026-05-26 08:36:39",
            "updated_at": "2026-05-27 16:33:58"
        },
        "reviews": {
            "list": [],
            "total": 8,
            "pageSize": 10,
            "totalPage": 1
        },
        "show_as_percent": 1,
        "less_than_x_show_percent": 100
    },
    "message": "success"
}

返回字段说明

字段 类型 说明
code Number 状态码，200 表示成功
message String 执行结果的文字描述
data Object 返回数据

data 顶层字段

字段 类型 说明
product Object 商品基本信息
review_summary Object 评论汇总统计
reviews Object 评论分页列表
show_as_percent int 评论数百分比展示开关。1 = 开启，2 = 关闭
less_than_x_show_percent int 评论数低于此值时启用百分比展示

product 子字段

字段 类型 说明
id int 商品 ID
title string 商品标题
handle string 商品 URL handle
image Object 商品首图信息

product.image 子字段

字段 类型 说明
id int 图片 ID
product_id int 商品 ID
src string 图片路径
width int 图片宽度（px）
height int 图片高度（px）
ratio string 图片宽高比
alt string 图片 alt 文本
position int 图片排序位置
created_at int 创建时间（时间戳）
updated_at int 更新时间（时间戳）

review_summary 子字段

字段 类型 说明
id int 汇总记录 ID
shop_id int 店铺 ID
product_id int 商品 ID
review_count int 总评论数
review_published_count int 已发布评论数
review_published_image_count int 已发布图片评论数
review_unpublished_count int 未发布评论数
review_published_star string 已发布评论平均星级
review_published_star_info Object 各星级评论数量分布
review_last_person string 最近评论人名称
created_at string 创建时间
updated_at string 更新时间

review_published_star_info 子字段

字段 类型 说明
s1 int 1 星评论数量
s2 int 2 星评论数量
s3 int 3 星评论数量
s4 int 4 星评论数量
s5 int 5 星评论数量

reviews 子字段

字段 类型 说明
list Array[Object] 评论列表（字段同通用评论列表接口）
total int 该商品评论总数
pageSize int 每页数据个数
totalPage int 总页数

注意事项

  1. product_id 为必填参数
  2. 返回数据比通用评论列表多出 product、review_summary 和百分比展示配置
  3. review_summary 包含评论的汇总统计数据，如平均星级、各星级分布等
Copyright © fecify.com 2025 all right reserved，powered by Gitbook该文件修订时间： 2026-05-27 16:51:56

results matching ""

    No results matching ""