Hastighetsgränser

Förstå hastighetsgränser och kvoter för din API-nivå.

Översikt

FöretagsAPI implementerar hastighetsbegränsning för att säkerställa rättvis användning och API-stabilitet. Gränser tillämpas per API-nyckel och varierar beroende på prenumerationsnivå.

Hastighetsgränser (Rate Limits)

Hastighetsgränser begränsar hur snabbt du kan göra förfrågningar till API:et. Detta mäts i förfrågningar per minut.

Nivå	Förfrågningar/minut
Free	50 förfrågningar/minut
Starter	200 förfrågningar/minut
Pro	500 förfrågningar/minut

Månadskvot (Krediter)

Månadskvoten begränsar hur många företag du kan slå upp per månad. Varje företag som returneras förbrukar 1 kredit.

Nivå	Månadskvot
Free	500 krediter/månad
Starter	5 000 krediter/månad
Pro	50 000 krediter/månad

Engångsköp av krediter

Utöver månadsprenumerationer kan du köpa engångskrediter: 5 000 krediter som engångsköp (giltiga i 12 månader). Besök dashboarden för mer information.

Skillnad mellan hastighetsgränser och månadskvot

⚡ Hastighetsgränser

Hur snabbt du kan göra förfrågningar. Mäts i förfrågningar per minut. Om du överskrider gränsen får du ett 429-fel och måste vänta.

📊 Månadskvot

Hur mycket data du kan hämta. Mäts i antal företag (krediter) per månad. Varje returnerat företag förbrukar 1 kredit från din kvot.

Headers för hastighetsgränser och kvoter

Varje API-svar inkluderar headers för att hjälpa dig spåra din användning:

Header	Beskrivning
x-ratelimit-limit	Maximalt antal förfrågningar tillåtna per minut för din nivå
x-ratelimit-tier	Namnet på din nuvarande prenumerationsnivå (t.ex. "free", "starter", "pro")
x-quota-limit	Din totala månadskvot (antal krediter)
x-quota-remaining	Återstående krediter denna månad
x-quota-used	Antal krediter som använts denna månad

Exempel på svarsheaders

text

x-ratelimit-limit: 50
x-ratelimit-tier: free
x-quota-limit: 500
x-quota-remaining: 400
x-quota-used: 100

Felkoder (429 vs 402)

API:et använder olika statuskoder för att skilja mellan hastighetsgränser och kreditproblem:

Statuskod	Betydelse	Åtgärd
429	Rate limit – för många förfrågningar per minut	Vänta 60 sekunder och försök igen
402	Krediter slut	Uppgradera plan eller köp fler krediter

Hastighetsgränsfel (429)

När du överskrider hastighetsgränser får du ett 429 Too Many Requests-svar:

json

{
  "error": "För många förfrågningar",
  "message": "Du skickar förfrågningar för snabbt. Vänta några sekunder innan du försöker igen.",
  "retryAfter": 5
}

Svaret inkluderar också en retry-after-header med antal sekunder att vänta.

Hantering av hastighetsgränsfel

Vid ett 429-fel, vänta tiden som anges i retryAfter och försök igen. Implementera exponentiell backoff för automatiska omförsök.

Kreditfel (402)

När dina krediter är slut får du ett 402 Payment Required-svar:

json

{
  "error": "Krediterna är slut. Uppgradera din plan eller köp fler krediter."
}

Skillnad mot 429

Ett 402-fel indikerar att dina krediter är slut och att du behöver uppgradera din plan eller köpa fler krediter. Till skillnad från 429-fel hjälper det inte att vänta – du måste utöka din kvot.

Bästa praxis

1. Implementera exponentiell backoff

När du får ett 429-fel, vänta den tid som anges i retryAfter, och försök sedan igen med exponentiell backoff.

2. Använd bulk-endpoints

Istället för att göra enskilda förfrågningar, använd bulk-uppslagsendpointen för att hämta flera företag i en enda förfrågan.

3. Cacha svar

Företagsdata ändras inte ofta. Cacha svar för att minska antalet API-anrop.

4. Övervaka din användning

Kontrollera hastighetsgränsheaders i svaren för att spåra din användning och undvika att nå gränserna.

Behöver du högre gränser?

Om du behöver högre hastighetsgränser eller större månadskvoter, överväg att uppgradera din nivå. Besök dashboarden för att se priser och uppgradera din prenumeration.