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

# Limity zapytan

> Polityka limitowania zapytan API i sposob obslugi bledow limitow.

# Limity zapytan

Wappfy API stosuje limity zapytan w celu zapewnienia uczciwego uzytkowania i stabilnosci platformy.

## Domyslne limity

| Zakres                     | Limit       | Okno czasowe |
| -------------------------- | ----------- | ------------ |
| Na uzytkownika             | 100 zapytan | 1 minuta     |
| Na IP (nieuwierzytelnione) | 20 zapytan  | 1 minuta     |

## Naglowki limitow zapytan

Kazda odpowiedz zawiera informacje o limitach zapytan:

```http theme={null}
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 87
X-RateLimit-Reset: 1707580800
```

| Naglowek                | Opis                                                         |
| ----------------------- | ------------------------------------------------------------ |
| `X-RateLimit-Limit`     | Maksymalna liczba zapytan dozwolonych w oknie czasowym       |
| `X-RateLimit-Remaining` | Pozostale zapytania w biezacym oknie czasowym                |
| `X-RateLimit-Reset`     | Znacznik czasu Unix, kiedy okno czasowe zostanie zresetowane |

## Obsluga limitow zapytan

Po przekroczeniu limitu otrzymasz odpowiedz `429`:

```json theme={null}
{
  "success": false,
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Too many requests, please try again later"
  }
}
```

### Dobre praktyki

<AccordionGroup>
  <Accordion title="Wdrazaj wykladniczy backoff">
    Gdy otrzymasz odpowiedz 429, poczekaj i ponow probe z rosnacymi opoznieniami: 1s, 2s, 4s, 8s...
  </Accordion>

  <Accordion title="Korzystaj z naglowka Reset">
    Sprawdz `X-RateLimit-Reset`, aby dokladnie wiedziec, kiedy mozesz wznowic zapytania.
  </Accordion>

  <Accordion title="Grupuj operacje tam, gdzie to mozliwe">
    Wysylaj wiadomosci z rozsadnymi opoznieniami miedzy nimi, zamiast wysylac je seriami.
  </Accordion>

  <Accordion title="Cachuj odpowiedzi">
    Unikaj ponownego pobierania danych, ktore sie nie zmienily (np. szczegoly instancji, informacje o kontakcie).
  </Accordion>
</AccordionGroup>