Exact Online is streng op haar rate limits. Zo gaan wij ermee om

Wat zijn rate limits?

Om te begrijpen wat rate limits zijn, moet je eerst weten wat een API (Application Programming Interface) is. De API van een softwaresysteem is als het ware het koppelstuk. Een ontwikkelaar verstuurt vanuit zijn software een verzoek naar de API, zoals "Geef me alle informatie over order met ordernummer 123456". Als order 123456 in het systeem staat, krijgt de ontwikkelaar alle informatie over die order terug van het systeem. Je kunt niet alleen informatie opvragen via een API, maar ook indienen.

De limieten op het aantal verzoeken die je naar een API kunt versturen heten "rate limits". Deze zijn er om misbruik van de API te voorkomen. Deze gelden meestal voor een bepaalde interval, zoals een maximum aantal per uur en / of per dag. Overschrijd je de limieten? Dan wordt jouw verbinding (tijdelijk) afgesloten.

Exact Online is de afgelopen jaren steeds strenger geworden op de rate-limits. Sinds kort zitten er echter ook consequenties aan de overschrijding van deze limieten. Veel van onze klanten gebruiken Exact Online, dus wij zijn aan het zorgen dat we de feestdagen (piekperiodes met veel verzoeken naar de API's) goed doorkomen en onze koppelingen blijven werken.

Hoe richten wij onze koppelingen efficiënt in?

Om aan de rate limits te voldoen moet jouw software efficiënt met de API verzoeken omgaan. Als Exact Online App Center partner doen wij dit natuurlijk ook. De volgende maatregelen nemen wij onder andere:

• Meten
  Wij houden het aantal verzoeken vanuit onze software naar de API bij. Zo weten we hoeveel verzoeken we doen en kunnen we acteren waar nodig.

• Groeperen
  Om een wirwar aan API verzoeken te voorkomen groeperen we zoveel mogelijk. Hebben we bijvoorbeeld voor meerdere artikelen gegevens nodig? Dan vragen we dit voor alle artikelen in één verzoek aan en niet in allemaal aparte verzoeken.

• Webhooks gebruiken
  Een webhook is niets anders dan een signaaltje vanuit Exact Online naar onze software dat er iets gebeurt is in Exact Online. Onze software kan luisteren naar deze signaaltjes en op basis van de inhoud van dat signaal er de juiste actie op ondernemen. Zo hoeven wij niet met verzoeken aan Exact Online te vragen of er iets gewijzigd is maar krijgen we dit te horen.

• Geoptimaliseerde timing
  Sommige acties komen niet op de minuut aan, in dat geval smeren wij ze uit om te voorkomen dat de limieten per minuut overschreden worden.

Zo zijn er nog een heel aantal zaken waar wij in onze code rekening mee kunnen houden om zo goed mogelijk gebruik te maken van onze API verzoeken.

Wat als de rate limits alsnog overschreden worden?

Heb je een compleet geoptimaliseerde koppeling maar kom je in piekperioden alsnog boven de rate limits uit? Dan kunnen we met een goed onderbouwde analyse op zak, een uitzondering aanvragen bij Exact Online. Je koppeling blijft dan gewoon naadloos werken, ook tijdens de piekperioden!