# 评论与评分

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

> Markdown version of https://kanorio.com/zh-CN/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-CN/help/reviews