Skip to main content
L’API pubblica di Upcart ti permette di personalizzare il tuo carrello, automatizzare i flussi di lavoro e integrarti con app di terze parti — che tu sia uno sviluppatore o alle prime armi.
Questa guida ti accompagnerà attraverso le basi e ti aiuterà a iniziare a costruire funzionalità personalizzate all’interno del tuo cart drawer. 👉 Vedi la documentazione completa dell’API pubblica di Upcart

​
Panoramica

L’API pubblica è una raccolta di funzioni JavaScript ed event listener che ti permettono di:
  • Reagire ai cambiamenti del carrello — rilevare quando gli articoli vengono aggiunti, rimossi o aggiornati.
  • Attivare azioni — come aprire o chiudere il carrello in modo programmatico.
  • Costruire funzionalità personalizzate — inserire la tua logica o componenti UI direttamente all’interno del cart drawer.
È particolarmente utile quando lavori nella sezione Custom HTML dell’editor di Upcart, dove puoi usare queste funzioni per creare esperienze uniche per i clienti.

​
Cosa ti serve per iniziare

Prima di usare l’API di Upcart, assicurati di avere:
  • Accesso a Upcart nel tuo negozio Shopify
    Verifica che Upcart sia installato e attivo nel tuo negozio.
  • Una comprensione di base di JavaScript
    Molte personalizzazioni usano snippet già scritti, ma conoscere le basi di JavaScript aiuta se vuoi andare oltre.

​
Aggiungere il tuo primo script API di Upcart

Puoi iniziare a usare l’API direttamente dal tuo editor di Upcart:
  1. Vai su Upcart Editor → Settings → Custom HTML → Scripts (before load)
  2. Incolla il tuo script — per esempio:
Nota: gli esempi più vecchi che usano window.upcartOnAddToCart funzionano ancora ma sono deprecati e generano un avviso nella console. Usa upcartSubscribeAddedToCart per tutti i nuovi script.
  1. Salva le modifiche, poi testale nel tuo negozio:
  • Apri i Dev Tools (F12 o Ctrl + Shift + J su Windows, Cmd + Option + J su Mac)
  • Aggiungi un prodotto al carrello
  • Controlla la scheda Console per il messaggio:
    "You just added [product title] to your cart!"
🎉 Se vedi il messaggio, il tuo primo script API funziona!

​
Inizia a personalizzare il tuo carrello

Ora che sei pronto, puoi usare l’API per fare ogni sorta di cose interessanti — come aprire automaticamente il carrello quando vengono aggiunti articoli, aggiornare widget personalizzati o inviare eventi di analytics. Per i riferimenti completi delle funzioni e gli esempi, consulta la documentazione dell’API pubblica di Upcart.

​
Altre risorse