API

Die TimeTrack Rest API können Sie nutzen, um TimeTrack mit anderen Systemen zu verbinden. 

Anwesenheiten / Arbeitszeiten

Arbeitszeiten bzw. Anwesenheiten sind Zeiteinträge ohne Projektzuweisung, das einfache „Kommen und Gehen“ der Mitarbeiter.

Mit diesem Endpoint können Sie:

  • Alle Zeiteinträge auflisten ohne Filter
  • Alle Zeiteinträge auflisten mit Filter
  • Bestimmten Zeiteintrag abrufen
  • Neuen Zeiteintrag anlegen
  • Bestehenden Zeiteintrag updaten
  • Zeiteintrag entfernen

Zeiteintrag-Objekt hat folgende Parameter:

Feldname Typ Beschreibung
ID Integer ID
user Text Benutzername
from Text Start-Zeitstempel der Erfassung – Format: YYYY-MM-DDTHH:MM:SS.fffZ, Beispiel: 2020-10-20T09:00:00.000Z
to Text End-Zeitstempel der Erfassung – Format: YYYY-MM-DDTHH:MM:SS.fffZ, Beispiel: 2020-10-20T09:00:00.000Z
notes Text Notizen
manual Boolean Info ob der Zeiteintrag manuell oder mit der Stempeluhr angelegt ist.
workedMinutes Integer Dauer der Arbeit in Minuten
breakMinutes Integer Dauer der Pause in Minuten
latitudeStart Number Start GPS Koordinaten Latitude
longitudeStart Text End GPS Koordinaten Longitude
latitudeEnd Text Start GPS Koordinaten Latitude
longitudeEnd Text End GPS Koordinaten Longitude

Zeiteinträge auflisten ohne Filter

curl „https://testkonto.timetrackenterprise.com/api/v2/ext/attendances/“
-H ‚Content-Type: application/json‘
-H ‚X-TimeTrack-Api-Secret: <API_SECRET_TOKEN>‚
-H ‚X-TimeTrack-Api-Key: <API_KEY>‚
-d $'{}‘

Zeiteinträge auflisten mit Filter

Folgende Filter können verwendet werden:

Feldname Typ Beschreibung
user Text Benutzername
from Text Von, Format: YYYY-MM-DDTHH:MM:SS.fffZ, Beispiel: 2020-10-20T09:00:00.000Z
to Text Bis, Format: YYYY-MM-DDTHH:MM:SS.fffZ, Beispiel: 2020-10-20T09:00:00.000Z

In diesem Beispiel fragen wir nach den Zeiteinträgen des Benutzers „hansm“ zwischen 01.10.2020 und 31.10.2020.

curl „https://testkonto.timetrackenterprise.com/api/v2/ext/attendances?username=hansm&from=2020-10-01T00:00:00Z&to=2020-10-31T00:00:00Z“
-H ‚Content-Type: application/json‘
-H ‚X-TimeTrack-Api-Secret: <API_SECRET_TOKEN>‚
-H ‚X-TimeTrack-Api-Key: <API_KEY>‚
-d $'{}‘

Bestimmten Zeiteintrag abrufen

Pflichtparameter: ID des Zeiteintrags. Im folgenden Beispiel ist die ID 1.

curl „https://testkonto.timetrackenterprise.com/api/v2/ext/attendances/1“
-H ‚Content-Type: application/json‘
-H ‚X-TimeTrack-Api-Secret: <API_SECRET_TOKEN>‚
-H ‚X-TimeTrack-Api-Key: <API_KEY>‚
-d $'{}‘

Neuen Zeiteintrag anlegen

Beim Anlegen des Zeiteintrags können Sie alle Parameter des Zeiteintrag-Objekts verwenden.

Pflichtparameter: username, from, to

curl -X „POST“ „https://testkonto.timetrackenterprise.com/api/v2/ext/attendances“
-H ‚Content-Type: application/json‘
-H ‚X-TimeTrack-Api-Secret: <API_SECRET_TOKEN>‚
-H ‚X-TimeTrack-Api-Key: <API_KEY>‚
-d $'{
„username“: „ivan“,
„to“: „2020-10-17T14:00:00.000Z“,
„minutesBreak“: 15,
„details“: „Das ist ein Test“,
„from“: „2020-10-17T10:00:00.000Z“
}‘

Bestehenden Zeiteintrag updaten

Beim Updaten des Zeiteintrags können Sie alle Parameter des Zeiteintrags-Objekts verwenden, mit Ausnahme folgender Parameter: username.

curl -X „PUT“ „https://testkonto.timetrackenterprise.com/api/v2/ext/attendances/1“
-H ‚Content-Type: application/json‘
-H ‚X-TimeTrack-Api-Secret: <API_SECRET_TOKEN>‚
-H ‚X-TimeTrack-Api-Key: <API_KEY>‚
-d $'{
„notes“: „Das ist ein Test Notiz“,
„to“: „2020-10-17T23:00:00.000Z“,
„minutesBreak“: „0“
}‘

Zeiteintrag entfernen

curl -X „DELETE“ „https://testkonto.timetrackenterprise.com/api/v2/ext/attendances/1“
-H ‚Content-Type: application/json‘
-H ‚X-TimeTrack-Api-Secret: <API_SECRET_TOKEN>‚
-H ‚X-TimeTrack-Api-Key: <API_KEY>‚
-d $'{}‘

Ressourcen