Skip to main content
Railmail ogranicza zapytania do 60 na minutę na klucz API. Limit jest stosowany per klucz, więc różne klucze mają osobne budżety.

​
Nagłówki limitów

Każda odpowiedź zawiera nagłówki opisujące Twój bieżący budżet: Czytaj te nagłówki, aby dostosować tempo zapytań, zanim osiągniesz limit.

​
Gdy przekroczysz limit

Po przekroczeniu limitu API zwraca 429 Too Many Requests z nagłówkiem Retry-After, który mówi, ile sekund odczekać przed ponowieniem:

​
Jak elegancko obsłużyć limity

1

Obserwuj X-RateLimit-Remaining

Zwalniaj, gdy Remaining zbliża się do zera, zamiast wysyłać zapytania aż do odrzucenia.
2

Respektuj Retry-After przy 429

Gdy otrzymasz 429, odczekaj liczbę sekund z Retry-After przed ponowieniem; nie ponawiaj natychmiast.
3

Stosuj backoff przy powtarzających się 429

Jeśli wciąż osiągasz limit, dodaj wykładniczy backoff i rozważ grupowanie pracy lub rozłożenie jej w czasie.
Przy pracy masowej, jak import wielu subskrybentów, dodaj małe opóźnienie między zapytaniami, aby pozostać wygodnie poniżej 60/minutę zamiast wysyłać serie i wpadać w throttling.