API Anleitung

Requestgrenzen

Es gilt pro 24 Stunden und Benutzerkonto ein Limit von 500 Requests. Dies ist notwendig, um den LogMyTime-Server für alle Firmen gleichermaßen schnell zu halten. Zudem darf eine neue Anfrage erst dann gestellt werden, wenn die zuvor gestellte Anfrage für den gleichen Nutzeraccount oder für die gleiche Client-IP bereits abgeschlossen ist.

Bei Lesezugriffen werden maximal 5000 Entities einer Ressource (z.B. Zeiteinträge) ausgegeben (sogeanntes "Paging"). Sie können natürlich in nachfolgenden Requests weitere Einträge anfordern. Hierzu liefert jede Auflistung von Entities, deren Antwort eigentlich mehr als 5000 Entities beinhalten sollte immer einen Link zur nächsten Seite mit. Unter .NET kann man die nächste Seite z.B. so wie in diesem Artikel beschrieben anfordern.

Pro Schreibzugriff können bis zu 25 Entities geschrieben werden.

Tipps zur ressourcenschonenden Implementierung Ihrer Software

Skiptoken-parameter

Die Verwendung des skiptoken-parameters kann hilfreich sein, wenn Sie große Datenmengen abrufen müssen. Damit lassen sich bis zu 5000 Einheiten pro GET-Anfrage abrufen. Die Dokumentation hierzu finden Sie unter https://www.odata.org/documentation/odata-version-2-0/operations/.

GetChangesDigest

Für die regelmäßige Synchronisierung von neu hinzugekommenen Daten aus LogMyTime auf Ihr System empfehlen wir die Verwendung von GetChangesDigest.

Ressourcennutzung mit Power BI

Aus unserer Erfahrung wird mit Power BI die Zugriffsgrenze üblicherweise nicht überschritten. Power BI ist recht ressourcenschonend programmiert. Daher stößt es nicht an die Grenze, selbst wenn mehrmals am Tag alle Daten eines Kontos abgerufen werden.

Falls Sie mit Power BI also an die Zugriffsgrenze stoßen, so sollten Sie versuchen herauszufinden, warum Power BI bei Ihnen so viele Anfragen stellt. Wenn z.B. die gesamten Daten des Kontos im 10-Minuten-Takt abgerufen werden, dann könnte Power BI die Zugriffshöchstzahl erreichen. Stellen Sie dann in der Software ein, dass die Daten weniger häufig aktualisiert werden.

Beratung durch API-Entwickler

Gerne können Sie auch mit dem Entwickler der API direkt Kontakt aufnehmen. Er berät Sie gerne, wie Sie Ihre Anwendung verändern können, damit diese weniger Ressourcen verbraucht.