Apinoa Docs

评价

Shopify 评价——接受的参数与返回的内容。

查看原始 .mdx
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; the rate steps down above 1,000 calls a day.

ParameterTypeRequiredNotes
idstringyesThe 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.
cursorstringOpaque 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.
pageinteger1-based starting page. Not every shop supports jumping to a page number; cursor works on every shop, so prefer it for paging.

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

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

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