Die Zeiterfassung bietet eine einfache REST-Schnittstelle für Softwareentwickler zum Erstellen von Zeiteinträgen. Die Schnittstelle ist als REST-Service implementiert und auch geeignet für die Anbindung von Stempeluhren.
Das REST-API muss in den Einstellungen der Zeiterfassung (Reiter Sicherheit) aktiviert und ein Passwort gesetzt werden. Hinweis: Das selbe Passwort wird auch für die Webservice-Schnittstelle verwendet.
Eine Test-Ressource ist erreichbar unter: https://getgoodtime.com/goodtime-rs/api/hello/sayhello
Eine Test-Ressource für das Login ist erreichbar unter: https://getgoodtime.com/goodtime-rs/api/hello/securedSayhello Für diesen Aufruf muss vorher https://getgoodtime.com/goodtime-rs/goodtime-rs/api/login aufgerufen werden.
Ein einfacher Testclient in Java für alle verfügbaren Funktionen als Zip-Datei oder Tar-Datei.
@GET /api/hello/sayhello
Diese Ressource zum Testen gibt ein Hallo zurück.
Keine
String
@GET /api/hello/securedSayhello
Diese Ressource kann zum Testen des Logins verwendet werden. Das Login muss zuvor aufgerufen werden.
Keine
String
@POST /api/login
Diese Ressource kann für das Login verwendet werden.
{loginemail, apipassword}
JSON Web Token
@GET /api/time/timecategories
Diese Ressource liefert eine Liste aller Zeitarten zurück.
Keine
[{id, name}, ...]
@GET /api/time/users
Diese Ressource liefert eine Liste der Loginemails aller Benutzer zurück.
Keine
[{loginemail}, ...]
@GET /api/time/projects
Diese Ressource liefert die Liste der Projekte zurück.
Keine
[{id, name}, ...]
@GET /api/time/projects/{useremail}
Diese Ressource liefert eine Liste der Projekte für einen bestimmten Benutzer zurück.
{useremail}
[{id, name}, ...]
@POST api/time/createtimeentry
Mit dieser Ressource kann man einen neuen Zeiteintrag erzeugen.
{starttime, endtime, useremail, timetypeid, projectid}
Keiner