Storefront API (Public)

Base URL

https://api.ecommaps.com/api/v1/storefront

Primary Authentication

x-api-key: sk_eco_...

Endpoint Inventory (Contract Scope)

Store

• GET /store
• GET /store/menus
• GET /store/menus/{handle}

Products and Discovery

• GET /products
• GET /products/{slug}
• GET /search
• GET /product-categories

Collections

• GET /collections
• GET /collections/{slug}

Cart

• POST /cart
• GET /cart/{cart_id}
• POST /cart/{cart_id}/items
• PATCH /cart/{cart_id}/items/{item_id}
• DELETE /cart/{cart_id}/items/{item_id}

Orders

• POST /orders
• GET /orders
• GET /orders/track/{order_number}

Content

• GET /pages
• GET /pages/{slug}
• GET /blogs
• GET /blogs/{slug}

Promotions

• POST /coupons/validate

Customer Auth

• POST /auth/signup
• POST /auth/login
• GET /auth/me
• POST /auth/me/addresses
• PATCH /auth/me/addresses/{address_id}/default
• DELETE /auth/me/addresses/{address_id}

Response Model Notes

• List endpoints use pagination model where applicable (data + pagination).
• Contract fields follow backend Pydantic schemas and route implementations.
• Media URLs may be rewritten to the public CDN domain.

Error Model Baseline