⚡

SpazaSure API Dashboard

All microservices — one view

Gateway :5181
6
Services
23
Endpoints
8
GET
8
POST
2
PUT
4
PATCH
1
DELETE
🔐

Auth Service

Supplier registration, login, tokens & password reset

:5001 6 endpoints ▼
POST
/api/supplier/auth/register
Register a new supplier account — returns JWT + refresh token
Public
POST
/api/supplier/auth/login
Login with email & password — returns JWT + refresh token
Public
POST
/api/supplier/auth/refresh
Exchange a refresh token for a new access token
Public
POST
/api/supplier/auth/logout
Revoke refresh token and end the session
Public
POST
/api/supplier/auth/forgot-password
Send password reset email (always returns 200 — prevents enumeration)
Public
POST
/api/supplier/auth/reset-password
Reset password using the token received by email
Public
📦

Product Service

Supplier product catalogue — CRUD, stock, availability & barcodes

:5002 7 endpoints ▼
GET
/api/supplier/products?page&pageSize&search&status
List products — status: active | pending_approval | archived
🔒 JWT
GET
/api/supplier/products/{id}
Get a single product by ID
🔒 JWT
POST
/api/supplier/products
Create a new product — auto-generates EAN-13 barcode if not supplied
🔒 JWT
PUT
/api/supplier/products/{id}
Update all product fields
🔒 JWT
PATCH
/api/supplier/products/{id}/toggle
Toggle product availability on / off
🔒 JWT
GET
/api/supplier/products/{id}/barcode
Get EAN-13 barcode + SVG render for a product
🔒 JWT
DELETE
/api/supplier/products/{id}
Permanently delete a product
🔒 JWT
🛒

Order Service

Supplier order management and status transitions

:5003 3 endpoints ▼
GET
/api/supplier/orders?page&pageSize&status
List orders — status: pending | processing | dispatched | delivered | cancelled
🔒 JWT
GET
/api/supplier/orders/{id}
Get full order detail including items and shop info
🔒 JWT
PATCH
/api/supplier/orders/{id}/status
Transition: pending → processing → dispatched → delivered (or cancelled)
🔒 JWT
📊

Analytics Service

Revenue trends, KPI summary and top-performing products

:5004 3 endpoints ▼
GET
/api/supplier/analytics/summary
Monthly KPIs: revenue, orders, active products, pending orders + MoM growth %
🔒 JWT
GET
/api/supplier/analytics/revenue?period=week|month|year
Revenue chart data grouped by day (week/month) or month (year)
🔒 JWT
GET
/api/supplier/analytics/top-products
Top 5 products by revenue this month with units sold
🔒 JWT
👤

User / Profile Service

Supplier profile, compliance documents and logo upload

:5005 4 endpoints ▼
GET
/api/supplier/profile
Get full supplier profile — company, banking, address, documents
🔒 JWT
PUT
/api/supplier/profile
Update company info, contact details, address and banking details
🔒 JWT
POST
/api/supplier/profile/documents
Upload compliance document — multipart/form-data: docType + file
🔒 JWT
POST
/api/supplier/profile/logo
Upload supplier logo — JPG/PNG/WEBP, max 5MB
🔒 JWT
✅

Compliance Service

Admin document review — approve or reject supplier documents

:5006 3 endpoints ▼
GET
/api/compliance/documents?status&search
List all supplier documents with pending / approved / rejected summary counts
🔒 JWT
PATCH
/api/compliance/documents/{id}/approve
Approve a supplier document
🔒 JWT
PATCH
/api/compliance/documents/{id}/reject
Reject a document — body: { "reason": "..." }
🔒 JWT