API – 4. Rate limiting & verbruik

We beschermen de API tegen misbruiken houden het fair voor alle klanten. Daarom is er rate limiting en registreren we daggebruik.

Beleidsregels

• Standaardlimiet: 20 requests/minuut per API key
• Burst-limiet: 5 requests binnen 5 seconden
• Scope: limieten gelden per API key.
• Wat telt mee: standaard alle 2xx/4xx. (5xx telt niet mee.)

Als je limiet bereikt is → 429

Status: 429 Too Many Requests
Headers:

Retry-After: 30
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 2025-10-08T14:32:00Z

Body:

{
  "error": {
    "code": "rate_limited",
    "message": "Te veel requests. Probeer later opnieuw."
  }
}

Daggebruik registreren

We houden per gebruiker × api_key × datum een teller bij. Het actuele dagverbruik kan je steeds raadplegen in je Facturalia-account.