Wenn Sie Exact Online mit einer oder mehreren Integrationen verwenden, haben Sie es mit API-Limits zu tun. Die API (Application Programming Interface) ist die technische Verbindung, über die Anwendungen wie die Barcode Scan App mit Exact Online kommunizieren. Exact Online setzt Grenzen für die Häufigkeit, mit der diese API angesprochen werden darf, um die Leistung für alle Benutzer sicherzustellen.
Was sind API-Limits?
API-Limits bestimmen, wie viele Anfragen (Aufrufe) eine Anwendung innerhalb eines bestimmten Zeitraums an die Exact Online Server senden darf. Diese Limits schützen die Server vor Überlastung und stellen sicher, dass alle Benutzer eine gute Erfahrung haben.
Exact Online verwendet zwei Arten von Limits:
Tägliches Limit: 5.000 Aufrufe pro Administration pro Tag
Jede Administration in Exact Online darf maximal 5.000 API-Aufrufe pro Tag erhalten. Dieses Limit gilt für alle Anwendungen zusammen, die mit Ihrer Administration verbunden sind. Verwenden Sie neben der Barcode Scan App auch andere Integrationen, wie eine Webshop-Integration oder ein Reporting-Tool? Dann teilen sich diese Anwendungen das tägliche Limit.
Minutenlimit: 60 Aufrufe pro Minute
Zusätzlich dürfen maximal 60 API-Aufrufe pro Minute gemacht werden. Dies verhindert, dass eine Anwendung in kurzer Zeit eine große Anzahl von Anfragen sendet und damit den Server belastet.
Fehlerlimit: 10 Fehler pro Stunde
Ein drittes Limit betrifft die Anzahl der Fehlermeldungen. Wenn eine Anwendung mehr als 10 fehlerhafte API-Aufrufe pro Endpunkt pro Benutzer pro Stunde erzeugt, wird der Zugang zu diesem Endpunkt für eine Stunde gesperrt. Das bedeutet, dass es wichtig ist, fehlerhafte Eingaben zu vermeiden.
Auswirkungen auf Ihren täglichen Betrieb
In der Praxis sind API-Limits für die meisten Unternehmen kein Problem. Die Barcode Scan App ist optimiert, um die Anzahl der Aufrufe auf ein Minimum zu beschränken. Dennoch gibt es Situationen, in denen Sie an das Limit stoßen können:
- Viele gleichzeitige Benutzer: Wenn mehrere Mitarbeiter gleichzeitig scannen, steigt die Anzahl der API-Aufrufe.
- Mehrere Integrationen: Wenn Sie neben der Barcode Scan App auch andere Anwendungen verwenden, die auf die Exact Online API zugreifen.
- Große Synchronisationen: Bei der erstmaligen Synchronisation eines großen Artikelbestands oder nach dem Aktualisieren des Caches.
- Massenoperationen: Das Einbuchen großer Wareneingange oder die Verarbeitung vieler Aufträge an einem Tag.
Wie die Barcode Scan App intelligent mit Limits umgeht
Die Barcode Scan App ist umfassend optimiert, um möglichst wenige API-Aufrufe zu verwenden:
Lokaler Cache
Die App speichert Artikeldaten, Lagerplätze, Bestandsmengen und andere Daten lokal in einem Cache. Dadurch ist nicht bei jedem Scan ein API-Aufruf erforderlich. Der Cache wird intelligent auf Basis von Änderungen aktualisiert, sodass Sie immer mit aktuellen Daten arbeiten.
Intelligente Synchronisation
Anstatt alle Daten erneut abzurufen, synchronisiert die App nur die Daten, die sich seit der letzten Synchronisation geändert haben. Dies spart erheblich bei der Anzahl der API-Aufrufe.
Fehlerprävention
Die App prüft Eingaben, bevor sie an die API gesendet werden. Falsche Mengen, unbekannte Artikel oder fehlende Pflichtfelder werden erkannt, bevor ein API-Aufruf gemacht wird. Dies verhindert, dass Sie das Fehlerlimit erreichen.
Warnungen
Wenn das API-Limit kurz vor dem Erreichen steht, zeigt die App eine Warnung an. So können Sie rechtzeitig Maßnahmen ergreifen, wie zum Beispiel nicht dringende Aktionen auf den nächsten Tag zu verschieben.
API-Nutzung mit API Insights überwachen
Die Barcode Scan App bietet ein API Insights Dashboard, mit dem Sie Ihre API-Nutzung überwachen können. Sie finden diese Übersicht in den Einstellungen unter dem Tab Cache. Das Dashboard zeigt:
- Heute verwendete Aufrufe: Wie viele der 5.000 täglichen Aufrufe verbraucht wurden.
- Verbleibende Aufrufe: Wie viele Aufrufe noch verfügbar sind.
- Aufrufe pro Minute: Aktuelle Nutzung im Verhältnis zum Minutenlimit.
- Fehlermeldungen: Eventuelle Fehler in der API-Kommunikation und deren Ursache.
Mit diesem Einblick können Sie proaktiv eingreifen und verhindern, dass Ihre Arbeitsprozesse gestört werden.
Was tun, wenn das Limit nicht ausreicht?
Wenn das Standardlimit von 5.000 Aufrufen pro Tag strukturell nicht für Ihr Unternehmen ausreicht, gibt es mehrere Optionen:
- Exact Online Premium: Mit einem Exact Online Premium-Abonnement können Sie zusätzliche API-Aufrufe bei Exact erwerben. Kontaktieren Sie dafür Ihren Exact-Partner.
- Integrationen optimieren: Prüfen Sie, ob andere Anwendungen, die Ihre API-Aufrufe verbrauchen, effizient konfiguriert sind. Manchmal verbrauchen Reporting-Tools oder Sync-Anwendungen unnötig viele Aufrufe.
- Nutzung verteilen: Planen Sie große Synchronisationen oder Massenimporte außerhalb der Spitzenzeiten, um die Nutzung über den Tag zu verteilen.
Fazit
API-Limits sind eine Realität bei der Arbeit mit Exact Online Integrationen. Wenn Sie verstehen, wie sie funktionieren, und optimierte Anwendungen wie die Barcode Scan App verwenden, haben Sie in der Praxis kaum Einschränkungen. Das API Insights Dashboard gibt Ihnen den Einblick, den Sie benötigen, um Ihre Nutzung zu überwachen und rechtzeitig Anpassungen vorzunehmen.