Dokumentacja dla deweloperów
Limity szybkości
DomScan API do analizy domen: Każda uwierzytelniona odpowiedź, udana lub z błędem, zawiera te nagłówki, a przeglądarki mogą je odczytać przez CORS.
Limity szybkości
- Konta bezpłatne: 300 żądań na minutę z możliwością wzrostu do 60. Ten budżet jest wspólny dla wszystkich kluczy API i sesji pulpitu na koncie.
- Konta płatne: 900 żądań na minutę z możliwością wzrostu do 120. Ten budżet jest wspólny dla wszystkich kluczy API i sesji pulpitu na koncie.
- Plany Enterprise i miesięczne plany dużego wolumenu: Limity niestandardowe uzgodnione z naszym zespołem pod kątem Twojego obciążenia. Gdy taki limit jest aktywny,
X-RateLimit-Policyzawieracustomoraz podaje uzgodnioną szybkość i wartość burst. Porozmawiaj z zespołem sprzedaży - Żądania bez klucza API: 600 żądań na minutę na adres IP, z burstem 20.
- Punkty końcowe zbiorcze dla kont bezpłatnych: Dodatkowe 20 żądań na minutę na konto i 100 żądań na minutę na sieć.
- Żądania z pamięci podręcznej (prefer_cache=1): Nadal liczone w stosunku do Twojego limitu szybkości, ale odpowiadają szybciej i pomijają wyszukiwanie upstream.
- Punkt końcowy zbiorczy: 50 domen na żądanie
- TLD na żądanie: maksymalnie 50
Przekroczenie limitu zwraca HTTP 429 z nagłówkiem
Retry-After. Każda uwierzytelniona odpowiedź zawiera X-RateLimit-Limit, X-RateLimit-Remaining i X-RateLimit-Policy, dzięki czemu możesz śledzić pozostały budżet zamiast zgadywać.
Nagłówki limitu zapytań
Każda uwierzytelniona odpowiedź, udana lub z błędem, zawiera te nagłówki, a przeglądarki mogą je odczytać przez CORS. Używaj ich do regulowania tempa żądań zamiast czekać na 429.
| Nagłówek | Co oznacza |
|---|---|
X-RateLimit-Plan | Który limit obowiązuje: free, paid lub standard dla żądań bez klucza API. |
X-RateLimit-Limit | Twoja pojemność burst: ile żądań możesz wysłać naraz. |
X-RateLimit-Remaining | Ile żądań możesz jeszcze teraz wysłać, zanim zadziała limit. |
X-RateLimit-Reset | Czas Unix w sekundach, w którym Twoja pojemność burst znów jest pełna. |
X-RateLimit-Policy | Pełna polityka w postaci czytelnej maszynowo, na przykład paid; sustained=900; burst=120; scope=account; window=60. |
Retry-After | Wysyłany z HTTP 429: ile sekund czekać przed ponowną próbą. |