商品评论-列表

Product Review Get Review List API 文档

接口信息

  • 接口地址: {your-site-url}/api/skill/product-review/get-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)

字段 类型 必填 说明
pageNum int 选填 第几页,不填写则默认第 1 页
pageSize int 选填 每页的数据个数,不填写则使用系统默认值
product_id string/int 选填 商品 ID,筛选指定商品的评论
status int 选填 评论状态。1 = 审核通过(显示),2 = 未审核(隐藏)
star int 选填 评星,筛选指定星级的评论
review_content string 选填 评论内容模糊搜索
is_image_review int 选填 是否含图片评论。1 = 是,2 = 否
id_begin int 选填 评论 ID 过滤区间下限,评论 ID 大于等于该值
id_end int 选填 评论 ID 过滤区间上限,评论 ID 小于等于该值
created_at_begin string 选填 评论创建时间过滤区间下限,创建时间大于等于该值,格式如 2026-01-01 00:00:00
created_at_end string 选填 评论创建时间过滤区间上限,创建时间小于等于该值,格式如 2026-01-01 00:00:00

请求示例

cURL

curl --location --request GET '{your-site-url}/api/skill/product-review/get-review-list' \
--header 'skill-access-token: {your-skill-access-token}' \
--data-raw ''

返回结果

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

成功响应

{
    "code": 200,
    "data": {
        "list": [
            {
                "id": 394,
                "shop_id": 15,
                "product_id": 7046,
                "language_code": "cn",
                "status": 1,
                "is_image_review": 1,
                "review_content": "werwer",
                "star": 5,
                "images": [
                    {
                        "src": "/customer_upload/15/image/2026/05/26/xxx.jpg",
                        "width": 384,
                        "height": 430,
                        "ratio": 0.89
                    }
                ],
                "person_name": "Jessica L",
                "email": "1186735711@qq.com",
                "country_code": "",
                "likes_count": 0,
                "reviewed_at": "2026-05-26 20:46:28",
                "reply_content": "",
                "replyed_at": 0,
                "verified_purchase": 1,
                "is_show_in_page_all": 1,
                "is_feature": 2,
                "created_at": "2026-05-26 20:46:28",
                "updated_at": "2026-05-26 20:46:28",
                "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
                    }
                }
            }
        ],
        "total": 341,
        "pageSize": 20,
        "totalPage": 18
    },
    "message": "success"
}

返回字段说明

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

data 顶层字段

字段 类型 说明
total int 评论总数
pageSize int 每页的数据个数
totalPage int 总页数
list Array[Object] 评论列表

list 子项字段

字段 类型 说明
id int 评论 ID
shop_id int 店铺 ID
product_id int 商品 ID
language_code string 评论所属语言代码
status int 评论状态。1 = 审核通过(显示),2 = 未审核(隐藏)
is_image_review int 是否含图片评论。1 = 是,2 = 否
review_content string 评论内容
star int 评星,取值 1~5
images Array 评论图片数组,无图片时为空数组 []
person_name string 评论人名称
email string 评论人邮箱
country_code string 国家代码
likes_count int 点赞数
reviewed_at string 评论时间
reply_content string 商家回复内容,空字符串表示未回复
replyed_at string/int 回复时间。0 表示未回复
verified_purchase int 是否显示 Verified Purchase 标志。1 = 显示,2 = 不显示
is_show_in_page_all int 是否显示在全部评论页。1 = 是,2 = 否
is_feature int 是否精选评论。1 = 是,2 = 否
created_at string 创建时间
updated_at string 更新时间
product Object/null 关联的商品信息。商品已删除或无权限时为 null

images 子项字段

字段 类型 说明
src string 图片路径或完整 URL
width int/string 图片宽度(px),旧数据可能为空字符串
height int/string 图片高度(px),旧数据可能为空字符串
ratio float/string 图片宽高比,旧数据可能为空字符串

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 更新时间(时间戳)

注意事项

  1. 所有参数均为选填
  2. product 可能为 null,表示该评论关联的商品已被删除或无权限访问
  3. images 数组中每个元素的格式见下方 images 子项说明
Copyright © fecify.com 2025 all right reserved,powered by Gitbook该文件修订时间: 2026-05-29 17:17:37

results matching ""

    No results matching ""