商业系统

评论与评分

商品星级评分与文字评论，支持审核、商店回复与导入评论功能。

部分

评论让顾客能够针对购买的商品进行评分与描述。评论会指向其目标对象，而目标对象仅存储总体评分与显示设置。

核心对象

评论 (Reviews)： 来自已验证买家的评分与文字，或是导入的评论。买家评论可进行核准或拒绝；导入的评论亦可删除。
回复 (Replies)： 商店针对评论公开的回应。
设置 (Settings)： 针对每个商品：是否启用评论、显示门槛以及起始的历史评分。

API 如何运作

使用 Content Delivery API 读取已发布的评论与评分摘要，或使用 <kanorio-reviews> 与 <kanorio-rating> 进行渲染。
顾客透过 Customer API 撰写与编辑自己的评论。
使用 Management API 进行审核、回复、导入与变更设置。
Webhooks 会回报已提交、已发布与已回复的评论。

API 开放的范围

Reviews & ratings for products (services when bookings ship)部分
API
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
Elements
<kanorio-reviews> and <kanorio-rating>
托管网站
/store/products/reviews and the hosted product page
Webhooks
reviews.submitted, reviews.published, reviews.replied
Photo or video attachments on reviews不提供
替代做法
Reviews are text plus a 1–5 rating. Media moderation and abuse handling have no staffing model yet; if added later, images go through the media ledger like any other asset.
Multi-step moderation workflows and reviewer assignment不提供
替代做法
A single pending queue: approve or reject. Same reasoning as the content primitive, which has no multi-step approval.
Store-wide mixed review wall不提供
替代做法
Each target (product, service) has its own list and aggregate. A mixed wall blends ratings of unrelated items, which UK CMA guidance treats as potentially misleading.
Google Product Ratings feed generation不提供
替代做法
Build the feed from Delivery GET /reviews yourself. The feed has minimum-count, language, low-rating and verification policies that are easy to violate; Kanorio guarantees imported reviews are never marked verified so your feed stays compliant.
Hiding or auto-rejecting reviews by star rating不提供
替代做法
reviews.reject exists for content that breaks your rules. Filtering by rating is prohibited by the FTC Consumer Reviews Rule (2024) and UK CMA guidance, so there is no such option.

API 参考

Webhook 事件

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.

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.

近期变更

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

查看完整更新日志

给网站所有者

如何在后台使用这项产品，请参阅帮助中心。

打开帮助中心