# 評論與評分

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

> Markdown version of https://kanorio.com/zh-Hant/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**

評論讓顧客能夠針對購買的商品進行評分與描述。評論會指向其目標對象，而目標對象僅儲存總體評分與顯示設定。

## 核心物件

- **評論 (Reviews)：** 來自已驗證買家的評分與文字，或是匯入的評論。買家評論可進行核准或拒絕；匯入的評論亦可刪除。
- **回覆 (Replies)：** 商店針對評論公開的回應。
- **設定 (Settings)：** 針對每個商品：是否啟用評論、顯示門檻以及起始的歷史評分。

## 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/zh-Hant/help/reviews