command

Submit Review

Command issued by a customer to submit a review and rating for a product.

CommandBroker:Kafka

Overview

SubmitReview is sent to the Review APIReview APIServicev1.0.0The public-facing API for product reviews. Accepts review submissions, serves published reviews, and is the entry point ...Publishesreview-submitted, review-flagged +1Subscribessubmit-review, flag-review +2Ownerreviews-platformMapRepoView docs when a customer submits a review for a product they have purchased. The API validates and stores the review, then publishes Review SubmittedReview SubmittedEventv1.0.0Published when a customer submits a review. The review is stored but not yet visible — it awaits moderation. Ownerreviews-platformSchemaMapView docs.

Architecture diagram

Event-driven architecture documentation: Acme Inc

JSON Schema

7 properties
reviewIdstring<uuid>
required

Client-generated id for the review.

productIdstring
required

The product being reviewed.

customerIdstring
required

The customer submitting the review.

ratinginteger
required

Star rating from 1 to 5.

Minimum: 1
Maximum: 5
titlestring
Max length: 120
bodystring
required
Max length: 5000
submittedAtstring<date-time>
required