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.
Die Servicemethode GetChangesDigest kann über einen HTTP GET-Request an folgende URL abgefragt werden:
https://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.
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.
| 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. |
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.