API

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:

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:

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