API rate limits en limieten

API rate limits en limieten

Om de API snel en betrouwbaar te houden voor iedereen, hanteren we rate limits per abonnement.

Limieten per plan

Rate limit headers

Bij elke API-response ontvang je headers die aangeven hoeveel requests je nog kunt doen:

X-RateLimit-Limit: 30
X-RateLimit-Remaining: 28
X-RateLimit-Reset: 1707820800

Wat gebeurt er bij overschrijding?

Als je het limiet bereikt, ontvang je een 429 Too Many Requests response:

{
  "message": "Too Many Attempts.",
  "retry_after": 42
}

Wacht het aangegeven aantal seconden (retry_after) voordat je een nieuw verzoek doet.

Historische data beperking

Je kunt alleen meldingen ophalen binnen de historische periode van je plan. Als je een date_from parameter opgeeft die ouder is dan toegestaan, ontvang je een 422 fout met de vroegst toegestane datum.

Paginering

De API gebruikt cursor-based paginering voor efficiënte navigatie door grote datasets:

# Eerste pagina
curl -H "Authorization: Bearer token" \
     "https://meldingsmonitor.test/api/v1/incidents?per_page=25"

# Volgende pagina (gebruik de cursor uit de response)
curl -H "Authorization: Bearer token" \
     "https://meldingsmonitor.test/api/v1/incidents?cursor=abc123&per_page=25"

Tips voor efficiënt API-gebruik

• Gebruik filters om alleen relevante data op te halen
• Cache responses waar mogelijk
• Gebruik webhooks in plaats van polling voor real-time notificaties
• Houd je requests per minuut in de gaten via de rate limit headers