Rate limits

Rate limits

De API begrenst het aantal requests per key, zodat hij voor iedereen snel blijft.

De limieten

  • Default: 300 requests per minuut per API-key, tenzij een route lager zit.
  • GET (read): typisch 60/minuut
  • POST/PATCH/DELETE (write): typisch 30/minuut
  • Factuur versturen: 20/minuut
  • Ping / me: 60/minuut

Wat je ziet bij een overschrijding

Boven de limiet krijg je een 429:

json
{
  "error": {
    "code": "rate_limited",
    "message": "Rate limit exceeded."
  }
}

Respecteer 429 en gebruik exponential backoff voordat je opnieuw probeert.

Zo blijf je eronder

  • Gebruik exponential backoff bij herhaalde 429's.
  • Haal lijsten op met een ruime per_page in plaats van veel losse requests.
  • Trigger AppPilot-flows via webhooks in plaats van agressief te pollen op wijzigingen.