Guida introduttiva a YOUCART
Come iniziare a usare il tuo abbonamento, passo dopo passo: cosa ricevi dopo l'attivazione, come autenticarti e come gestire catalogo, carrello, ordini e promozioni. Questa guida riflette lo stato reale della piattaforma oggi.
1 Cosa ricevi dopo l'attivazione
Quando attivi un piano, il nostro team configura per te un ambiente dedicato:
Cosa ti forniamo
- ✓ Un database dedicato, non condiviso con altri clienti
- ✓ Un dominio configurato con certificato SSL
- ✓ Un account amministratore con email e password
- ✓ L'indirizzo base delle API del tuo negozio
Nei piani Enterprise
- ✓ Una sessione guidata di configurazione iniziale
- ✓ Un referente dedicato per l'assistenza
2 Come si usa YOUCART oggi
Collegare il tuo sito o la tua app
Se hai già (o vuoi costruire) un sito o un'app, il tuo sviluppatore può collegarla direttamente alle API di YOUCART — sono lo stesso strumento che useremmo noi per costruire un frontend.
Farti seguire dal nostro team
Se non hai uno sviluppatore, scrivici: nei piani Business ed Enterprise possiamo occuparci noi di popolare il catalogo, configurare categorie e promozioni per tuo conto.
3 Autenticazione: registrazione e login
Ogni persona che accede al negozio (tu come amministratore, o un tuo cliente) si registra e accede con email e password. Il sistema restituisce un token di sessione valido 30 minuti, da usare per le richieste successive.
# Login curl -X POST https://tuonegozio.it/api/v1/auth/login \ -H "Content-Type: application/json" \ -d '{"email":"admin@tuonegozio.it","password":"..."}' # La risposta contiene un token da usare così: curl https://tuonegozio.it/api/v1/auth/me \ -H "Authorization: Bearer <token>"
4 Gestire catalogo e categorie
Il catalogo prodotti e le categorie sono già consultabili pubblicamente — utili per verificare subito cosa vedono i tuoi clienti:
# Vedere tutti i prodotti pubblicati curl https://tuonegozio.it/api/v1/youcart/prodotti # Cercare un prodotto curl "https://tuonegozio.it/api/v1/youcart/prodotti/ricerca?q=laptop" # Vedere l'albero delle categorie curl https://tuonegozio.it/api/v1/youcart/categorie
5 Carrello per i tuoi clienti
Il carrello funziona automaticamente per i visitatori del tuo sito: quando un cliente aggiunge un prodotto, il sistema ricorda il contenuto del carrello per 30 giorni, anche se il cliente non si è ancora registrato.
# Aggiungere un prodotto al carrello curl -X POST https://tuonegozio.it/api/v1/youcart/carrello/items \ -H "Content-Type: application/json" \ -d '{"articolo_id":"...","quantita":2}' # Vedere il contenuto del carrello curl https://tuonegozio.it/api/v1/youcart/carrello
6 Ordini e storico acquisti
Una volta autenticato, un cliente può trasformare il proprio carrello in un ordine e consultare lo storico dei propri acquisti.
# Creare un ordine (richiede login) curl -X POST https://tuonegozio.it/api/v1/youcart/ordini \ -H "Authorization: Bearer <token>" # Vedere i propri ordini curl https://tuonegozio.it/api/v1/youcart/ordini \ -H "Authorization: Bearer <token>"
7 Creare una promozione
Come amministratore puoi creare sconti e campagne. L'applicazione automatica dello sconto in carrello è in arrivo — oggi la promozione è visibile e gestibile, l'applicazione a un ordine specifico può essere seguita insieme al supporto.
# Creare uno sconto del 15% (richiede account amministratore)
curl -X POST https://tuonegozio.it/api/v1/youcart/admin/promozioni \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '{"nome":"Sconto Benvenuto","tipo":"single_discount","regole":{"sconto_perc":15}}'
8 Verificare lo stato del servizio
Un endpoint pubblico ti permette di controllare in ogni momento se il tuo negozio è raggiungibile e collegato correttamente al database.
curl https://tuonegozio.it/api/v1/health
# Risposta attesa:
{"success":true,"data":{"status":"ok","db":true}}
9 Assistenza e supporto
Qualunque sia il tuo piano, siamo raggiungibili via email. I piani Business ed Enterprise hanno canali prioritari, come descritto nella pagina Prezzi.