# 产品评论 API
本 API 提供了访问产品评论数据的接口。
**功能描述:**
该 API 允许您：
* **获取产品评论:** 您可以根据产品 ID 获取相关的评论列表。
* **过滤评论:** 您可以根据不同的条件（例如，评分、日期）过滤评论。
* **查看评论详情:** 您可以查看单个评论的详细信息。
**API 端点:**
* `GET /api/v1/products/{product_id}/reviews`：获取指定产品 ID 的所有评论。
**请求参数:**
| 参数名 | 类型 | 必填 | 描述 |
| ----------- | ------ | ---- | -------------------------------------- |
| `product_id` | `int` | 是 | 产品 ID |
| `page` | `int` | 否 | 页码，默认为 1 |
| `page_size` | `int` | 否 | 每页显示的数量，默认为 20 |
| `sort_by` | `string` | 否 | 排序字段，例如 `rating`, `date` |
| `sort_order`| `string` | 否 | 排序方式，`asc` (升序) 或 `desc` (降序) |
**响应格式:**
```json
{
"total_count": %d,
"page": %d,
"page_size": %d,
"reviews": [
{
"id": %d,
"product_id": %d,
"user": {
"name": "%s",
"email": "%s"
},
"rating": %d,
"comment": "%s",
"date": "%s"
}
]
}
```
**示例请求:**
`GET /api/v1/products/123/reviews?page=2&page_size=10&sort_by=rating&sort_order=desc`
**错误处理:**
| 状态码 | 描述 |
| ------ | ---------------------------------------- |
| 400 | 错误的请求参数。 |
| 404 | 未找到指定的产品或评论。 |
| 500 | 服务器内部错误。 |
**版本:**
v1.0
**注意事项:**
* 请确保您已获得访问 API 的权限。
* API 使用速率限制，请遵守相关规定。
* `Pro` 版本提供更高级的功能和更高的速率限制。
**其他:**
* 您可以在 [这里](https://example.com/documentation) 找到更详细的文档。
* 如果您有任何问题，请联系我们的技术支持团队。
* `View` 更多信息。
## 获取产品评论
此接口返回产品评论，并且可以显示特定产品或特定分类的结果。
```http
GET /products/reviews
GET /products/reviews?category_id=1,2,3
GET /products/reviews?product_id=1,2,3
GET /products/reviews?orderby=rating&order=desc
```
| 属性 | 类型 | 是否必选 | 描述 |
| :------------ | :------ | :------: | :-------------------------------------------------------------------------------------------------- |
| `page` | integer | 否 | 集合的当前页。 |
| `per_page` | integer | 否 | 结果集中返回的最大项目数。 |
| `offset` | integer | 否 | 通过指定数量的项目偏移结果集。 |
| `order` | string | 否 | 按照升序或降序排序属性。 允许的值：`asc`, `desc` |
| `orderby` | string | 否 | 按照对象属性对集合进行排序。 允许的值：`date`, `date_gmt`, `id`, `rating`, `product` |
| `category_id` | string | 否 | 将结果集限制为来自特定分类 ID 的评论。 |
| `product_id` | string | 否 | 将结果集限制为来自特定产品 ID 的评论。 |
```sh
curl "https://example-store.com/wp-json/wc/store/v1/products/collection-data?calculate_price_range=true&calculate_attribute_counts=pa_size,pa_color&calculate_rating_counts=true"
```
**示例响应:**
```json
[
{
"id": 83,
"date_created": "2022-01-12T15:42:14",
"formatted_date_created": "一月 12, 2022",
"date_created_gmt": "2022-01-12T15:42:14",
"product_id": 33,
"product_name": "带有Logo的帽子",
"product_permalink": "https://store.local/product/beanie-with-logo/",
"product_image": {
"id": 56,
"src": "https://store.local/wp-content/uploads/2021/11/beanie-with-logo-1.jpg",
"thumbnail": "https://store.local/wp-content/uploads/2021/11/beanie-with-logo-1-324x324.jpg",
"srcset": "https://store.local/wp-content/uploads/2021/11/beanie-with-logo-1.jpg 800w, https://store.local/wp-content/uploads/2021/11/beanie-with-logo-1-324x324.jpg 324w, https://store.local/wp-content/uploads/2021/11/beanie-with-logo-1-100x100.jpg 100w, https://store.local/wp-content/uploads/2021/11/beanie-with-logo-1-416x416.jpg 416w, https://store.local/wp-content/uploads/2021/11/beanie-with-logo-1-300x300.jpg 300w, https://store.local/wp-content/uploads/2021/11/beanie-with-logo-1-150x150.jpg 150w, https://store.local/wp-content/uploads/2021/11/beanie-with-logo-1-768x768.jpg 768w",
"sizes": "(max-width: 800px) 100vw, 800px",
"name": "beanie-with-logo-1.jpg",
"alt": ""
},
"reviewer": "reviewer-name",
"review": "这是一个非常棒的产品。
\n",
"rating": 5,
"verified": true,
"reviewer_avatar_urls": {
"24": "https://secure.gravatar.com/avatar/12345?s=24&d=mm&r=g",
"48": "https://secure.gravatar.com/avatar/12345?s=48&d=mm&r=g",
"96": "https://secure.gravatar.com/avatar/12345?s=96&d=mm&r=g"
}
}
]
```
# 产品信息
本页面展示了产品信息。
## 字段说明
* `id`: 产品ID
* `date_created`: 创建日期
* `formatted_date_created`: 格式化的创建日期
* `product_id`: 产品ID
* `product_name`: 产品名称
* `product_permalink`: 固定链接
* `product_image`: 产品图片信息
* `src`: 图片网址
* `thumbnail`: 缩略图网址
* `srcset`: 图片集合
* `sizes`: 图片尺寸
* `name`: 图片名称
* `alt`: 图片描述
* `reviewer`: 评价者
* `review`: 评价内容
* `rating`: 评分
* `verified`: 是否为已验证的评价
* `reviewer_avatar_urls`: 评价者头像网址
## 示例
以下是一个产品评价的示例：
```json
[
{
"id": 83,
"date_created": "2022-01-12T15:42:14",
"formatted_date_created": "January 12, 2022",
"product_id": 33,
"product_name": "Beanie with Logo",
"product_permalink": "https://store.local/product/beanie-with-logo/",
"product_image": { ... },
"reviewer": "reviewer-name",
"review": "This is a fantastic product.
\n",
"rating": 5,
"verified": true,
"reviewer_avatar_urls": { ... }
}
]
```
## 详细信息
* `date_created`: 表示产品创建的日期和时间。
* `product_name`: 产品的名称。
* `product_permalink`: 指向产品详情页面的固定链接。
* `product_image`: 包含产品图片的各种尺寸和格式的信息。
* `review`: 用户对产品的评价内容。
* `rating`: 用户对产品的评分，通常是 1 到 5 之间的数字。
* `verified`: 指示该评价是否已通过验证。
## 上传文件
您可以通过点击“上传”按钮来上传文件。上传完成后，您可以设置文件的标题、描述和固定链接。
## 创建新产品
要创建新产品，请点击“创建”按钮。您需要填写产品名称、描述、价格、图片等信息。
## 商店设置
在商店设置中，您可以配置商店的名称、地址、联系方式、支付方式、运费规则等。
## 日志
`Log`文件记录了系统的运行状态和错误信息。
## 宽度
`Width`参数用于设置图像的宽度。
## 头像
`Avatar`是用户在论坛或社交媒体上使用的个人图像。
## 格式
`Format`是指文件或数据的格式，例如文本格式、图像格式等。
## 链接
`Link`是指网页之间的连接。
## 内容
`Content`是指文章或网页的文本和媒体。
## 评分
`Rating`是指用户对产品或服务的评价。
## 评价
`Review`是指用户对产品或服务的详细评价。
## 为
`For`表示为了。
## 在
`In`表示在...里面。
## 产品
`Product`是指商店中销售的商品。
## 日期
`Date`是指年月日。
## 增值税
`VAT`是指增值税。
## 已创建
`Created`表示已经创建。
## 网址
`Url`是指网址。
```