API Anleitung

Ressourcen > Synchronisation

Für dan Fall, dass Sie regelmäßig die LogMyTime API abrufen möchten, um Anderungen im Datenbestand in Ihre eigene Datenbank zu überführen, stellen wir eine spezielle Servicemethode namens GetChangesDigest bereit. Über diese Servicemethode lässt sich mit einem einzigen HTTP-Request prüfen, welche Datenbestände sich seit der letzten Synchronisation geändert haben, um so unnötiges Herunterladen anderer Datenbestände zu vermeiden. Hierdurch wird die Synchronisation schneller und effizienter.

Abfragen von Änderungen des Datenbestands

Die Servicemethode GetChangesDigest kann über einen HTTP GET-Request an folgende URL abgefragt werden:
http(s)://api.logmytime.de/v1/api.svc/GetChangesDigest

Der Parameter LastSynchronizationTime bezeichnet dabei den Zeitpunkt, zu dem das ChangesDigest zuletzt abgerufen wurde. Die ausgegebenen Änderungen beziehen sich auf die Zeitspanne zwischen der Gegenwart und dem angegebenen Zeitpunkt.

LastSynchronizationTime muss im Format YYYY-MM-DD'T'HH:MM:SS angegeben werden, also z.b. wie folgt: 2013-06-24T09:42:33 .
Falls Sie Microsoft .NET verwenden, können Sie ein kompatibles Format für einen DateTime-Typ mittels der Methode ToString("s") erhalten.

Beispiel
GET https://api.logmytime.de/v1/api.svc/GetChangesDigest?ApiKey={apischluessel}&LastSynchronizationTime=2013-06-24T09:42:33

Ausgabe: Änderungen im Datenbestand aus Sicht des Nutzers mit dem angegeben API-Schlüssel seit dem 24.06.2013, 9:42:33.

Ausgabe

Name Typ Beschreibung
TotalClients Integer Anzahl der derzeit aktiven Kunden
ChangedClients Integer Anzahl der seit LastSynchronizationTime veränderten Kunden
TotalProjects Integer Anzahl der derzeit aktiven Projekte
ChangedProjects Integer Anzahl der seit LastSynchronizationTime veränderten Projekte
TotalTasks Integer Anzahl der derzeit aktiven Tätigkeiten
ChangedTasks Integer Anzahl der seit LastSynchronizationTime veränderten Tätigkeiten
TotalUsers Integer Anzahl der derzeit aktiven Mitarbeiter
ChangedUsers Integer Anzahl der seit LastSynchronizationTime veränderten Mitarbeiter
TotalTimeEntries Integer Anzahl der derzeit aktiven Zeiteinträge
ChangedTimeEntries Integer Anzahl der seit LastSynchronizationTime veränderten Zeiteinträge
DeletedTimeEntryIDs Komma-Separierte Liste von Integern Auflistung aller IDs von Zeiteinträgen, die seit LastSynchronizationTime gelöscht wurden.
CurrentServerTime DateTime Aktuelle Zeit auf dem LogMyTime Server. Diesen Zeitstempel können Sie für den nächsten Aufruf von GetChangesDigest verwenden.

Sichtbare Änderungen sind abhängig von Nutzerrechten

Bitte beachten Sie, dass GetChangesDigest wie auch alle anderen ServiceMethoden der LogMyTime API nur die Daten berücksichtigt, die für den Nutzer, als der sich die API ausweist, sichtbar sind. Ruft also z.B. ein Nutzer mit Standard-Zugriffsrechten GetChangesDigest ab, würden dort Änderungen an Zeiteinträgen anderer Nutzer nicht angezeigt werden. Um also den gesamten Datenbestand Ihres Firmenkontos zu synchronisieren, müssen Sie sich mit einem Administratorkonto per API anmelden.