Obsługa błędów

Spójny kształt odpowiedzi błędów i kody statusu.

Wszystkie błędy mają jednolity kształt, spójny dla całego API.

​

Kształt odpowiedzi

{
  "success": false,
  "statusCode": 400,
  "error": "Komunikat błędu",
  "timestamp": "2026-06-17T10:30:00.000Z",
  "path": "/api/v2/orders"
}

Pole details pojawia się dodatkowo przy błędach walidacji (lista nieprawidłowych pól).

​

Kody statusu

Kod	Znaczenie	Typowa przyczyna
400	Bad Request	Błędne dane wejściowe, nieprawidłowy identyfikator, błąd walidacji
401	Unauthorized	Brak lub niepoprawny klucz API
403	Forbidden	Brak roli, brak dostępu do sklepu, brak uprawnienia klucza API
404	Not Found	Zasób nie istnieje (sklep, produkt, zamówienie…)
429	Too Many Requests	Przekroczony limit żądań
500	Internal Server Error	Błąd po stronie serwera

​

Odpowiedzi sukcesu

Odpowiedzi udane mają kształt { success: true, data, message? }. Niektóre endpointy dodają pola kontekstowe, np. tworzenie zamówienia zwraca redirectUrl, a darmowe zamówienie free: true.

Zawsze sprawdzaj pole success zamiast wyłącznie kodu HTTP — kształt jest stały dla całego API.

​

Walidacja

API odrzuca żądania z nieprawidłowymi danymi, zanim zostaną przetworzone. Pola spoza schematu są ignorowane, a typy są konwertowane automatycznie (np. liczby z query string).