Rate limits en error codes

De aanvraaglimiet (rate limit) beschermt de API tegen overbelasting en misbruik. Als je in korte tijd te veel verzoeken stuurt, antwoordt de server met HTTP 429 Too Many Requests met de header Retry-After, die aangeeft hoeveel seconden je moet wachten.

Huidige limieten

• De limiet is 60 verzoeken per minuut per token. Geldt gelijk voor alle plannen (Trial, Standard, Pro en Business).
• LAN-agents hebben een aparte limiet van 120 verzoeken per minuut per agent.
• De limiet wordt per token apart geteld (niet per gebruiker als geheel). Heb je een hogere totaallimiet nodig, maak dan meerdere tokens aan voor verschillende doeleinden (bijvoorbeeld een aparte voor CI/CD en een aparte voor het dashboard).

Foutcodes

• 401 Unauthorized - ontbrekend of ongeldig token.
• 403 Forbidden - de actie is niet beschikbaar in je abonnement (bijvoorbeeld een monitor aanmaken na het verlopen van je abonnement of boven de limiet van je abonnement).
• 404 Not Found - de opgevraagde resource (monitor, incident) bestaat niet of je hebt er geen toegang toe.
• 429 Too Many Requests - aanvraaglimiet overschreden. Wacht het aantal seconden dat in de header Retry-After staat.
• 5xx - fout aan de serverkant. Probeer het opnieuw met een geleidelijk langere vertraging (exponential backoff - bijvoorbeeld 1, 2, 4, 8 seconden).

Aanbevelingen voor de praktijk

• Sla antwoorden van lees-endpoints op in een cache. Beschikbaarheidsgegevens veranderen niet elke seconde, je hoeft ze dus niet zo vaak op te halen.
• Gebruik waar mogelijk in plaats van herhaald pollen liever webhooks - de server belt jou zelf zodra er een gebeurtenis is.
• Bij batchoperaties: voeg een korte vertraging tussen verzoeken toe zodat je niet tegen de limiet aanloopt.