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

# Wprowadzenie do publicznego API Upcart

> Dowiedz się, jak zacząć korzystać z API Upcart, dodawać skrypty, testować zmiany i z łatwością personalizować koszyk.

**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](https://rokt.notion.site/upcart-public-api)

***

<div id="overview">
  ## Omówienie
</div>

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.

***

<div id="what-you-need-to-get-started">
  ## Co jest potrzebne na start
</div>

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.

***

<div id="adding-your-first-upcart-api-script">
  ## Dodawanie pierwszego skryptu API Upcart
</div>

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

1. Przejdź do **Upcart Editor → Settings → Custom HTML → Scripts (before load)**

2. 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`.

3. 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!

***

<div id="start-customizing-your-cart">
  ## Zacznij personalizować swój koszyk
</div>

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](https://rokt.notion.site/upcart-public-api)**.

***

<div id="more-resources">
  ## Więcej zasobów
</div>

* 🧩 **[FAQ dotyczące API](/pl/upcart/upcart_api_frequently_asked_questions)** — wskazówki dotyczące rozwiązywania problemów i częste pytania
* ⚙️ **[Typowe zastosowania API Upcart](/pl/upcart/common_upcart_api_uses)** — popularne przykłady kodu i szablony
* 💡 **[Dokumentacja personalizacji](/pl/upcart/add_a_mandatory_terms_and_conditions_checkbox_to_your_cart)** — gotowe skrypty, które pomogą Ci szybko zacząć
* 🛍️ **[Dokumentacja Cart API Shopify](https://shopify.dev/docs/api/ajax/reference/cart)** — dowiedz się, jak Shopify obsługuje dane koszyka „za kulisami”
* 👩💻 Potrzebujesz zaawansowanych personalizacji? Rozważ zatrudnienie [eksperta Shopify](https://www.shopify.com/ca/partners/directory/services/development-and-troubleshooting/custom-apps-integrations) do bardziej złożonych integracji.