Ecommerce API Reference | Aegis Docs

Ecommerce API Reference

The standalone storefront: catalogue, cart, upsells, shipping, tax and checkout, served from shop.purdyandfigg.dev.

Restricted Access

Reads are public by design — the widget calls them cross-origin from landing pages. The catalogue write endpoints require ECOM_ADMIN_TOKEN as a Bearer token, and the Stripe webhook is authenticated by its signature.

Catalogue

GET /api/products View Details POST /api/products View Details DELE /api/products/:id View Details

Cart

POST /api/cart View Details POST /api/cart/:id/visitor View Details GET /api/cart/:id View Details POST /api/cart/:id/items View Details PATC /api/cart/:id/items/:productId View Details DELE /api/cart/:id/items/:productId View Details

Upsells

GET /api/cart/:id/upsells View Details POST /api/cart/:id/upsells/:upsellId View Details GET /api/orders/:id/upsells View Details POST /api/orders/:id/upsells/:upsellId View Details

Shipping & Destinations

POST /api/shipping/rates View Details GET /api/shipping/destinations View Details

Customer Sign-in

POST /api/customer/authorize View Details POST /api/customer/session View Details

Checkout & Payment

POST /api/checkout View Details POST /api/checkout/:orderId/confirm View Details POST /api/webhooks/stripe View Details

Storefront & Health

POST /api/refunds/sync View Details GET /health View Details

Orders

GET /api/orders/:id View Details