Limieten
300 verzoeken per minuut per sleutel, pieken toegestaan — de headers die zeggen waar je staat.
De API telt wat elke sleutel vraagt, zodat één systeem in een lus niet iedereen vertraagt. De limieten zijn ruim voor een CRM dat handelt als iemand klikt; ze zijn er voor de lus.
Verzoeken per sleutel
Elke sleutel mag 300 verzoeken per minuut doen, pieken toegestaan: wat in een minuut niet is gebruikt, mag in één keer op.
Elk geauthenticeerd antwoord draagt drie headers, ook een 429
errors.api.rateLimitExceeded:
| Header | Wat hij zegt |
|---|---|
RateLimit-Limit | Hoeveel verzoeken de sleutel mag doen: 300. |
RateLimit-Remaining | Hoeveel er nu nog over zijn. |
RateLimit-Reset | Seconden tot de sleutel weer op zijn volle 300 staat. |
Een 401 draagt ze niet. Boven de limiet is het antwoord een 429
errors.api.rateLimitExceeded met een header Retry-After: wacht zoveel seconden.
Mislukte authenticatie
Mislukte pogingen zijn begrensd per adres: standaard 20 per minuut. Alleen een goed
gevormde sleutel die niet klopt telt mee — onbekend, fout, ingetrokken of verlopen. Een
ontbrekende of misvormde sleutel telt niet, en deze limiet weigert nooit een sleutel die
klopt. Zijn de pogingen op, dan is het antwoord een 429
errors.api.tooManyFailedAuthentications met Retry-After — en alleen die header: de
sleutel is nooit geverifieerd, dus er is geen RateLimit-*.
Budgetten voor aanmaken
Sommige aanmakende aanroepen hebben daarnaast een budget per organisatie, gedeeld door alle sleutels van de organisatie en los van de limiet op verzoeken:
| Wat | Budget | Code bij de 429 |
|---|---|---|
| Planningslinks | 120 per minuut | errors.api.rateLimitExceeded |
| Uitnodigingen | 60 per minuut en 5.000 per dag | errors.api.rateLimitExceeded |
| Uitnodigingen aan één klant (op e-mailadres) | 10 per dag | errors.api.customerInvitationLimit |
| Teamleden: aanmaakaanroepen, herhalingen meegeteld | 200 per uur | errors.api.colleagueInvitationLimit |
| De uitnodiging van één teamlid opnieuw sturen | 3 per uur | errors.api.colleagueInvitationLimit |
Elk ervan antwoordt met Retry-After. Een 429 wordt nooit bewaard, dus probeer het na
die tijd opnieuw met dezelfde Idempotency-Key.
503 bij een heel grote piek
Een heel grote piek kan een 503 krijgen voordat hij de API bereikt. Probeer het opnieuw met exponentieel oplopende wachttijd en wat willekeurige spreiding, zodat je herhalingen niet tegelijk aankomen.
Gebruik webhooks in plaats van steeds opvragen
Wil je weten wanneer iets veranderde, abonneer je dan op webhooks in plaats van dezelfde lijst steeds opnieuw op te vragen.
Veelgestelde vragen
Geldt de limiet per sleutel of per organisatie?
De 300 verzoeken per minuut gelden per sleutel. De budgetten voor aanmaken gelden per organisatie: een tweede sleutel verdubbelt ze niet.
Kunnen de limieten omhoog?
Mail naar support@schedulinq.com wat je bouwt en hoeveel verzoeken het nodig heeft.