Skip to main content
Mit der öffentlichen Upcart-API kannst du deinen Warenkorb anpassen, Workflows automatisieren und Drittanbieter-Apps integrieren — egal, ob du Entwickler bist oder gerade erst anfängst.
Diese Anleitung führt dich durch die Grundlagen und hilft dir, eigene Funktionen in deinem Cart Drawer zu entwickeln.
👉 Vollständige Dokumentation der öffentlichen Upcart-API ansehen

Überblick

Die öffentliche API ist eine Sammlung von JavaScript-Funktionen und Event-Listenern, mit denen du:
  • auf Warenkorb-Änderungen reagieren kannst — erkenne, wenn Artikel hinzugefügt, entfernt oder aktualisiert werden.
  • Aktionen auslösen kannst — zum Beispiel den Warenkorb programmatisch öffnen oder schließen.
  • eigene Funktionen entwickeln kannst — füge deine eigene Logik oder UI-Komponenten direkt im Cart Drawer ein.
Sie ist besonders hilfreich bei der Arbeit im Abschnitt Custom HTML des Upcart-Editors, wo du diese Funktionen nutzen kannst, um einzigartige Erlebnisse für Käufer zu schaffen.

Was du für den Einstieg brauchst

Bevor du die Upcart-API verwendest, stelle sicher, dass du Folgendes hast:
  • Zugriff auf Upcart in deinem Shopify-Store
    Stelle sicher, dass Upcart in deinem Store installiert und aktiv ist.
  • Ein grundlegendes Verständnis von JavaScript
    Viele Anpassungen verwenden vorgefertigte Snippets, aber grundlegende JavaScript-Kenntnisse helfen, wenn du über die Grundlagen hinausgehen möchtest.

Dein erstes Upcart-API-Skript hinzufügen

Du kannst die API direkt in deinem Upcart-Editor verwenden:
  1. Gehe zu Upcart Editor → Settings → Custom HTML → Scripts (before load)
  2. Füge dein Skript ein — zum Beispiel:
Hinweis: Ältere Beispiele mit window.upcartOnAddToCart funktionieren weiterhin, sind aber veraltet und erzeugen eine Konsolenwarnung. Verwende upcartSubscribeAddedToCart für alle neuen Skripte.
  1. Speichere deine Änderungen und teste sie dann in deinem Store:
  • Öffne die Dev Tools (F12 oder Ctrl + Shift + J unter Windows, Cmd + Option + J auf dem Mac)
  • Füge ein Produkt zu deinem Warenkorb hinzu
  • Prüfe im Tab „Console“, ob die Meldung erscheint:
    "You just added [product title] to your cart!"
🎉 Wenn du die Meldung siehst, funktioniert dein erstes API-Skript!

Beginne mit der Anpassung deines Warenkorbs

Jetzt, da alles eingerichtet ist, kannst du die API für alle möglichen coolen Dinge nutzen — zum Beispiel den Warenkorb automatisch öffnen, wenn Artikel hinzugefügt werden, benutzerdefinierte Widgets aktualisieren oder Analytics-Events senden. Vollständige Funktionsreferenzen und Beispiele findest du in der Dokumentation der öffentlichen Upcart-API.

Weitere Ressourcen