Szybki start

Od klucza sklepu do pierwszych bezpiecznych wywołań REST API.

Ten przewodnik tworzy serwer i produkt przez klucz przypisany do sklepu. Wszystkie ścieżki mają prefiks /api/v2.

​

1. Przygotuj sklep i klucz

1. Zaloguj się do panelu i utwórz sklep.
2. Zapisz jego 24-znakowy shopId.
3. W zakładce Klucze API utwórz klucz typu Sklep (integracja).
4. Nadaj mu servers:write i products:write. Zapisz sekret — zobaczysz go tylko raz.

Nie używaj klucza typu Plugin do ogólnych wywołań REST. Jest ograniczony do protokołu realizacji zamówień w czasie rzeczywistym.

​

2. Dodaj serwer

curl -X POST https://api.itemshop.dev/api/v2/servers/<shopId> \
  -H "X-API-Key: <klucz-sklepu>" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Survival", "domain": "play.moj-sklep.pl" }'

Zapisz data._id jako serverId.

​

3. Dodaj produkt

curl -X POST https://api.itemshop.dev/api/v2/products/<shopId> \
  -H "X-API-Key: <klucz-sklepu>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Ranga VIP",
    "serverId": "<serverId>",
    "price": 19.99,
    "commands": ["lp user {PLAYER} parent set vip"]
  }'

products:write zawiera odczyt, więc możesz od razu sprawdzić wynik:

curl https://api.itemshop.dev/api/v2/products/<shopId>?active=true \
  -H "X-API-Key: <klucz-sklepu>"

​

4. Dokończ bezpieczny flow sprzedaży

• skonfiguruj prawdziwego operatora i wykonaj jego test sandbox;
• wgraj plugin oraz wygenerowany config.yml z dedykowanym kluczem typu plugin;
• dodaj aktualne dokumenty sprzedawcy;
• złóż zamówienie przez storefront, aby checkout przesłał rzeczywistą wersję dokumentów, zgody, Turnstile i Idempotency-Key;
• sprawdź pełną ścieżkę: checkout → podpisany webhook operatora → claim pluginu → ACK.

Nie kopiuj na ślepo przykładowego żądania checkoutu: publiczne POST /orders celowo wymaga danych i zgód pochodzących z aktualnie wyświetlonego storefrontu.

​

Co dalej

Uwierzytelnianie

Typy kluczy, zakres i odpowiedzi błędów.

Metody płatności

Konfiguracja operatora i obowiązkowy test sandbox.

Plugin Minecraft

Instalacja, journal i diagnostyka realizacji.

Obsługa błędów

Koperta błędu, statusy i retry.