商品评论-列表
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 ''
返回结果
code 为 200 表示调用成功;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 |
更新时间(时间戳) |
注意事项
- 所有参数均为选填
product 可能为 null,表示该评论关联的商品已被删除或无权限访问
images 数组中每个元素的格式见下方 images 子项说明