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

# Czym jest API?

> Application Programming Interface (interfejs programowania aplikacji) służy jako pośrednik umożliwiający różnym aplikacjom interakcję i wymianę danych.

<div id="a-simple-analogy-a-restaurant-a-waiter">
  # Prosta analogia: restauracja i kelner
</div>

Wyobraź sobie, że jesteś w restauracji.

1. **Ty, klient**, przeglądasz menu i składasz zamówienie na cheeseburgera z frytkami (podobnie jak wysyłanie żądania o dane koszyka).
2. **Kelner (API)** przyjmuje Twoje zamówienie i przekazuje je do kuchni (tak jak API odbiera Twoje żądanie i wysyła je do serwera).
3. **Kuchnia (serwer)** przygotowuje Twój posiłek, przetwarzając zamówienie i gromadząc potrzebne składniki (podobnie jak serwer pobiera lub modyfikuje dane koszyka).
4. **Kelner (API)** dostarcza posiłek do Twojego stolika, dzięki czemu możesz cieszyć się jedzeniem (tak jak API zwraca żądane dane i aktualizuje Twój koszyk).

Ta analogia to prosty sposób na zrozumienie, jak działają API, zwłaszcza jeśli dopiero je poznajesz. Korzystając z API Upcart, myśl o tym jak o zamawianiu w restauracji — zdecyduj, co koszyk ma zrobić, a resztą zajmie się API.

Odkryj, jak API Upcart może ulepszyć Twój sklep, zaglądając do naszej [dokumentacji API](/pl/upcart/introduction_to_upcarts_public_api).

***

<div id="how-this-relates-to-upcarts-api">
  # Jak to się ma do API Upcart
</div>

Publiczne API Upcart daje Ci elastyczność w personalizowaniu i zarządzaniu funkcjonalnością koszyka, podobnie jak przekazywanie konkretnych instrukcji kelnerowi.

Na przykład, jeśli chcesz sprawdzić, czy API Upcart działa poprawnie, możesz uruchomić prosty skrypt w swoim niestandardowym HTML, który zapisuje komunikat za każdym razem, gdy koszyk się otwiera:

```
<script>  
  window.upcartSubscribeCartOpened(() => {  
    console.log("UpCart API Test - The cart has been opened!");  
  });  
</script>
```

<div id="verifying-if-its-working">
  ## Sprawdzanie, czy to działa
</div>

1. Otwórz swój sklep i przejdź do **Upcart Settings → Custom HTML**, aby dodać skrypt.
2. Zapisz zmiany i odśwież sklep.
3. Otwórz konsolę przeglądarki (**F12** lub **Ctrl + Shift + J** w Windows albo **Cmd + Option + J** na Macu).
4. Otwórz koszyk Upcart — w konsoli powinien pojawić się komunikat potwierdzający:

```
Upcart API Test - The cart has been opened!
```

<img src="https://mintcdn.com/aftersell/uxKAdY-e0h16xa48/images/upcart/api-custom-html-test-script.png?fit=max&auto=format&n=uxKAdY-e0h16xa48&q=85&s=5df59c4ceee2ee520c39b5dd861c46ec" alt="Testowy skrypt Custom HTML Upcart zapisujący komunikat o otwarciu koszyka w konsoli przeglądarki" width="1472" height="1086" data-path="images/upcart/api-custom-html-test-script.png" />

***

<div id="want-to-learn-more-about-apis">
  ## Chcesz dowiedzieć się więcej o API?
</div>

Jeśli chcesz zgłębić temat API i JavaScriptu, oto kilka przyjaznych dla początkujących materiałów na start.

**Nauka API i JavaScriptu dla początkujących:**

* [W3Schools: JavaScript Basics](https://www.w3schools.com/js/) – Naucz się podstaw skryptowania, aby korzystać z API Upcart
* [MDN Web Docs: APIs for Beginners](https://developer.mozilla.org/en-US/docs/Learn/JavaScript/Client-side_web_APIs) – Zrozum, jak działają API w sklepach internetowych
* Dokumentacja deweloperska Shopify – [Shopify AJAX API](https://shopify.dev/docs/api/ajax) (przydatna dla sprzedawców integrujących Upcart z koszykiem Shopify)

API Upcart działa bezproblemowo bez potrzeby zewnętrznych narzędzi takich jak Postman — możesz go używać bezpośrednio w ustawieniach Custom HTML Upcart lub w kodzie motywu Shopify

***

<div id="need-assistance">
  ## Potrzebujesz pomocy?
</div>

Jeśli dopiero poznajesz API, nie martw się! Nie musisz pisać JavaScriptu od zera — po prostu skopiuj i wklej gotowe skrypty do ustawień Custom HTML Upcart, aby spersonalizować swój koszyk w kilka minut.

Nie wiesz, od czego zacząć? Skontaktuj się z [ekspertem Shopify](https://www.shopify.com/partners/directory) lub zajrzyj do naszej [dokumentacji API](/pl/upcart/introduction_to_upcarts_public_api).

***