Als u Exact Online gebruikt met een of meer koppelingen, dan heeft u te maken met API limieten. De API (Application Programming Interface) is de technische schakel waarmee applicaties zoals de Barcode Scan App communiceren met Exact Online. Exact Online stelt limieten aan het aantal keer dat deze API mag worden aangesproken om de prestaties voor alle gebruikers te waarborgen.
Wat zijn API limieten?
API limieten bepalen hoeveel verzoeken (calls) een applicatie mag sturen naar de Exact Online servers binnen een bepaalde periode. Deze limieten beschermen de servers tegen overbelasting en zorgen ervoor dat alle gebruikers een goede ervaring hebben.
Exact Online hanteert twee typen limieten:
Dagelijks limiet: 5.000 calls per administratie per dag
Elke administratie in Exact Online mag maximaal 5.000 API calls per dag ontvangen. Dit limiet geldt voor alle applicaties samen die met uw administratie zijn verbonden. Gebruikt u naast de Barcode Scan App ook andere koppelingen, zoals een webshopintegratie of een rapportagetool? Dan delen deze applicaties het dagelijkse limiet.
Minutenlimiet: 60 calls per minuut
Daarnaast mogen er maximaal 60 API calls per minuut worden gedaan. Dit voorkomt dat een applicatie in korte tijd een groot aantal verzoeken stuurt en daarmee de server belast.
Foutlimiet: 10 fouten per uur
Een derde limiet betreft het aantal foutmeldingen. Wanneer een applicatie meer dan 10 foutieve API calls per endpoint per gebruiker per uur genereert, wordt de toegang voor dat endpoint voor één uur geblokkeerd. Dit betekent dat het belangrijk is om foutieve invoer te voorkomen.
Impact op uw dagelijks gebruik
In de praktijk zijn de API limieten voor de meeste bedrijven geen probleem. De Barcode Scan App is geoptimaliseerd om het aantal calls tot een minimum te beperken. Toch zijn er situaties waarin u tegen het limiet kunt aanlopen:
- Veel gelijktijdige gebruikers: Wanneer meerdere medewerkers tegelijk scannen, stijgt het aantal API calls.
- Meerdere integraties: Als u naast de Barcode Scan App ook andere applicaties gebruikt die de Exact Online API aanspreken.
- Grote synchronisaties: Bij het initieel synchroniseren van een groot artikelbestand of na het verversen van de cache.
- Bulk-operaties: Het inboeken van grote goederenontvangsten of het verwerken van veel orders op een dag.
Hoe de Barcode Scan App slim omgaat met limieten
De Barcode Scan App is vergaand geoptimaliseerd om zo weinig mogelijk API calls te gebruiken:
Lokale cache
De app slaat artikelgegevens, opslaglocaties, voorraadstanden en andere data lokaal op in een cache. Hierdoor hoeft niet bij elke scan een API call te worden gemaakt. De cache wordt slim bijgewerkt op basis van wijzigingen, zodat u altijd met actuele data werkt.
Slimme synchronisatie
In plaats van alle data opnieuw op te halen, synchroniseert de app alleen de gegevens die zijn gewijzigd sinds de laatste synchronisatie. Dit scheelt aanzienlijk in het aantal API calls.
Foutpreventie
De app controleert invoer voordat deze naar de API wordt gestuurd. Verkeerde hoeveelheden, onbekende artikelen of ontbrekende verplichte velden worden gedetecteerd voordat er een API call wordt gemaakt. Dit voorkomt dat u het foutlimiet bereikt.
Waarschuwingen
Wanneer het API limiet dreigt te worden bereikt, toont de app een waarschuwing. Zo kunt u op tijd maatregelen nemen, zoals niet-urgente acties uitstellen naar de volgende dag.
API-gebruik monitoren met API Insights
De Barcode Scan App biedt een API Insights dashboard waarmee u uw API-gebruik kunt monitoren. U vindt dit overzicht in de instellingen onder het tabblad Cache. Het dashboard toont:
- Gebruikte calls vandaag: Hoeveel van de 5.000 dagelijkse calls zijn verbruikt.
- Resterende calls: Hoeveel calls er nog beschikbaar zijn.
- Calls per minuut: Het huidige gebruik ten opzichte van het minutenlimiet.
- Foutmeldingen: Eventuele fouten in de API-communicatie en hun oorzaak.
Met dit inzicht kunt u proactief ingrijpen en voorkomt u dat uw werkprocessen worden verstoord.
Wat als het limiet niet voldoende is?
Als het standaardlimiet van 5.000 calls per dag structureel niet toereikend is voor uw bedrijf, zijn er een aantal opties:
- Exact Online Premium: Met een Exact Online Premium abonnement kunt u aanvullende API calls bijkopen bij Exact. Neem hiervoor contact op met uw Exact-partner.
- Optimaliseer integraties: Controleer of andere applicaties die uw API calls verbruiken efficiënt zijn geconfigureerd. Soms verbruiken rapportagetools of sync-applicaties onnodig veel calls.
- Spreid het gebruik: Plan grote synchronisaties of bulk-imports buiten piekuren om het gebruik te spreiden over de dag.
Conclusie
API limieten zijn een realiteit bij het werken met Exact Online koppelingen. Door te begrijpen hoe ze werken en door gebruik te maken van geoptimaliseerde applicaties zoals de Barcode Scan App, ondervindt u er in de praktijk weinig hinder van. Het API Insights dashboard geeft u het inzicht dat u nodig heeft om uw gebruik te monitoren en tijdig bij te sturen.