Mobile Review Surfaces

Overview

The mobile module exposes two different review experiences:

1. authenticated customer product review actions
2. public storefront testimonial reads

Authenticated Mobile Product Review Endpoints

Submit review

POST /api/mobile/reviews

Purpose:

• customer submits a review for a purchased order item

Required fields:

• orderId
• productId
• rating

Optional:

• comment

List my reviews

GET /api/mobile/reviews

Purpose:

• customer reviews their own previously submitted product reviews

Supports:

• pagination
• status filter
• product filter
• order filter

Public Mobile Read Endpoints

Product reviews by product id

GET /api/mobile/products/id/:productId/reviews

Purpose:

• mobile storefront product detail view can load approved product reviews

Testimonials

GET /api/mobile/reviews/testimonials

Purpose:

• mobile storefront can render trust sections, carousels, or home page testimonial modules

Supports:

• pagination
• exact rating filter
• ordering

Implementation Notes

• mobile testimonial endpoint reuses the same public testimonial service as web public route
• mobile product review read route still reuses the product review public service
• this keeps business rules centralized and docs easier to maintain