Rate limits en error codes

3 min leestijd · API en integraties

Rate limits voorkomen misbruik van de API. Bij overschrijding ontvangt u HTTP 429 met een Retry-After header.

Limieten per plan

Trial / Standard: 60 requests / minuut Profi: 300 requests / minuut Business: 1000 requests / minuut De limiet is per-token, niet per-user (u kunt meerdere tokens hebben voor verschillende use cases).

Foutcodes

- 401 Unauthorized: ontbrekend of ongeldig token - 403 Forbidden: token heeft geen rechten voor de gegeven actie (read-only token op write endpoint) - 404 Not Found: resource bestaat niet - 429 Too Many Requests: rate limit overschreden, wacht Retry-After seconden - 5xx: server error, retry met exponential backoff

Best practices

- Cache responses voor read (uptime data verandert niet elke seconde) - Gebruik webhooks in plaats van polling waar mogelijk - Bij batch operaties gebruik delay tussen requests