Dla deweloperów

Dwa API, pięć SDK, CLI, serwer MCP i skille agentowe — co wybrać do swojego zadania.

ItemShop udostępnia dwa API o różnym przeznaczeniu. Każde SDK ma ten sam podział.

	Storefront API v1	API z kluczem
Do czego	Strona sklepu, widżety, kasa	Zarządzanie sklepem: produkty, zamówienia, strona, integracje
Gdzie działa	Przeglądarka (i serwer)	Tylko serwer, CI, bot
Uwierzytelnienie	Brak — sklep po shopId lub domenie	Nagłówek X-API-Key
Sekrety	Żadnych — wszystko jest publiczne	Klucz z uprawnieniami (np. products:write, site:write)
W SDK	createStorefront()	createClient({ apiKey })
Opis	Storefront API	API z kluczem

​

Wybierz narzędzie

Buduję stronę sklepu

@itemshop/sdk + @itemshop/sdk/react i CLI itemshop.

Integruję backend / bota

SDK w Twoim języku i klucz API.

Reaguję na zdarzenia

Powiadomienia na Discord o zamówieniach i raporty dzienne.

Piszę własny plugin

Protokół realizacji zamówień w czasie rzeczywistym.

Używam agenta AI

Serwer MCP i skille dla Claude Code i innych agentów.

Szukam endpointu

Pełna referencja wygenerowana z OpenAPI.

​

SDK

Język	Pakiet	Strona
TypeScript / JavaScript	@itemshop/sdk (npm)	TypeScript
Python	itemshop (PyPI)	Python
PHP	itemshop/sdk (Composer)	PHP
Java / Kotlin	pl.itemshop:sdk (Maven)	Java i Kotlin
Go	github.com/itemshop/sdk-go	Go

TypeScript to implementacja referencyjna. Pozostałe SDK są generowane z tej samej specyfikacji OpenAPI i mają ręczną, idiomatyczną warstwę — nazwy metod różnią się konwencją języka, nie znaczeniem.

​

Ten sam przykład w każdym języku

Strony SDK mają wspólny układ: instalacja → storefront → klient z kluczem → kasa → błędy. Dzięki temu łatwo porównać języki:

TypeScript

const sf = createStorefront({ shopId: "65f1c0ffee0000000000abcd" });
const products = await sf.products.list();