429 API rate limit exceeded

Objaw

API zwraca odpowiedź 429 Too Many Requests z komunikatem:

API rate limit exceeded. Try again in 60 seconds.

Przyczyna

Integracja przekroczyła limit zapytań. Najczęstszą przyczyną jest zbyt częste sprawdzanie statusów (wysyłki do KSeF, zadań asynchronicznych) lub pobieranie list bez stronicowania. Pobieranie list faktur z KSeF ma osobny limit: 6 żądań na godzinę.

Rozwiązanie

1. Żądanie ponawia się po co najmniej 60 sekundach. Jeśli kod 429 się powtarza, przerwy należy wydłużać.
2. Statusy lepiej odbierać przez webhooki niż przez cykliczne zapytania.
3. Listy najlepiej pobierać po 100 elementów (limit=100), z odpowiedzią ograniczoną do potrzebnych pól (fields=) i z nagłówkiem If-None-Match.

Zobacz też Limity zapytań.