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

# Cos'è un'API?

> L'Application Programming Interface funge da intermediario che consente a diverse applicazioni software di interagire e scambiarsi dati.

<div id="a-simple-analogy-a-restaurant--a-waiter">
  # Un'analogia semplice: un ristorante e un cameriere
</div>

Immagina di cenare al ristorante.

1. **Tu, il cliente**, sfogli il menu e ordini un cheeseburger con patatine (come fare una richiesta di dati del carrello).
2. **Il cameriere (API)** prende il tuo ordine e lo comunica alla cucina (proprio come un'API riceve la tua richiesta e la invia a un server).
3. **La cucina (server)** prepara il tuo pasto, elaborando l'ordine e raccogliendo gli ingredienti necessari (in modo simile a come un server recupera o manipola i dati del carrello).
4. **Il cameriere (API)** poi consegna il pasto al tuo tavolo, permettendoti di gustarlo (proprio come un'API restituisce i dati richiesti e aggiorna il tuo carrello).

Questa analogia offre un modo semplice per capire come funzionano le API, soprattutto se sei alle prime armi. Quando usi l'API di Upcart, pensala come ordinare al ristorante: decidi cosa vuoi che faccia il carrello e lascia che l'API si occupi del resto.

Scopri come l'API di Upcart può migliorare il tuo negozio esplorando la nostra [documentazione API](/it/upcart/introduction_to_upcarts_public_api).

***

<div id="how-this-relates-to-upcarts-api">
  # Come tutto questo si collega all'API di Upcart
</div>

L'API pubblica di Upcart ti dà la flessibilità di personalizzare e gestire le funzionalità del carrello, proprio come dare istruzioni specifiche a un cameriere.

Ad esempio, se vuoi verificare che l'API di Upcart funzioni correttamente, puoi eseguire un semplice script nel tuo HTML personalizzato che registra un messaggio ogni volta che il carrello si apre:

```
<script>  
  window.upcartSubscribeCartOpened(() => {  
    console.log("UpCart API Test - The cart has been opened!");  
  });  
</script>
```

<div id="verifying-if-its-working">
  ## Verificare che funzioni
</div>

1. Apri il tuo negozio e vai su **Upcart Settings → Custom HTML** per aggiungere lo script.
2. Salva le modifiche e ricarica il negozio.
3. Apri la console del browser (**F12** o **Ctrl + Shift + J** su Windows, oppure **Cmd + Option + J** su Mac).
4. Apri il carrello di Upcart e dovresti vedere il messaggio di conferma apparire nella console:

```
Upcart API Test - The cart has been opened!
```

<img src="https://mintcdn.com/aftersell/uxKAdY-e0h16xa48/images/upcart/api-custom-html-test-script.png?fit=max&auto=format&n=uxKAdY-e0h16xa48&q=85&s=5df59c4ceee2ee520c39b5dd861c46ec" alt="Script di test in Custom HTML di Upcart che registra un messaggio di apertura del carrello nella console del browser" width="1472" height="1086" data-path="images/upcart/api-custom-html-test-script.png" />

***

<div id="want-to-learn-more-about-apis">
  ## Vuoi saperne di più sulle API?
</div>

Se ti interessa approfondire API e JavaScript, ecco alcune risorse adatte ai principianti per iniziare.

**Risorse per principianti su API e JavaScript:**

* [W3Schools: JavaScript Basics](https://www.w3schools.com/js/) – Impara le basi dello scripting per usare l'API di Upcart
* [MDN Web Docs: APIs for Beginners](https://developer.mozilla.org/en-US/docs/Learn/JavaScript/Client-side_web_APIs) – Comprendi come funzionano le API nei negozi online
* Documentazione per sviluppatori Shopify – [Shopify AJAX API](https://shopify.dev/docs/api/ajax) (utile per i merchant che integrano Upcart con il carrello di Shopify)

L'API di Upcart funziona senza problemi senza bisogno di strumenti esterni come Postman: puoi usarla direttamente nelle impostazioni Custom HTML di Upcart o nel codice del tuo tema Shopify

***

<div id="need-assistance">
  ## Ti serve assistenza?
</div>

Se sei alle prime armi con le API, nessun problema! Non devi scrivere JavaScript da zero: ti basta copiare e incollare script già pronti nelle impostazioni Custom HTML di Upcart per personalizzare il carrello in pochi minuti.

Non sai da dove iniziare? Rivolgiti a uno [Shopify Expert](https://www.shopify.com/partners/directory) oppure esplora la nostra [documentazione API](/it/upcart/introduction_to_upcarts_public_api).

***