Rate limits
Requestbudgetar per nyckel över fyra tidsfönster.
Varje API-nyckel har upp till fyra budgetar, som konfigureras per nyckel i dashboarden:
rate_limit_per_second— token bucket, valfritt med en högreburst_limitför korta toppar.rate_limit_per_minute,rate_limit_per_hour,rate_limit_per_day— fasta fönster.
Alla konfigurerade fönster upprätthålls på serversidan. När du överskrider något av dem returnerar anropet 429 rate_limited med en Retry-After-header (i sekunder) och en detail som anger vilket fönster du slog i.
Rekommenderat klientbeteende
- Vid
429: väntaRetry-Aftersekunder innan du försöker igen. Bombardera inte API:et. - Om du väntar dig toppar (t.ex. batchjobb), be om en
burst_limitpå nyckeln i stället för att loopa omförsök. - Asynkrona endpoints (
?async=true) förbrukar bara en rate limit-slot när jobbet köas, inte vid varje pollning.