Przejdź do głównej treści

Limity zapytan

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

Domyslne limity

ZakresLimitOkno czasowe
Na uzytkownika100 zapytan1 minuta
Na IP (nieuwierzytelnione)20 zapytan1 minuta

Naglowki limitow zapytan

Kazda odpowiedz zawiera informacje o limitach zapytan:
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 87
X-RateLimit-Reset: 1707580800
NaglowekOpis
X-RateLimit-LimitMaksymalna liczba zapytan dozwolonych w oknie czasowym
X-RateLimit-RemainingPozostale zapytania w biezacym oknie czasowym
X-RateLimit-ResetZnacznik czasu Unix, kiedy okno czasowe zostanie zresetowane

Obsluga limitow zapytan

Po przekroczeniu limitu otrzymasz odpowiedz 429:
{
  "success": false,
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Too many requests, please try again later"
  }
}

Dobre praktyki

Gdy otrzymasz odpowiedz 429, poczekaj i ponow probe z rosnacymi opoznieniami: 1s, 2s, 4s, 8s…
Sprawdz X-RateLimit-Reset, aby dokladnie wiedziec, kiedy mozesz wznowic zapytania.
Wysylaj wiadomosci z rozsadnymi opoznieniami miedzy nimi, zamiast wysylac je seriami.
Unikaj ponownego pobierania danych, ktore sie nie zmienily (np. szczegoly instancji, informacje o kontakcie).