商品レビューリスト
概要
指定した商品のレビューリストを取得します。
API エンドポイント
bash
POST /product/v1/reviewListリクエストボディ
| フィールド | 型 | 必須 | 説明 |
|---|---|---|---|
filter | object | いいえ | フィルターパラメータ |
orderby | array | いいえ | ソートパラメータ |
page | integer | いいえ | デフォルト: 1 |
pagesize | integer | いいえ | デフォルト: 10 |
filter オプションパラメータ
| フィールド | 型 | 必須 | 説明 |
|---|---|---|---|
product_id | string | はい | 商品ID |
orderby オプションパラメータ
| フィールド | 必須 | 説明 |
|---|---|---|
rating | いいえ | 評価 |
review_id | いいえ | レビューID |
リクエスト例
bash
curl 'https://openapi.fastmoss.com/product/v1/reviewList' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer xxxxxxxxxx' \
--data '{
"filter": {
"product_id": "1729448464509734958"
},
"orderby": {
"field": "rating",
"order": "desc"
},
# "orderby": {
# "field": "review_id",
# "order": "desc"
# },
"page": 1,
"pagesize": 10
}'レスポンスボディ
data.list
| フィールド | 型 | 説明 |
|---|---|---|
review_id | string | レビューID |
uid | string | ユーザーID |
sku_id | string | SKU ID |
sku_specification | string | SKU仕様 |
rating | int | 評価 |
digg_count | int | いいね数 |
content | string | コメント内容 |
create_time | timestamp | 作成時間 |
data.total
| フィールド | 型 | 説明 |
|---|---|---|
total | string | 総レコード数 |
レスポンス例
json
{
"code": 0,
"data": {
"list": [
{
"review_id": "7354810045655336747",
"sku_id": "1729448464509800494",
"sku_specification": "Item: Default",
"rating": 5,
"digg_count": 0,
"content": "",
"create_time": 1712425181310
},
],
"total": "3809"
},
"message": "success",
"timestamp": 1743573480,
"request_id": "efd631c4-92cf-5d27-4f41-de09f20dd714"
}