Rate limit

Wat is een rate limit?

Een rate limit is een grens op hoeveel verzoeken je binnen een bepaalde tijd naar een API of service mag sturen. Bijvoorbeeld: maximaal 600 verzoeken per minuut of 10.000 verzoeken per dag.

Die limiet beschermt de aanbieder tegen overbelasting en zorgt dat één klant niet alle capaciteit opsoupeert. Voor jouw integratie bepaalt ze hoe snel je data kan ophalen, synchroniseren of terugschrijven.

Je merkt rate limits vaak pas wanneer een koppeling van test naar productie gaat. Een kleine test met honderd records werkt perfect. De eerste volledige sync van vijf jaar historiek krijgt plots HTTP 429: te veel verzoeken.

Waar kom je rate limits tegen?

• Bij API-connectors
  CRM, ERP, boekhouding en marketingtools beperken bijna altijd hoeveel calls je mag doen.

• Bij webhooks
  De ontvangende kant kan te veel inkomende events weigeren of vertragen.

• Bij AI-modellen
  Limieten kunnen gelden per minuut, per token, per deployment of per abonnement.

• Bij scraping en exports
  Ook downloadroutes en portalen kunnen verzoeken afremmen.

Hoe ontwerp je rond rate limits?

Een goede integratie leest de limieten uit documentatie en uit de antwoorden van de API. Sommige API's sturen headers terug die tonen hoeveel verzoeken je nog over hebt of hoelang je moet wachten.

Bij een 429-antwoord hoort je systeem niet meteen opnieuw te proberen. Het moet vertragen, wachten en daarna netjes verdergaan. Dat combineer je met een retry policy en een queue, zodat data niet verloren gaat.

Voor grote datasets gebruik je incrementele ladingen. De eerste historische lading mag traag zijn. De dagelijkse sync haalt alleen op wat sinds de vorige keer veranderde.

Rate limit versus quota

Een rate limit gaat meestal over snelheid: hoeveel verzoeken per tijdsvenster. Een quota gaat over totaalverbruik: hoeveel verzoeken, records, tokens of euro's per maand.

Een integratie kan perfect onder de minuutlimiet blijven en toch tegen haar maandquota lopen. Beide grenzen horen in je monitoring.

Waar moet je op letten bij rate limits?

Plan pieken
Een nachtelijke job die om 02:00 alle systemen tegelijk bevraagt, kan zichzelf afremmen. Spreid werk waar nodig.

Gebruik backoff
Bij tijdelijke limieten wacht je langer na elke mislukte poging. Dat voorkomt dat je het probleem groter maakt.

Maak limieten zichtbaar
Rapporteer niet alleen fouten, maar ook resterende capaciteit. Dan zie je problemen aankomen voor de sync faalt.

FAQ over rate limits

1. Is een rate limit een fout?
Nee. Het is normaal gedrag van een API. Je integratie moet ermee kunnen omgaan.

2. Kan je rate limits verhogen?
Soms wel, via een duurder abonnement of aanvraag bij de leverancier. Ontwerp toch alsof limieten blijven bestaan.