> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aftersell.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduzione all'API pubblica di Upcart

> Scopri come iniziare con l'API di Upcart, aggiungere script, testare le modifiche e personalizzare il tuo carrello con facilità.

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](https://rokt.notion.site/upcart-public-api)

***

<div id="overview">
  ## Panoramica
</div>

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.

***

<div id="what-you-need-to-get-started">
  ## Cosa ti serve per iniziare
</div>

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.

***

<div id="adding-your-first-upcart-api-script">
  ## Aggiungere il tuo primo script API di Upcart
</div>

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:

```
<script>
  window.upcartSubscribeAddedToCart(function(event) {
    console.log("You just added " + event.item.title + " to your cart!");
  });
</script>
```

**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.

3. 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!

***

<div id="start-customizing-your-cart">
  ## Inizia a personalizzare il tuo carrello
</div>

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](https://rokt.notion.site/upcart-public-api)**.

***

<div id="more-resources">
  ## Altre risorse
</div>

* 🧩 **[FAQ sull'API](/it/upcart/upcart_api_frequently_asked_questions)** — Suggerimenti per la risoluzione dei problemi e domande comuni
* ⚙️ **[Usi comuni dell'API di Upcart](/it/upcart/common_upcart_api_uses)** — Esempi di codice popolari e template
* 💡 **[Documentazione sulle personalizzazioni](/it/upcart/add_a_mandatory_terms_and_conditions_checkbox_to_your_cart)** — Script già scritti per aiutarti a iniziare velocemente
* 🛍️ **[Documentazione dell'API Cart di Shopify](https://shopify.dev/docs/api/ajax/reference/cart)** — Scopri come Shopify gestisce i dati del carrello dietro le quinte
* 👩💻 Ti servono personalizzazioni avanzate? Considera di assumere uno [Shopify Expert](https://www.shopify.com/ca/partners/directory/services/development-and-troubleshooting/custom-apps-integrations) per integrazioni più complesse.