Przejdź do głównej treści
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:
NagłówekOpis
X-RateLimit-LimitMaksymalna liczba zapytań dozwolona w oknie (60).
X-RateLimit-RemainingLiczba zapytań pozostała w bieżącym oknie.
X-RateLimit-ResetKiedy bieżące okno się resetuje, czyli kiedy Remaining się odnowi.
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: 
HTTP/1.1 429 Too Many Requests
Retry-After: 42
Content-Type: application/problem+json

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