Skip to main content
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

​
Aperçu

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.

​
Ce dont vous avez besoin pour commencer

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.

​
Ajouter votre premier script d’API Upcart

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 :
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.
  1. 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 !

​
Commencez à personnaliser votre panier

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.

​
Ressources supplémentaires