商品评论配置-保存
Product Review Set Config API 文档
接口信息
- 接口地址:
{your-site-url}/api/skill/product-review/set - 基础 URL:
{your-site-url}需替换为你自己的独立站 URL 地址，如https://your-domain.com/apimanager666 - 请求方式:
POST - Content-Type:
application/json - 说明: 此接口用于设置商品评论模块的相关配置
认证
请求头中需要携带 skill-access-token：
| Header | 值 |
|---|---|
skill-access-token |
{your-skill-access-token} （请替换为你自己的 token） |
请求参数 (JSON Body)
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
status |
int | 选填 | 开启评论功能。1 = 开启，2 = 关闭 |
auto_publish |
int | 选填 | 开启评论自动发布功能。1 = 开启，2 = 关闭 |
more_than_x_auto_publish |
int | 选填 | 自动发布的星级门槛。如 4 表示自动发布 4 星及以上的评论 |
review_condition |
int | 选填 | 评论门槛。1 = 成功下单后可评论，2 = 无门槛 |
verified_purchase |
int | 选填 | 强制显示 Verified Purchase 标志。1 = 开启（所有评论都显示），2 = 按默认逻辑（购买后评论才显示） |
front_note |
string | 选填 | 评论区域补充说明或免责声明文案 |
front_note_url |
string | 选填 | 说明文案的跳转链接，点击文案即跳转 |
show_as_percent |
int | 选填 | 评论数按百分比展示。1 = 开启，2 = 关闭 |
less_than_x_show_percent |
int | 选填 | 评论数低于 x 个时启用百分比展示。如 100 表示评论数 < 100 时显示百分比 |
front_num_per_page |
int | 选填 | 商品评论列表每页显示评论个数 |
product_show_type |
int | 选填 | 商品详情页显示评论星标。1 = 商品标题下方显示，2 = 不展示 |
collection_show_type |
int | 选填 | 首页、专辑详情页等商品列表显示评论星标。1 = 商品标题下方显示，2 = 不展示 |
请求示例
cURL
curl --location --request POST '{your-site-url}/api/skill/product-review/set' \
--header 'skill-access-token: {your-skill-access-token}' \
--header 'Content-Type: application/json' \
--data-raw '{
"status": 1,
"auto_publish": 1,
"more_than_x_auto_publish": 4,
"review_condition": 2,
"front_note": "Comment description",
"front_note_url": "https://www.fecify.com",
"show_as_percent": 1,
"less_than_x_show_percent": 100,
"front_num_per_page": 10,
"product_show_type": 1,
"collection_show_type": 1,
"verified_purchase": 1
}'
返回结果
code 为 200 表示调用成功；code 不为 200 表示调用失败。
成功响应
{
"code": 200,
"data": [],
"message": "success"
}
返回字段说明
| 字段 | 类型 | 说明 |
|---|---|---|
code |
Number | 状态码，200 表示成功 |
message |
String | 执行结果的文字描述 |
data |
Array | 返回数据，目前为空数组 |
注意事项
- 所有字段均为选填，填写则保存，不填写则不会修改原有数据
more_than_x_auto_publish仅在auto_publish开启时生效less_than_x_show_percent仅在show_as_percent开启时生效front_note和front_note_url配套使用，front_note_url为空则不跳转- 与系统-基本设置-获取 配套使用，get 获取配置，set 保存配置
- 注意：api保存是全量保存，即时您只配置修改一个选项，也要进行全量保存，因此，先通过获取api得到数据，然后进行更改数据，然后进行保存