> ## 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.

# 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

```json theme={null}
{
  "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`.

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

## 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).