Costruisci uno storefront

# lista prodotti con filtri
curl "$BASE/api/v1/products?category_id=<id>&min_price=500&sort=-created_at&page=1&page_size=24"
# dettaglio per slug
curl "$BASE/api/v1/products/<slug>?lang=it"
# ricerca full-text con facet
curl "$BASE/api/v1/search?q=iphone&page=1"
# categorie (albero), brand
curl "$BASE/api/v1/categories?tree=true"

# crea/aggiorna carrello, aggiungi una variante
curl -X POST "$BASE/api/v1/cart/items" -H "Content-Type: application/json" \
  -d '{"variant_id":"<id>","quantity":1}'
# leggi il carrello (totali, spedizione stimata)
curl "$BASE/api/v1/cart"

# la risposta contiene { "data": { "session_token": "…", "items": [...] } }
# → salva session_token e rimandalo su ogni chiamata carrello + 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}'

# metodi di pagamento disponibili per il negozio
curl "$BASE/api/v1/settings/payment-methods"
# crea l'ordine
curl -X POST "$BASE/api/v1/checkout" -H "Content-Type: application/json" \
  -d '{ "email":"cliente@example.com", "shipping_address": { ... }, "payment_method":"stripe" }'

# ordini del cliente (autenticato)
curl "$BASE/api/v1/orders" -H "Authorization: Bearer $TOKEN"
# tracking di un ordine
curl "$BASE/api/v1/orders/<id>"