# Zastosowania API do e-commerce: siedem rozwiązań, których nie zrobisz widżetem

> Kiedy widżet sklepu to nie to, czego potrzebujesz: osadzony commerce w SaaS, katalogi na wielu kanałach, sklepy white-label, własny UX, agenci AI i własne raporty BI. Do tego przykłady kodu z Shoprocket JS SDK.

Ryan Badger - 4 sierpnia 2025 - 5 min czytania

## Do czego służy API e-commerce do osadzania

Większość platform e-commerce daje Ci widżet. Wklejasz skrypt, dostajesz sklep. Dla 95% sklepów to działa świetnie.

Po API commerce sięgasz wtedy, gdy chcesz zrobić coś, czego widżet nie potrafi: wyświetlić produkty we własnym interfejsie, osadzić kasę w panelu SaaS, rozdystrybuować katalog na wiele kanałów (web + mobile + głos) albo zbudować własne ścieżki zakupowe, jakich żadna platforma nie dostarcza z pudełka.

Shoprocket oferuje jedno i drugie. [Widżet](https://v3.shoprocket.io/pl/blog/headless-commerce-trzy-poziomy-realne-opcje-co-wybrac.md) jest domyślny. [`@shoprocket/core` SDK](https://github.com/shoprocket/shoprocket-js) to opcja na moment, gdy z widżetu wyrośniesz albo nigdy go nie potrzebowałeś.

## Zastosowania, które wymagają API, a nie widżetu

To projekty, w których widżet nie wystarczy. Jeśli Twój pomysł jest na tej liście, wchodzisz na teren API.

### 1. Sprzedaż wewnątrz Twojego produktu SaaS

Twój panel SaaS ma już własny interfejs. Chcesz, żeby klienci kupowali dodatki, pakiety kredytów, droższe plany albo fizyczne gadżety bez wychodzenia z aplikacji.

Widżet miałby tu zły kształt: nie zna Twoich użytkowników, nie pasuje do Twojego systemu projektowego i zakłada sklep na całą stronę. API pozwala wyrenderować karty produktów własnymi komponentami, wywołać `cart.addItem()` po kliknięciu przycisku i wyświetlić własny panel kasy (albo przekierować do hostowanej kasy, jeśli wolisz odłożyć kwestie zgodności z przepisami).

```
import { ShoprocketCore } from '@shoprocket/core'

const sr = new ShoprocketCore({ publicKey: 'pk_...' })

// Wyrenderuj kafelki dodatków w panelu SaaS
const addons = await sr.products.list({ category: 'addons' })

// Użytkownik klika przycisk "Dodaj kredyty"
await sr.cart.addItem(addon.id, 1)
```

### 2. Katalog na wielu kanałach (web + aplikacja natywna + głos + czat)

Jeden katalog produktów, w każdym miejscu pokazany inaczej. Sklep w przeglądarce pokazuje pełne szczegóły produktu, natywna aplikacja na iOS zwartą listę, asystent głosowy opisuje przedmioty na głos, a integracja czatu odpowiada linkiem do zakupu.

Wszystkie cztery kanały korzystają z tego samego API. Gdy zmienisz cenę produktu w panelu Shoprocket, każdy kanał pokaże ją przy następnym pobraniu danych. Bez synchronizacji treści osobno dla każdego kanału.

### 3. Sklepy white-label i sklepy partnerów

Jesteś platformą, na której inni sprzedają swoje towary: targowisko społeczności, katalog partnerów, sieć franczyzowa z osobnymi stronami dealerów. Każdy partner ma własny branding, nie Twój.

Strona każdego partnera działa na Twoim frameworku, ale łączy się z API commerce przy użyciu jego `publicKey`. Jego produkty, jego zamówienia, jego wypłaty, wszystko oddzielone w obrębie konta. Żaden widżet nie wchodzi w drogę jego brandingowi.

### 4. W pełni własny UX kupującego

Interaktywne konfiguratory produktów (komputery składane na zamówienie, spersonalizowana biżuteria, meble robione na wymiar). Przeglądarki produktów 3D. Galerie zdjęć typu "kup to wnętrze", w których kliknięcie punktu na obrazie dodaje produkt do koszyka. Przyciski szybkiego ponowienia zamówienia w e-mailu.

Widżet nie zrobi żadnej z tych rzeczy. API tak. Renderujesz dowolny interfejs, który wymyślił Twój projektant, a API zajmuje się mechaniką sprzedaży w tle.

### 5. Agenci AI i handel agentowy

Agent AI (ChatGPT, Claude, własny agent), który potrafi przeglądać produkty i finalizować zakupy w imieniu użytkownika. Taki agent potrzebuje programistycznego dostępu do Twojego katalogu i koszyka, a nie widżetu DOM, który musiałby parsować.

Shoprocket udostępnia feedy dla protokołów commerce dla AI obok standardowego dostępu przez API. Agent zapytany "co jest dostępne poniżej 50 dolarów z darmową wysyłką" dostaje uporządkowaną odpowiedź, a nie scrapowanie ekranu.

### 6. Osadzony commerce w narzędziach do treści

Strona w Notion, na której bloki można kupić. Projekt we Framer z punktami "kliknij, by kupić". Narzędzie do newsletterów, w którym subskrybent może dotknąć karty produktu i zapłacić bez wychodzenia z e-maila. Wszystko zbudowane na API.

### 7. Własne raporty i dashboardy BI

Panel Shoprocket pokazuje przychód, konwersję i najlepsze produkty. Nie pokazuje *Twoich* własnych metryk: wartości klienta w czasie (LTV) według kohort, zamówień według źródła polecenia, marży po odliczeniu kosztu dostawcy. API udostępnia dane zamówień i klientów, więc możesz przesłać je do własnego narzędzia BI, arkusza albo wewnętrznego dashboardu.

## Co SDK daje dziś

Z `@shoprocket/core`:

```
// Products
sr.products.list({ limit, offset, sort, category })
sr.products.get(productId)

// Cart
sr.cart.get()
sr.cart.addItem(productId, quantity)
sr.cart.updateItem(itemId, quantity)
sr.cart.removeItem(itemId)

// Session
sr.session.create()
sr.setSessionToken(token)
```

Do tego pełne REST API na wszystko, czego SDK jeszcze nie obejmuje (zamówienia, klienci, rabaty, zapis produktów). Pełną dokumentację znajdziesz pod adresem [api.shoprocket.io/docs](https://api.shoprocket.io/docs).

## Gdzie podejście API-first to błąd

Kilka przypadków, w których właściwym wyborem jest widżet, a API to przesada:

- **Prosty sklep z 10-200 produktami.** Widżet wyrenderuje to doskonale; pisanie własnego interfejsu katalogu to robienie od nowa rzeczy już rozwiązanej.
- **Nie masz mocy frontendowych na własny zespół.** API-first oznacza dostarczanie i utrzymywanie własnych stanów ładowania, interfejsu wariantów, obsługi błędów, dostępności i internacjonalizacji (i18n) w 21 językach. To tygodnie pracy, które widżet daje Ci za darmo.
- **Najważniejsza jest szybkość startu.** Widżet to minuty; API-first to minimum kilka tygodni.

Domyślnie wybieraj widżet. Po API sięgaj, gdy trafisz na coś, czego widżet nie potrafi.

## Realistyczny pierwszy projekt

Najczęstszy projekt typu "potrzebuję API": produkt SaaS, który chce sprzedawać kredyty, subskrypcje lub jednorazowe dodatki wewnątrz własnego panelu.

Podejście:

1. Zainstaluj `@shoprocket/core` w swoim frontendzie
2. Utwórz w Shoprocket kategorię o nazwie "Dodatki" lub podobnej
3. Dodaj produkty z dokładnie taką ceną i opisem, jakie chcesz
4. Wyświetl listę produktów w swoim panelu, używając własnej biblioteki komponentów
5. Po kliknięciu dodaj do koszyka i przekieruj do hostowanej kasy Shoprocket (albo osadź kasę bezpośrednio, jeśli jesteś gotowy na dodatkową pracę)
6. Skonfiguruj endpoint webhooka, który odbierze zdarzenia `order.paid`, żebyś mógł uruchomić to, co zakup odblokowuje (kredyty, dostęp, wysyłkę)

To wszystko. Garść plików i dzień pracy dla kogoś, kto jest przyzwyczajony do wywoływania API. Bez widżetu, bez iframe, bez kompromisów w interfejsie Twojego produktu.

## Czego nie polecamy

Nie buduj od zera pełnego interfejsu katalogu, który mocno przypomina to, co widżet już robi. Jeśli spędzasz tygodnie nad "siatką produktów z filtrami i wyszukiwarką", piszesz to, co widżet dostarcza w kilka minut. Do takiego kształtu użyj widżetu, a API zostaw na kształty naprawdę inne.

> **Wskazówka:** Jeśli myślisz o API-first, bo domyślny wygląd widżetu nie pasuje do Twojej marki, spróbuj najpierw [punktów stylowania widżetu](https://github.com/shoprocket/shoprocket-js). Widżet pozwala na dużo więcej dostosowań CSS, niż się wydaje. Przebudowa na pełne API to znacznie cięższa robota.

## W skrócie

- **Widżet** = domyślny wybór, pokrywa 95% sklepów
- **API / SDK** = gdy widżet ma nie ten kształt (osadzony commerce w SaaS, wiele kanałów, white-label, własny UX, agenci AI, własne BI)
- **Dzisiejszy zakres SDK:** produkty, koszyk, sesje; plus pełne REST API dla zamówień, klientów i rabatów
- **Wzorzec pierwszego projektu:** panel SaaS sprzedający kredyty lub dodatki przez SDK + provisioning sterowany webhookami
- **Nie przebudowuj przez API** tego, co widżet już robi dobrze; wybierz swój kształt

[Rozpocznij bezpłatny okres próbny](https://app-v3.shoprocket.io/signup) i weź klucz publiczny; SDK jest darmowe w każdym planie Shoprocket. 14 dni, bez karty.

---

- HTML version: https://v3.shoprocket.io/pl/blog/api-do-e-commerce-siedem-zastosowan-ktorych-nie-zrobisz-widzetem
- Language: Polski (pl)
- Also in: [العربية](https://v3.shoprocket.io/ar/blog/commerce-api-use-cases-seven-builds-you-cant-do-with-a-widget.md), [Deutsch](https://v3.shoprocket.io/de/blog/commerce-api-anwendungsfaelle-sieben-builds-ohne-widget.md), [Ελληνικά](https://v3.shoprocket.io/el/blog/commerce-api-use-cases-seven-builds-you-cant-do-with-a-widget.md), [English](https://v3.shoprocket.io/blog/commerce-api-use-cases-seven-builds-you-cant-do-with-a-widget.md), [Español](https://v3.shoprocket.io/es/blog/casos-de-uso-api-de-comercio-siete-proyectos-que-un-widget-no-puede-hacer.md), [Français](https://v3.shoprocket.io/fr/blog/api-commerce-sept-cas-usage-impossibles-avec-un-widget.md), [עברית](https://v3.shoprocket.io/he/blog/commerce-api-use-cases-seven-builds-you-cant-do-with-a-widget.md), [हिन्दी](https://v3.shoprocket.io/hi/blog/commerce-api-use-cases-seven-builds-you-cant-do-with-a-widget.md), [Bahasa Indonesia](https://v3.shoprocket.io/id/blog/kasus-penggunaan-commerce-api-tujuh-hal-yang-tidak-bisa-dilakukan-widget.md), [Italiano](https://v3.shoprocket.io/it/blog/api-commerce-sette-casi-duso-che-un-widget-non-copre.md), [日本語](https://v3.shoprocket.io/ja/blog/commerce-api-use-cases-seven-builds-you-cant-do-with-a-widget.md), [Lietuvių](https://v3.shoprocket.io/lt/tinklarastis/prekybos-api-panaudojimo-atvejai-septyni-sprendimai-kuriu-nepadarysite-su-valdykle.md), [Norsk](https://v3.shoprocket.io/nb/blogg/handels-api-sju-ting-du-ikke-kan-bygge-med-en-widget.md), [Nederlands](https://v3.shoprocket.io/nl/blog/commerce-api-use-cases-zeven-projecten-zonder-widget.md), [Português](https://v3.shoprocket.io/pt/blog/casos-de-uso-api-de-commerce-sete-projetos-que-widget-nao-faz.md), [Română](https://v3.shoprocket.io/ro/blog/cazuri-de-utilizare-api-comert-sapte-proiecte-fara-widget.md), [Русский](https://v3.shoprocket.io/ru/blog/commerce-api-use-cases-seven-builds-you-cant-do-with-a-widget.md), [ไทย](https://v3.shoprocket.io/th/blog/commerce-api-use-cases-seven-builds-you-cant-do-with-a-widget.md), [Türkçe](https://v3.shoprocket.io/tr/blog/commerce-api-kullanim-senaryolari-widget-ile-yapilamayan-yedi-proje.md), [中文](https://v3.shoprocket.io/zh/blog/commerce-api-use-cases-seven-builds-you-cant-do-with-a-widget.md)