Build a storefront

# list products with filters
curl "$BASE/api/v1/products?category_id=<id>&min_price=500&sort=-created_at&page=1&page_size=24"
# detail by slug
curl "$BASE/api/v1/products/<slug>?lang=it"
# full-text search with facets
curl "$BASE/api/v1/search?q=iphone&page=1"
# categories (tree), brands
curl "$BASE/api/v1/categories?tree=true"

# create/update cart, add a variant
curl -X POST "$BASE/api/v1/cart/items" -H "Content-Type: application/json" \
  -d '{"variant_id":"<id>","quantity":1}'
# read the cart (totals, estimated shipping)
curl "$BASE/api/v1/cart"

# the response contains { "data": { "session_token": "…", "items": [...] } }
# → store session_token and send it back on every cart call + checkout:
curl -X POST "$BASE/api/v1/cart/items" \
  -H "X-Vellaro-Key: cx_pk_live_<slug>_..." \
  -H "X-Cart-Token: <session_token>" \
  -H "Content-Type: application/json" \
  -d '{"variant_id":"<id>","quantity":1}'

# payment methods available for the store
curl "$BASE/api/v1/settings/payment-methods"
# create the order
curl -X POST "$BASE/api/v1/checkout" -H "Content-Type: application/json" \
  -d '{ "email":"cliente@example.com", "shipping_address": { ... }, "payment_method":"stripe" }'

# customer's orders (authenticated)
curl "$BASE/api/v1/orders" -H "Authorization: Bearer $TOKEN"
# tracking for an order
curl "$BASE/api/v1/orders/<id>"