Seller Orchestra Internal API Mapping

Blogs

Complete 3-layer API flow for blog post management: create, list, update, and delete

View Postman Documentation

3-Layer Architecture

Seller API Gateway Public (Internet)
Seller Admin Internal Orchestration
Utility Service Core Microservices

Create Blog Post

Create a blog post with metadata, tags, author, and SEO fields

POST
Seller API Gateway Layer 1 - Public
POST /merchant/api/v1/domains/:domain_id/blogs
Seller Admin Layer 2 - Orchestration
POST /api/blogs

5-Step Flow:

  1. Validate token and domain
  2. Validate required fields and sanitize HTML
  3. Create Post record in Utility Service
  4. If status=published, update search index
  5. Cache and return response
Core Microservices Layer 3 - Core Microservices
1 POST /api/blogs Utility Service · Core Microservices

List Blog Posts

List posts with filters, pagination, and search

GET
Seller API Gateway Layer 1 - Public
GET /merchant/api/v1/domains/:domain_id/blogs
Query: ?page=&limit=&status=published,draft&tag=coffee&search=brew
Seller Admin Layer 2 - Orchestration
GET /api/blogs
Core Microservices Layer 3 - Core Microservices
1 GET /api/blogs?domain_id=:domain_id Utility Service · Core Microservices

Get Blog Post

Retrieve full content of a specific blog post

GET
Seller API Gateway Layer 1 - Public
GET /merchant/api/v1/domains/:domain_id/blogs/:id
Seller Admin Layer 2 - Orchestration
GET /api/blogs/:id
Core Microservices Layer 3 - Core Microservices
1 GET /api/blogs/:id Utility Service · Core Microservices

Update Blog Post

Update fields with partial updates and scheduling changes

PATCH
Seller API Gateway Layer 1 - Public
PATCH /merchant/api/v1/domains/:domain_id/blogs/:id
Seller Admin Layer 2 - Orchestration
PATCH /api/blogs/:id
Core Microservices Layer 3 - Core Microservices
1 PATCH /api/blogs/:id Utility Service · Core Microservices
2 DELETE /api/cache/blogs/:id Caching Service · Shared Services

Delete Blog Post

Soft-delete a blog post

DELETE
Seller API Gateway Layer 1 - Public
DELETE /merchant/api/v1/domains/:domain_id/blogs/:id
Seller Admin Layer 2 - Orchestration
DELETE /api/blogs/:id
Core Microservices Layer 3 - Core Microservices
1 DELETE /api/blogs/:id Utility Service · Core Microservices
2 DELETE /api/cache/blogs/:id Caching Service · Shared Services

Documentation Notes

This documentation represents the internal API flow between Seller API Gateway, Seller Admin Orchestration, and Core Microservices (Utility Service for blogs, User Service for auth).

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