Direct naar inhoud

Aan de slag

Rate limits

Per API-sleutel 120 verzoeken per minuut. Zo lees je de limietheaders en ga je om met 429.

Limieten

WatLimietPer
Alle /api/v1-endpoints120 verzoeken per minuutAPI-sleutel
POST /accounting/documents (upload)30 verzoeken per minuutAPI-sleutel, bovenop de algemene limiet
Uploadgrootte bankafschrift en document20 MBBestand
per_pageMaximaal 100Verzoek

Limietheaders

Elk antwoord vertelt hoeveel ruimte je nog hebt:

HTTP/1.1 200 OK
X-RateLimit-Limit: 120
X-RateLimit-Remaining: 117

Ga je over de limiet, dan krijg je 429 Too Many Requests met Retry-After (seconden) en X-RateLimit-Reset (Unix-tijd).

HTTP/1.1 429 Too Many Requests
Retry-After: 23
X-RateLimit-Limit: 120
X-RateLimit-Remaining: 0

Binnen de limiet blijven

  • Gebruik per_page=100 bij het ophalen van grote lijsten.
  • Sla gegevens die zelden veranderen (producten, rekeningschema) tijdelijk op.
  • Gebruik webhooks in plaats van steeds opnieuw opvragen of er iets veranderd is.
  • Verdeel bulkimports over de tijd en wacht bij 429 precies Retry-After seconden.

Lees ook