Wprowadzenie do publicznego API Upcart

Publiczne API Upcart pozwala personalizować koszyk, automatyzować przepływy pracy i integrować się z aplikacjami zewnętrznymi — niezależnie od tego, czy jesteś deweloperem, czy dopiero zaczynasz.
Ten przewodnik przeprowadzi Cię przez podstawy i pomoże zacząć budować niestandardowe funkcje w Twoim cart drawer. 👉 Zobacz pełną dokumentację publicznego API Upcart

Omówienie

Publiczne API to zbiór funkcji JavaScript i nasłuchiwaczy zdarzeń, które pozwalają:

Reagować na zmiany w koszyku — wykrywać, kiedy pozycje są dodawane, usuwane lub aktualizowane.
Wywoływać akcje — na przykład programowo otwierać lub zamykać koszyk.
Budować niestandardowe funkcje — wstrzykiwać własną logikę lub komponenty UI bezpośrednio do cart drawer.

Jest to szczególnie przydatne podczas pracy w sekcji Custom HTML edytora Upcart, gdzie możesz używać tych funkcji do tworzenia unikalnych doświadczeń dla kupujących.

Co jest potrzebne na start

Zanim zaczniesz korzystać z API Upcart, upewnij się, że masz:

Dostęp do Upcart w swoim sklepie Shopify
Upewnij się, że Upcart jest zainstalowany i aktywny w Twoim sklepie.
Podstawową znajomość JavaScriptu
Wiele personalizacji korzysta z gotowych fragmentów kodu, ale znajomość podstaw JavaScriptu pomoże Ci, jeśli chcesz wyjść poza podstawy.

Dodawanie pierwszego skryptu API Upcart

Możesz zacząć korzystać z API bezpośrednio z edytora Upcart:

Przejdź do Upcart Editor → Settings → Custom HTML → Scripts (before load)
Wklej swój skrypt — na przykład:

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

Uwaga: starsze przykłady używające window.upcartOnAddToCart nadal działają, ale są przestarzałe i generują ostrzeżenie w konsoli. We wszystkich nowych skryptach używaj upcartSubscribeAddedToCart.

Zapisz zmiany, a następnie przetestuj je w swoim sklepie:

Otwórz narzędzia deweloperskie (F12 lub Ctrl + Shift + J w Windows, Cmd + Option + J na Macu)
Dodaj produkt do koszyka
Sprawdź zakładkę Console w poszukiwaniu komunikatu:
"You just added [product title] to your cart!"

🎉 Jeśli widzisz ten komunikat, Twój pierwszy skrypt API działa!

Zacznij personalizować swój koszyk

Teraz, gdy wszystko jest skonfigurowane, możesz używać API do robienia najróżniejszych ciekawych rzeczy — na przykład automatycznego otwierania koszyka po dodaniu produktów, aktualizowania niestandardowych widżetów czy wysyłania zdarzeń analitycznych. Pełną dokumentację funkcji i przykłady znajdziesz w dokumentacji publicznego API Upcart.

Więcej zasobów

🧩 FAQ dotyczące API — wskazówki dotyczące rozwiązywania problemów i częste pytania
⚙️ Typowe zastosowania API Upcart — popularne przykłady kodu i szablony
💡 Dokumentacja personalizacji — gotowe skrypty, które pomogą Ci szybko zacząć
🛍️ Dokumentacja Cart API Shopify — dowiedz się, jak Shopify obsługuje dane koszyka „za kulisami”
👩💻 Potrzebujesz zaawansowanych personalizacji? Rozważ zatrudnienie eksperta Shopify do bardziej złożonych integracji.

Pierwsze kroki

Moduły koszyka

Ustawienia koszyka

Przyklejony przycisk koszyka

Multicart

Personalizacje

Analityka

Integracje i kompatybilność

Rozliczenia i konto

Rozwiązywanie problemów

Omówienie

Co jest potrzebne na start

Dodawanie pierwszego skryptu API Upcart

Zacznij personalizować swój koszyk

Więcej zasobów

​Omówienie

​Co jest potrzebne na start

​Dodawanie pierwszego skryptu API Upcart

​Zacznij personalizować swój koszyk

​Więcej zasobów

Omówienie

Co jest potrzebne na start

Dodawanie pierwszego skryptu API Upcart

Zacznij personalizować swój koszyk

Więcej zasobów