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

# Najczęściej zadawane pytania o API Upcart

> Znajdź odpowiedzi na najczęstsze pytania dotyczące korzystania z API Upcart, w tym konfiguracji, rozwiązywania problemów i integracji z aplikacjami firm trzecich.

<div id="overview">
  # Przegląd
</div>

Oto odpowiedzi na najczęstsze pytania dotyczące korzystania z API Upcart.

* **[Gdzie dodawać skrypty API Upcart?](#where-to-add-upcart-api-scripts)**
* **[Czy muszę być programistą, aby korzystać z API Upcart?](#do-i-need-to-be-a-developer-to-use-upcarts-api)**
* **[Czy API Upcart może integrować się z innymi aplikacjami firm trzecich?](#can-upcarts-api-integrate-with-other-third-party-apps)**
* **[Jak sprawdzić, czy moje zmiany w API działają?](#how-do-i-test-if-my-api-changes-are-working)**
* **[Co zrobić, jeśli skrypt API nie działa?](#what-should-i-do-if-an-api-script-isnt-working)**
* **[Jak cofnąć zmiany, jeśli dodam skrypt, który coś psuje?](#how-do-i-undo-changes-if-i-add-a-script-that-breaks-something)**

***

<div id="where-to-add-upcart-api-scripts">
  ## **Gdzie dodawać skrypty API Upcart?**
</div>

Skrypty możesz dodawać w ustawieniach Custom HTML w Upcart lub bezpośrednio w kodzie motywu Shopify. Najlepsza opcja zależy od Twoich potrzeb personalizacji.

<div id="how-do-i-use-upcarts-custom-html">
  ## Jak korzystać z Custom HTML w Upcart?
</div>

1. Przejdź do **Upcart → Settings → Custom HTML**
2. Używaj skryptów API, aby modyfikować zachowanie koszyka, np. moment otwarcia czy wyświetlanie upselli
3. Dostosowuj elementy poza Upcart, np. ukrywanie przycisków na stronie produktu

<div id="example-hide-the-sticky-cart-button-when-the-cart-is-empty">
  #### 💡 *Przykład: Ukryj przyklejony przycisk koszyka, gdy koszyk jest pusty*
</div>

```
<script>  
  window.upcartSubscribeCartLoaded((event) => {  
    const itemCount = event.cart.items.reduce((total, item) => total + item.quantity, 0);  
    document.querySelector("#upCartStickyButton").style.display = itemCount === 0 ? "none" : "block";  
    console.log("Sticky Cart is hiding!");  
  });  
</script>
```

<Note>
  **Uwaga dotycząca starszych wersji:** wywołania zwrotne `window.upcartOnCartLoaded` nadal działają, ale są przestarzałe i wyświetlają ostrzeżenia w konsoli. We wszystkich nowych skryptach używaj `upcartSubscribeCartLoaded`. Pamiętaj, że `event.cart` nie ma właściwości `item_count` — użyj `event.cart.items.reduce((total, item) => total + item.quantity, 0)`, aby obliczyć łączną liczbę produktów.
</Note>

***

<div id="do-i-need-to-be-a-developer-to-use-upcarts-api">
  # **Czy muszę być programistą, aby korzystać z API Upcart?**
</div>

Nie! API Upcart jest łatwe w użyciu, nawet bez umiejętności programowania. Wiele funkcji jest wbudowanych, a nasza [dokumentacja personalizacji](/pl/upcart/add_a_mandatory_terms_and_conditions_checkbox_to_your_cart) zawiera gotowe skrypty, które możesz skopiować do ustawień Custom HTML w Upcart — bez kodowania!

Jeśli chcesz pisać własne skrypty, przyda się podstawowa znajomość JavaScript. Jeśli dopiero zaczynasz z JavaScript, nie martw się! Te przyjazne dla początkujących zasoby — **W3Schools** i **[MDN Web Docs](https://developer.mozilla.org/en-US/docs/Web/JavaScript)** — pomogą Ci wystartować.

***

<div id="can-upcarts-api-integrate-with-other-third-party-apps">
  # Czy API Upcart może integrować się z innymi aplikacjami firm trzecich?
</div>

Tak! API Upcart współpracuje z aplikacjami do tłumaczeń, analityki, upselli i nie tylko. Niektóre integrują się automatycznie, inne mogą wymagać krótkiego skryptu.

Na przykład, jeśli używasz **[TripleWhale](https://kb.triplewhale.com/en/articles/6610178-adding-the-triple-pixel-to-third-party-checkouts#h_eccf979512)** do śledzenia, musisz dodać poniższy skrypt, aby aktywność koszyka była rejestrowana poprawnie:

```
<script>  
window.upcartSubscribeAddedToCart((event) => {  
	window.TriplePixel('AddToCart', {item: event.item.variantId, q: event.item.quantityAdded});  
});  
</script>
```

<Note>
  **Uwaga dotycząca starszych wersji:** wywołania zwrotne `window.upcartOnAddToCart` nadal działają, ale są przestarzałe i wyświetlają ostrzeżenia w konsoli. We wszystkich nowych skryptach używaj `upcartSubscribeAddedToCart`. Pamiętaj, że właściwości zdarzenia znajdują się w `event.item` (z `variantId` i `quantityAdded`), a nie są przekazywane jako osobne parametry.
</Note>

Ponieważ każda aplikacja jest inna, skonsultuj się z zespołem wsparcia swojej aplikacji, aby sprawdzić, czy potrzebny jest dodatkowy kod. Upcart nie oferuje wsparcia dla skryptów aplikacji firm trzecich, ale dostawca Twojej aplikacji może mieć przewodnik integracji.

***

<div id="how-do-i-test-if-my-api-changes-are-working">
  # Jak sprawdzić, czy moje zmiany w API działają?
</div>

Po dodaniu skryptu w ustawieniach Custom HTML w Upcart wykonaj poniższe kroki, aby upewnić się, że działa:

1. **Odśwież swój sklep** i dodaj produkt do koszyka.

2. **Wyczyść pamięć podręczną** i spróbuj ponownie, aby zobaczyć najnowsze zmiany.

3. **Dodaj komunikat testowy**: Wstaw `console.log("The script works!");` przed `</script>`, aby sprawdzić, czy skrypt się uruchamia.

4. Sprawdź konsolę przeglądarki:

   * Otwórz **Dev Tools** (`F12` lub `Ctrl + Shift + J` w Windows, `Cmd + Option + J` na Macu).
   * Przejdź do karty **Console** i poszukaj komunikatu **„The script works!”**
   * Jeśli widzisz komunikat, Twój skrypt działa! Jeśli nie, skrypt może nie wykonywać się poprawnie.

5. **Przetestuj różne działania** (np. usunięcie produktu), aby upewnić się, że zachowanie jest zgodne z oczekiwaniami.

**Rozwiązuj problemy**, sprawdzając literówki lub błędy w konsoli i w razie potrzeby poprawiając kod.

***

<div id="what-should-i-do-if-an-api-script-isnt-working">
  # Co zrobić, jeśli skrypt API nie działa?
</div>

Jeśli Twój skrypt API nie działa, wypróbuj te kroki rozwiązywania problemów:

* **Sprawdź literówki** – Nawet drobne błędy mogą zepsuć skrypt. Poszukaj brakujących znaków lub nieprawidłowej składni.

* **Zweryfikuj umiejscowienie skryptu** – Upewnij się, że skrypt znajduje się we właściwej sekcji w Upcart → Settings → Custom HTML. Upcart ma dziesięć sekcji skryptów (dziewięć punktów wstrzykiwania HTML plus jedną sekcję Scripts-before-load) — [Przejrzyj te sekcje tutaj.](/pl/upcart/custom_html)

* **Sprawdź konsolę przeglądarki** – Wykonaj powyższe kroki, aby poszukać błędów.

* **Przetestuj inny skrypt** – Wypróbuj inny gotowy skrypt API Upcart, aby sprawdzić, czy problem leży w Twoim kodzie.

* **Nadal utknęło?** – Jeśli modyfikujesz motyw Shopify lub integrujesz aplikacje firm trzecich, pomóc może ekspert Shopify z [katalogu partnerów Shopify](https://www.shopify.com/partners/directory).

Te kroki powinny pomóc Ci zidentyfikować i rozwiązać większość problemów ze skryptami!

***

<div id="how-do-i-undo-changes-if-i-add-a-script-that-breaks-something">
  # Jak cofnąć zmiany, jeśli dodam skrypt, który coś psuje?
</div>

Jeśli dodasz skrypt, który nie działa zgodnie z oczekiwaniami, możesz go **łatwo usunąć lub wyłączyć**:

* **Przejdź do ustawień Custom HTML w Upcart**, gdzie skrypt został dodany.

* **Usuń skrypt** lub tymczasowo go wyłącz, dodając `//` na początku każdej linii (zamienia to linię w komentarz, co zapobiega jej wykonaniu).

* **Zapisz zmiany i odśwież sklep**, aby sprawdzić, czy problem został rozwiązany.

Jeśli problem się utrzymuje, spróbuj wyczyścić pamięć podręczną lub cofnąć ostatnie zmiany w motywie — to często rozwiązuje ukryte konflikty.

***

🚧 **Szukasz zaawansowanych personalizacji?**

Potrzebujesz personalizacji obejmującej cały sklep lub integracji z aplikacjami firm trzecich? Możesz potrzebować programisty, który doda API Upcart do Twojego motywu Shopify.

Rozważ zatrudnienie eksperta Shopify przez **[katalog partnerów Shopify](https://www.shopify.com/partners/directory)** i udostępnij mu naszą [dokumentację API](/pl/upcart/introduction_to_upcarts_public_api), aby uzyskać pomoc