Rate limits og kvoter

To grænser gælder for hver API-nøgle: en rate limit pr. minut og dit abonnements månedlige kvote.

Pr. minut

Hver API-nøgle må lave 60 forespørgsler i minuttet pr. nøgle. Alle forespørgsler tæller med, også dem, der fejler. Forespørgslerne tælles i faste vinduer på et minut.

Går du over grænsen, får du 429:

HTTP/1.1 429 Too Many Requests
Content-Type: application/problem+json
Retry-After: 60
X-Request-Id: 0HN7Q3C2V4K1M:00000001

{
  "title": "Rate limit exceeded",
  "status": 429,
  "detail": "Too many requests this minute. Try again in 60 seconds.",
  "code": "RateLimitExceeded"
}

Retry-After er det antal sekunder, du skal vente, før du prøver igen. Det er aldrig mere end 60.

Forespørgsler uden nøgle, eller med en værdi, der ikke ligner en nøgle, begrænses i stedet efter IP-adresse: 20 forespørgsler i minuttet. Den grænse er lavere med vilje. En kalder uden nøgle har ingen grund til at sende mange forespørgsler.

Månedlig kvote

Dit abonnement bestemmer, hvor mange forespørgsler der er inkluderet hver måned. Tællingen følger kalendermåneden i UTC og starter forfra den 1.

Hvis et abonnement har et fast månedligt loft, og du når det, svarer API'et 429 med koden QuotaExceeded. Retry-After tæller så sekunderne til kl. 00:00 UTC den 1. i næste måned, så det hjælper ikke at vente et minut. Opgradér abonnementet, eller vent på nulstillingen.

Se Priser for, hvad hvert abonnement indeholder.

Hold dig under grænserne

• Spred forespørgslerne ud. 60 i minuttet er én i sekundet.
• Gem det, du har hentet. Data ændres højst én gang om ugen, og referencedata som arter og farver næsten aldrig. Se Datakilde og aktualitet.
• Brug søgefiltre i stedet for at bladre gennem alt. Se Sideinddeling.
• Håndtér 429 ved at læse Retry-After. Prøv ikke igen i en tæt løkke: de forsøg tæller også.

Har du brug for mere end 60 forespørgsler i minuttet? Kontakt os.