Vejledninger: Rate limits og kvoter
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. Til den grænse tæller alle forespørgsler 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.
Kun besvarede forespørgsler tæller med i abonnementet: et 2xx-svar. En 404, en 400, en 413 eller en 5xx koster ikke noget, og det gør 401- og 429-svarene heller ikke, for de afvises, før noget bliver talt. Abonnementet tjekkes, før en forespørgsel kører, så et svar, der ikke er 2xx, bliver givet tilbage bagefter, som regel inden for få sekunder.
GET /v1/usage viser, hvor måneden står, og det er gratis: det tæller med i grænsen pr. minut, men ikke i abonnementet. Det svarer med periodStart og periodResetsOn (YYYY-MM-DD, UTC), requests (hele kontoen denne måned), includedRequests, hardLimit og remaining (begge null på et abonnement uden loft), planName, planType og keyRequests, forespørgslerne med den nøgle, du sendte.
Vi sender dig en e-mail én gang, når måneden passerer 80 % af dit abonnements inkluderede forespørgsler, og én gang ved 100 %.
Free-abonnementet har et fast månedligt loft, som tælles pr. konto på tværs af alle nøgler, også tilbagekaldte. Når det er brugt, svarer API'et 429 med koden QuotaExceeded, og der bliver ikke opkrævet noget. Konsollen viser, hvad der er tilbage, og hvornår tællingen nulstilles. Det samme sker på andre abonnementer med et fast månedligt loft. 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.
Free-abonnementets månedlige opslag kan kræve et bekræftet kort eller telefonnummer. En konto uden får et lille antal startopslag én gang i hele kontoens levetid. Når de er brugt, har 429 med QuotaExceeded også verificationRequired: true og verifyUrl, siden i konsollen, hvor du bekræfter kontoen. Ingen måned nulstiller startopslagene, så der er ingen Retry-After. Bekræft kontoen, eller opgradér.
Free-abonnementet kan også have en kapacitet for hver dag, som alle konti på Free deler. Når den er brugt, får forespørgsler på Free et 429 med koden FreeCapacityExhausted indtil kl. 00.00 UTC, og Retry-After tæller sekunderne dertil. Din egen kvote er urørt, og betalte abonnementer er ikke omfattet.
Se Priser for, hvad hvert abonnement indeholder.
Mange nummerplader på én gang
POST /v1/vehicles/plates slår 1 til 500 nummerplader op i ét kald. For grænsen på 60 forespørgsler i minuttet pr. nøgle er hele kaldet én forespørgsel, uanset hvor mange nummerplader det rummer. Det er med vilje. Det er måden at slå mange nummerplader op på uden at bruge minuttet på dem.
Den månedlige kvote tæller anderledes: kaldet koster én forespørgsel pr. nummerplade, det fandt. Ugyldige nummerplader og nummerplader, som intet køretøj har, tæller ikke, og en nummerplade, der er sendt to gange, tæller én gang. Kvoten tjekkes for hver forskellig gyldig nummerplade, før der slås noget op, og de nummerplader, der ikke blev fundet, gives tilbage bagefter. Hvis din konto ikke kan dække dem alle, bliver hele kaldet et 429 med koden QuotaExceeded, uden resultater og uden at noget er talt. Send færre nummerplader, opgradér abonnementet, eller vent på nulstillingen.
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
429ved at læseRetry-After. Prøv ikke igen i en tæt løkke: de forsøg tæller med i grænsen pr. minut.
Har du brug for mere end 60 forespørgsler i minuttet? Kontakt os.
Fandt du ikke svaret? Skriv til support@motorbay.app.