Seller Orchestra Internal API Mapping

Categories

Complete 3-layer API flow for category management: hierarchical taxonomy for seller catalogs

View Postman Documentation

3-Layer Architecture

Seller API Gateway Public (Internet)
Seller Catalog & Inventory Internal Orchestration
Catalogue Service Core Microservices

Create Category

Create a category with parent-child hierarchy, ordering, and images

POST
Seller API Gateway Layer 1 - Public
POST /merchant/api/v1/domains/:domain_id/categories
Seller Catalog & Inventory Layer 2 - Orchestration
POST /api/categories

6-Step Flow:

  1. Validate domain and caller permissions
  2. Ensure handle uniqueness within domain
  3. Create category record in Catalogue Service
  4. Attach image via CloudOperations if provided
  5. Reindex navigation/search
  6. Invalidate category cache
Core Microservices Layer 3 - Core Microservices
1 POST /api/categories Catalogue Service · Core Microservices

List Categories

List categories with tree structure, filters, and pagination

GET
Seller API Gateway Layer 1 - Public
GET /merchant/api/v1/domains/:domain_id/categories
Query: ?tree=true&depth=2&visible=true
Seller Catalog & Inventory Layer 2 - Orchestration
GET /api/categories
Core Microservices Layer 3 - Core Microservices
1 GET /api/categories?domain_id=:domain_id&tree=true Catalogue Service · Core Microservices

Get Category

Retrieve a specific category with metadata

GET
Seller API Gateway Layer 1 - Public
GET /merchant/api/v1/domains/:domain_id/categories/:id
Seller Catalog & Inventory Layer 2 - Orchestration
GET /api/categories/:id
Core Microservices Layer 3 - Core Microservices
1 GET /api/categories/:id Catalogue Service · Core Microservices

Update Category

Update name, position, visibility, and other fields

PATCH
Seller API Gateway Layer 1 - Public
PATCH /merchant/api/v1/domains/:domain_id/categories/:id
Seller Catalog & Inventory Layer 2 - Orchestration
PATCH /api/categories/:id
Core Microservices Layer 3 - Core Microservices
1 PATCH /api/categories/:id Catalogue Service · Core Microservices
2 DELETE /api/cache/categories/:id Caching Service · Shared Services

Delete Category

Soft-delete a category

DELETE
Seller API Gateway Layer 1 - Public
DELETE /merchant/api/v1/domains/:domain_id/categories/:id
Seller Catalog & Inventory Layer 2 - Orchestration
DELETE /api/categories/:id
Core Microservices Layer 3 - Core Microservices
1 DELETE /api/categories/:id Catalogue Service · Core Microservices
2 DELETE /api/cache/categories/:id Caching Service · Shared Services

Documentation Notes

This documentation represents the internal API flow between Seller API Gateway, Seller Catalog & Inventory Orchestration, and Core Microservices (Catalogue Service for categories, User Service for auth).

JWT Authentication Required • Rate Limited • Redis Cached
Open full text mapping (orchestra-internal-api-mapping.txt)