Catalog108 / API docs
API documentation
Interactive OpenAPI 3.0 spec for the Catalog108 REST surface, products, auth (System A/B/C), GraphQL, and the simulated WS/SSE shims.
Raw spec (OpenAPI 3.0 JSON) → /health sitemap.xml robots.txt
Quick endpoint references
/api/products
Paginated catalog (500 deterministic products, 12 per page).
GET/api/products/{id}
Product detail with brand, price, rating, stock.
GET/api/products/{id}/reviews
Paginated reviews per product.
GET/api/locations
Store list (15 cities). XHR backing the /locations map.
POST/api/auth/login
System B JWT, body: {email, password}.
/api/auth/refresh
Exchange refresh_token for a new access_token.
POST/api/graphql
GraphQL with introspection enabled. See the playground lab.
GET/api/ws/live-prices
Simulated WebSocket, poll every 3 seconds.
GET/api/sse/notifications
Server-Sent Events stream (one frame per request on shared hosting).
POST/oauth/token
System C OAuth 2.0 token endpoint (Authorization Code grant).
Interactive spec
Powered by Swagger UI, try every endpoint inline.