---
title: "评价"
description: "Shopify 评价——接受的参数与返回的内容。"
---

```
GET|POST /v1/shopify/reviews
```

**Price** $0.001 per call, plus $0.001 for each extra call it makes — at most 6 more, so $0.007 in total. 首页通常比基础费用多计 1 个单位。`cursor` 翻页只计基础费用。 [List price](https://apinoa.com/en/pricing); the rate steps down above 1,000 calls a day.

| Parameter | Type | Required | Notes |
|---|---|---|---|
| `id` | string | yes | The composite Shopify `shop/handle` — the same id `product` takes, not a global identifier. This is the one Shopify operation whose cost varies: a first page can cost more than 1, while a page fetched with `cursor` costs 1. |
| `cursor` | string |  | Opaque cursor from the previous response; the only paging knob that works on every shop, and it wins if `page` is sent too. A page fetched with a cursor costs 1. |
| `page` | integer |  | 1-based starting page. Not every shop supports jumping to a page number; `cursor` works on every shop, so prefer it for paging. |

一次评价调用可能不止 1 个单位，区间见上方。各店铺提供评价的方式不同，这体现在几个方面：

- **请使用 `cursor`。** 并非每个店铺都支持 `page`；`cursor` 始终可用。
- **没有评价也是一个答案，而且它会明说是零。** 没有评价的商品返回 `200`，带 `reviews: []` 与
  **`page.total: 0`**。这在 Shopify 上很常见——大多数商品都没有评价——而这个零只在确实如此时才会发出。
- **只有星级、没有文字的评分按零条计。** 有些店铺把纯星级评分与文字评价分开存放。一个有三个星级评分、
  没有任何文字的商品会返回 `total: 0`——没有可返回的评价——尽管它的页面上可能显示着星星。
- **501 表示评价存在但无法提供。** `REVIEW_APP_UNSUPPORTED`——这家店铺的评价无法提供。
  `REVIEWS_UNREACHABLE`——报出了评价数或平均分，或页面上能看到评价，却一条也没取回。两者都有意既不是零
  也不是 404：评价确实存在。

评价经常是**被合并的**：商家可能用整个系列的评价来回答某一种颜色的页面。在计算单个商品的评分之前，请先
检查响应中的 `grouped`。