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

# Format odpowiedzi

> Struktura odpowiedzi Wappfy API — standardowa koperta, paginacja i format bledow.

# Format odpowiedzi

Wszystkie odpowiedzi Wappfy API stosuja spojny format koperty.

## Odpowiedzi pomyslne

Kazda pomyslna odpowiedz jest opakowana w standardowy obiekt:

```json theme={null}
{
  "success": true,
  "data": { ... },
  "meta": {
    "requestId": "req_abc123",
    "timestamp": "2026-02-10T12:00:00.000Z"
  }
}
```

| Pole             | Typ               | Opis                                            |
| ---------------- | ----------------- | ----------------------------------------------- |
| `success`        | `boolean`         | Zawsze `true` dla pomyslnych odpowiedzi         |
| `data`           | `object \| array` | Dane odpowiedzi                                 |
| `meta.requestId` | `string`          | Unikalny identyfikator zapytania do debugowania |
| `meta.timestamp` | `string`          | Znacznik czasu w formacie ISO 8601              |

## Odpowiedzi z paginacja

Endpointy zwracajace listy zawieraja metadane paginacji:

```json theme={null}
{
  "success": true,
  "data": {
    "items": [ ... ],
    "total": 42,
    "page": 1,
    "limit": 20,
    "totalPages": 3
  },
  "meta": {
    "requestId": "req_def456",
    "timestamp": "2026-02-10T12:00:00.000Z"
  }
}
```

Uzyj parametrow zapytania `page` i `limit` do kontrolowania paginacji:

```bash theme={null}
GET /api/instances?page=2&limit=10
```

## Odpowiedzi bledow

Nieudane zapytania zwracaja obiekt bledu:

```json theme={null}
{
  "success": false,
  "error": {
    "code": "INSTANCE_NOT_FOUND",
    "message": "Instance with ID abc123 not found",
    "details": {}
  },
  "meta": {
    "requestId": "req_ghi789",
    "timestamp": "2026-02-10T12:00:00.000Z"
  }
}
```

### Typowe kody bledow

| Status HTTP | Kod                   | Opis                                               |
| ----------- | --------------------- | -------------------------------------------------- |
| `400`       | `VALIDATION_ERROR`    | Tresc zapytania nie przeszla walidacji             |
| `401`       | `UNAUTHORIZED`        | Brakujacy lub nieprawidlowy token uwierzytelniania |
| `403`       | `FORBIDDEN`           | Niewystarczajace uprawnienia                       |
| `404`       | `NOT_FOUND`           | Zasob nie istnieje                                 |
| `409`       | `PLAN_LIMIT_REACHED`  | Limit instancji dla Twojego planu                  |
| `429`       | `RATE_LIMIT_EXCEEDED` | Zbyt wiele zapytan                                 |
| `500`       | `INTERNAL_ERROR`      | Nieoczekiwany blad serwera                         |

<Note>
  Pole `meta.requestId` jest przydatne przy zgloszeniach do wsparcia — dolacz je przy kontakcie z obsluga techniczna, aby przyspieszyc debugowanie.
</Note>