Orchestra Internal API Mapping

Rating & Review

Review management operations with 3-layer architecture: API Gateway -> Customer Account Service -> Core Microservices

View Postman Documentation

3-Layer Architecture

API Gateway Public (Internet)
Customer Account Service Internal Orchestration
Core Microservices Internal Services

1. Submit Reviews

APIs for submitting product and order reviews

Submit Product Review

Product

Submit a new product review with rating, title, and comment (1 step)

POST
API Gateway Layer 1 - Public
POST /reviews
Customer Account Service Layer 2 - Orchestration
POST /reviews

Orchestrates 1 service call

Layer 3 - Service Calls (1 Step)
1 Util Service Core Microservices
POST /api/reviews

Create Product Review

Request Payload
{
  "type": "product",
  "entity_id": "{{product_id}}",
  "rating": 5,
  "title": "Excellent Product!",
  "comment": "This product exceeded my expectations. Highly recommended!",
  "images": []
}

Submit Order Review

Order

Submit a review for an order/delivery experience (1 step)

POST
API Gateway Layer 1 - Public
POST /reviews
Customer Account Service Layer 2 - Orchestration
POST /reviews

Orchestrates 1 service call

Layer 3 - Service Calls (1 Step)
1 Util Service Core Microservices
POST /api/reviews

Create Order Review

Request Payload
{
  "type": "order",
  "entity_id": "{{order_id}}",
  "rating": 4,
  "title": "Good Service",
  "comment": "Order was delivered on time and packaging was good.",
  "images": []
}

2. Get Reviews

APIs for retrieving user and entity reviews

Get My Reviews

My Reviews

Retrieve all reviews submitted by the authenticated user (1 step)

GET
API Gateway Layer 1 - Public
GET /reviews/my-reviews
Customer Account Service Layer 2 - Orchestration
GET /reviews/my-reviews

Orchestrates 1 service call

Layer 3 - Service Calls (1 Step)
1 Util Service Core Microservices
GET /api/reviews/my-reviews

Get User Reviews

Get Reviews by Type and ID

Entity Reviews

Get all reviews for a specific product or order (1 step)

GET
API Gateway Layer 1 - Public
GET /reviews?type=product&id={{product_id}}
Customer Account Service Layer 2 - Orchestration
GET /reviews

Orchestrates 1 service call

Layer 3 - Service Calls (1 Step)
1 Util Service Core Microservices
GET /api/reviews

Get Entity Reviews

3. Update & Delete

APIs for modifying and removing reviews

Update Review

Update

Update an existing review (rating, title, comment, or images) (1 step)

PUT
API Gateway Layer 1 - Public
PUT /reviews/:review_id
Customer Account Service Layer 2 - Orchestration
PUT /reviews/:review_id

Orchestrates 1 service call

Layer 3 - Service Calls (1 Step)
1 Util Service Core Microservices
PUT /api/reviews/:review_id

Update Review

Delete Review

Delete

Delete a review submitted by the authenticated user (1 step)

DELETE
API Gateway Layer 1 - Public
DELETE /reviews/:review_id
Customer Account Service Layer 2 - Orchestration
DELETE /reviews/:review_id

Orchestrates 1 service call

Layer 3 - Service Calls (1 Step)
1 Util Service Core Microservices
DELETE /api/reviews/:review_id

Delete Review

Services Used in Rating & Review Module

🎯

Customer Account Service

Orchestration layer for review operations

Util Service

Review CRUD operations, rating management

Rating & Review Module - Orchestra Internal API Mapping | 6 APIs | 6 Total Steps