Rate limits

Waar limieten gelden

Rate limits zijn hiërarchisch. Ze gelden per organisatie, per project en per API-key. Een verzoek moet binnen alle drie blijven. Limieten kunnen per abonnement verschillen.

TerraRelay publiceert nog geen concrete getallen. Die komen hier te staan zodra de abonnementen bekend zijn.

Als je een limiet overschrijdt

Je krijgt een 429-response met de standaard foutbody. De header Retry-After geeft aan hoe lang je moet wachten voordat je het opnieuw probeert.

HTTP/1.1 429 Too Many Requests
Retry-After: <seconden>

Een 429 afhandelen

• Wacht minstens het aantal seconden uit Retry-After en probeer het daarna opnieuw.
• Spreid pieken over de tijd, bijvoorbeeld met een wachtrij in je backend.
• Probeer niet in een strakke lus opnieuw. Dan blijft de limiet alleen overschreden.
• Gebruik aparte keys per applicatie, zodat een drukke applicatie de limiet van een andere niet opmaakt.