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

# Introduction à l'API publique d'Upcart

> Découvrez comment démarrer avec l'API d'Upcart, ajouter des scripts, tester les modifications et personnaliser votre panier en toute simplicité.

L'**API publique Upcart** vous permet de personnaliser votre panier, d'automatiser des flux de travail et de vous intégrer à des applications tierces — que vous soyez développeur ou simplement débutant.\
Ce guide vous présente les bases et vous aide à commencer à créer des fonctionnalités personnalisées dans votre tiroir de panier.

👉 [Voir la documentation complète de l'API publique Upcart](https://rokt.notion.site/upcart-public-api)

***

<div id="overview">
  ## Aperçu
</div>

L'API publique est une collection de fonctions JavaScript et d'écouteurs d'événements qui vous permettent de :

* **Réagir aux changements du panier** — détecter quand des articles sont ajoutés, supprimés ou mis à jour.
* **Déclencher des actions** — comme ouvrir ou fermer le panier par programmation.
* **Créer des fonctionnalités personnalisées** — injecter votre propre logique ou vos composants d'interface directement dans le tiroir de panier.

Elle est particulièrement utile lorsque vous travaillez dans la section **Custom HTML** de l'éditeur Upcart, où vous pouvez utiliser ces fonctions pour créer des expériences uniques pour les acheteurs.

***

<div id="what-you-need-to-get-started">
  ## Ce dont vous avez besoin pour commencer
</div>

Avant d'utiliser l'API d'Upcart, assurez-vous d'avoir :

* **Accès à Upcart dans votre boutique Shopify**\
  Assurez-vous qu'Upcart est installé et actif dans votre boutique.
* **Une compréhension de base de JavaScript**\
  De nombreuses personnalisations utilisent des extraits de code prérédigés, mais connaître les bases de JavaScript est utile si vous souhaitez aller plus loin.

***

<div id="adding-your-first-upcart-api-script">
  ## Ajouter votre premier script d'API Upcart
</div>

Vous pouvez commencer à utiliser l'API directement depuis votre éditeur Upcart :

1. Allez dans **Upcart Editor → Settings → Custom HTML → Scripts (before load)**

2. Collez votre script — par exemple :

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

**Remarque :** les anciens exemples utilisant `window.upcartOnAddToCart` fonctionnent toujours mais sont obsolètes et affichent un avertissement dans la console. Utilisez `upcartSubscribeAddedToCart` pour tous les nouveaux scripts.

3. Enregistrez vos modifications, puis testez-les dans votre boutique :

* Ouvrez les outils de développement (`F12` ou `Ctrl + Shift + J` sous Windows, `Cmd + Option + J` sous Mac)
* Ajoutez un produit à votre panier
* Vérifiez l'onglet Console pour le message :\
  `"You just added [product title] to your cart!"`

🎉 Si vous voyez le message, votre premier script API fonctionne !

***

<div id="start-customizing-your-cart">
  ## Commencez à personnaliser votre panier
</div>

Maintenant que vous êtes prêt, vous pouvez utiliser l'API pour faire toutes sortes de choses intéressantes — comme ouvrir automatiquement le panier lorsque des articles sont ajoutés, mettre à jour des widgets personnalisés ou envoyer des événements d'analyse.

Pour les références complètes des fonctions et des exemples, consultez la **[documentation de l'API publique Upcart](https://rokt.notion.site/upcart-public-api)**.

***

<div id="more-resources">
  ## Ressources supplémentaires
</div>

* 🧩 **[FAQ sur l'API](/fr/upcart/upcart_api_frequently_asked_questions)** — Conseils de dépannage et questions courantes
* ⚙️ **[Utilisations courantes de l'API Upcart](/fr/upcart/common_upcart_api_uses)** — Exemples de code et modèles populaires
* 💡 **[Documentation de personnalisation](/fr/upcart/add_a_mandatory_terms_and_conditions_checkbox_to_your_cart)** — Scripts prérédigés pour vous aider à démarrer rapidement
* 🛍️ **[Documentation de l'API Cart de Shopify](https://shopify.dev/docs/api/ajax/reference/cart)** — Découvrez comment Shopify gère les données du panier en coulisses
* 👩💻 Besoin de personnalisations avancées ? Envisagez d'engager un [expert Shopify](https://www.shopify.com/ca/partners/directory/services/development-and-troubleshooting/custom-apps-integrations) pour des intégrations plus complexes.