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 $'{}‘