Skip to main content
Met rate limiting bepaal je het maximumaantal webhooks dat per seconde aan je endpoint wordt bezorgd. Dit voorkomt dat je systemen overbelast raken tijdens drukke periodes.

Hoe het werkt

Wanneer je een rate limit op een endpoint instelt:
  1. Webhooks worden in de wachtrij gezet
  2. De bezorging wordt zo geregeld dat je limiet niet wordt overschreden
  3. Overtollige webhooks worden vastgehouden en bezorgd zodra er capaciteit vrijkomt
Zo worden verkeerspieken uitgesmeerd en ontvangt je endpoint webhooks in een behapbaar tempo.

Een rate limit instellen

Je kunt rate limiting configureren bij het aanmaken of bewerken van een endpoint:
  1. Ga naar de Webhooks-instellingen in je dashboard
  2. Klik op een endpoint of maak een nieuw endpoint aan
  3. Stel bij Advanced je Rate Limit in
  4. Voer het maximumaantal berichten per seconde in
  5. Bewaar je wijzigingen

De juiste rate limit kiezen

Houd rekening met deze factoren bij het instellen van je limiet:

Voorbeeldlimieten

  • Kleine server / eenvoudige verwerking: 10-50 per seconde
  • Middelgrote infrastructuur: 100-500 per seconde
  • Systemen met hoge capaciteit: 1.000+ per seconde

Belangrijke aandachtspunten

Opbouw van de wachtrij

Als je consequent meer webhooks ontvangt dan je rate limit toestaat, ontstaat er een achterstand. Bijvoorbeeld:
  • Rate limit: 100/seconde
  • Inkomend tempo: 200/seconde
  • Resultaat: de wachtrij groeit en bezorging loopt vertraging op
Als je webhookvolume je rate limit consequent overschrijdt, worden webhooks vertraagd. Monitor je endpoint en verhoog de limiet indien nodig.

Retries en rate limits

Rate limits gelden voor alle bezorgingen, inclusief retries. Een lage rate limit in combinatie met veel retries kan nieuwe webhooks vertragen.

Wanneer rate limiting inzetten

Rate limiting is nuttig wanneer:
  • Je endpoint beperkte capaciteit heeft - Voorkom overbelasting tijdens drukke periodes
  • De verwerking veel middelen vraagt - Elke webhook zet zware operaties in gang
  • Je afhankelijk bent van externe partijen - Je handler roept API’s met rate limits aan
  • Je gedeelde infrastructuur gebruikt - Webhookverwerking concurreert met andere services
Begin met een conservatieve rate limit en verhoog deze zodra je zicht hebt op de capaciteit van je systeem. Een limiet ophogen is eenvoudiger dan herstellen van een overbelaste server.