Apinoa Docs

리뷰

쇼피파이 리뷰 — 받는 파라미터와 돌아오는 값.

원본 .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를 쓰세요. page는 모든 상점에서 지원되지 않지만, cursor는 언제나 동작합니다.
  • 리뷰 없음도 답이며, 0이라고 말합니다. 리뷰가 없는 상품은 200reviews: []와 **page.total: 0**으로 답합니다. 쇼피파이에서는 흔한 일이며 — 대부분의 상품에는 리뷰가 없습니다 — 이 0은 정말로 그럴 때만 보냅니다.
  • 글 없는 별점은 리뷰 0건으로 셉니다. 일부 상점은 별점만 남긴 평가를 글로 쓴 리뷰와 따로 보관합니다. 별점 세 개가 있고 글이 없는 상품은 total: 0으로 답합니다 — 돌려줄 리뷰가 없기 때문이며, 상품 페이지에는 별이 보일 수 있습니다.
  • 501은 리뷰가 있으나 제공되지 않는다는 뜻입니다. REVIEW_APP_UNSUPPORTED — 이 상점의 리뷰는 제공되지 않습니다. REVIEWS_UNREACHABLE — 리뷰 개수나 평점이 보고되거나 페이지에 리뷰가 보이는데도 하나도 가져오지 못했습니다. 둘 다 의도적으로 0도 404도 아닙니다. 리뷰는 존재합니다.

리뷰는 묶여 있는 경우가 잦습니다. 판매자가 한 색상의 페이지에 패밀리 전체의 행으로 답할 수 있습니다. 상품별 평점을 계산하기 전에 응답의 grouped를 확인하세요.