# 리뷰 및 평점

> Star ratings and written reviews of products, with moderation, store replies and imported reviews.

> Markdown version of https://kanorio.com/ko/developers/products/reviews. Append `.md` to any developer docs URL for this format. Index: https://kanorio.com/llms.txt · MCP: https://app.kanorio.com/api/mcp
>
> Translated from the English original: https://kanorio.com/en/developers/products/reviews.md

Status: **Partial**

리뷰 기능을 통해 고객은 구매한 상품에 대해 평점을 매기고 후기를 작성할 수 있습니다. 리뷰는 특정 대상을 가리키며, 해당 대상에는 집계된 평점과 표시 설정만 저장됩니다.

## 핵심 객체

- **리뷰:** 인증된 구매자가 작성한 평점과 텍스트, 또는 가져온 리뷰입니다. 구매자 리뷰는 승인되거나 거부될 수 있으며, 가져온 리뷰는 삭제할 수도 있습니다.
- **답글:** 리뷰에 대한 스토어의 공개 답변입니다.
- **설정:** 상품별 설정입니다. 리뷰 사용 여부, 표시 임계값, 시작 시 기준이 되는 과거 평점 등을 설정합니다.

## API 활용 방법

- Content Delivery API를 사용하여 게시된 리뷰와 평점 요약을 읽거나, `<kanorio-reviews>` 및 `<kanorio-rating>`을 사용하여 렌더링할 수 있습니다.
- 고객은 Customer API를 통해 자신의 리뷰를 작성하고 수정할 수 있습니다.
- Management API를 사용하여 모데레이션, 답글 작성, 리뷰 가져오기 및 설정 변경을 수행합니다.
- Webhooks는 리뷰 제출, 게시 및 답글 작성에 대한 알림을 보고합니다.

## What the APIs expose

| Capability | Status | API | Elements | Hosted site | Webhooks |
| --- | --- | --- | --- | --- | --- |
| Reviews & ratings for products (services when bookings ship) | Partial | Management API `reviews.*` (list, get, approve, reject, reply, import, delete_imported, settings.get/update); Delivery `GET /reviews?target=` and `GET /reviews/summary?target=`; Customer API `GET/POST/PATCH /customer/reviews` | `<kanorio-reviews>` and `<kanorio-rating>` | `/store/products/reviews` and the hosted product page | `reviews.submitted`, `reviews.published`, `reviews.replied` |
| Photo or video attachments on reviews | Not offered | — | — | — | — |
| Multi-step moderation workflows and reviewer assignment | Not offered | — | — | — | — |
| Store-wide mixed review wall | Not offered | — | — | — | — |
| Google Product Ratings feed generation | Not offered | — | — | — | — |
| Hiding or auto-rejecting reviews by star rating | Not offered | — | — | — | — |

## API reference

- Management API: [Reviews](https://kanorio.com/en/developers/management-api/reviews) (9 operations)
- Content Delivery API: [Reviews](https://kanorio.com/en/developers/delivery-api/reviews) (2 operations)
- Customer API: [Reviews](https://kanorio.com/en/developers/customer-api/reviews) (3 operations)

## Webhook events

- `reviews.submitted`: Fired when a buyer submits or edits a review (it is pending moderation).
- `reviews.published`: Fired when a review becomes public: approved by the store, or imported.
- `reviews.replied`: Fired when the store posts or replaces its public reply to a review.

Payloads: https://kanorio.com/en/developers/webhooks/events

## Elements

- `<kanorio-reviews>`: Published reviews for a product or service with the rating summary, verified badges, replies and load more.
- `<kanorio-rating>`: Compact star rating and review count for a product or service.

## Recent changes

- 2026-10-28: Reviews: moderate, reply, import and settings

Full changelog: https://kanorio.com/en/developers/changelog

## For site owners

Dashboard help: https://kanorio.com/ko/help/reviews