> ## Documentation Index
> Fetch the complete documentation index at: https://andcze.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 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](https://andcze.mintlify.site/pl/developers/storefront-api.md) | [API z kluczem](https://andcze.mintlify.site/pl/developers/api-keys.md) |

## Wybierz narzędzie

> **[Buduję stronę sklepu](https://andcze.mintlify.site/pl/developers/sdk/typescript.md)**
>
> `@itemshop/sdk` + `@itemshop/sdk/react` i CLI `itemshop`.

> **[Integruję backend / bota](https://andcze.mintlify.site/pl/developers/api-keys.md)**
>
> SDK w Twoim języku i klucz API.

> **[Reaguję na zdarzenia](https://andcze.mintlify.site/pl/developers/webhooks.md)**
>
> Powiadomienia na Discord o zamówieniach i raporty dzienne.

> **[Piszę własny plugin](https://andcze.mintlify.site/pl/developers/plugin-protocol.md)**
>
> Protokół realizacji zamówień w czasie rzeczywistym.

> **[Używam agenta AI](https://andcze.mintlify.site/pl/developers/mcp.md)**
>
> Serwer MCP i skille dla Claude Code i innych agentów.

> **[Szukam endpointu](https://andcze.mintlify.site/pl/api-reference/overview.md)**
>
> Pełna referencja wygenerowana z OpenAPI.

## SDK

| Język | Pakiet | Strona |
| - | - | - |
| TypeScript / JavaScript | `@itemshop/sdk` (npm) | [TypeScript](https://andcze.mintlify.site/pl/developers/sdk/typescript.md) |
| Python | `itemshop` (PyPI) | [Python](https://andcze.mintlify.site/pl/developers/sdk/python.md) |
| PHP | `itemshop/sdk` (Composer) | [PHP](https://andcze.mintlify.site/pl/developers/sdk/php.md) |
| Java / Kotlin | `pl.itemshop:sdk` (Maven) | [Java i Kotlin](https://andcze.mintlify.site/pl/developers/sdk/java-kotlin.md) |
| Go | `github.com/itemshop/sdk-go` | [Go](https://andcze.mintlify.site/pl/developers/sdk/go.md) |

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:

```ts TypeScript theme={null}
const sf = createStorefront({ shopId: "65f1c0ffee0000000000abcd" });
const products = await sf.products.list();
```

```python Python theme={null}
sf = itemshop.Storefront("65f1c0ffee0000000000abcd")
products = sf.products.list()
```

```php PHP theme={null}
$sf = new ItemShop\Storefront(shopId: '65f1c0ffee0000000000abcd');
$products = $sf->products->list();
```

```kotlin Kotlin theme={null}
val sf = storefront("65f1c0ffee0000000000abcd").suspending()
val products = sf.products.list()
```

```go Go theme={null}
sf := storefront.New("65f1c0ffee0000000000abcd")
products, err := sf.Products.List(ctx, nil)
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.