API

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

Abwesenheiten

Mit diesem Endpoint können Sie:

  • Alle Abwesenheiten auflisten ohne Filter
  • Alle Abwesenheiten auflisten mit Filter
  • Bestimmte Abwesenheit abrufen
  • Neue Abwesenheit anlegen
  • Bestehende Abwesenheit updaten
  • Abwesenheit entfernen

Abwesenheit-Objekt hat folgende Parameter:

Feldname Typ Beschreibung
ID Integer ID
user Text Benutzername
from Text Start-Datum – Format: YYYY-MM-DD
to Text End-Datum – Format: YYYY-MM-DD
status Integer Status der Abwesenheit, 0 – Neu und Wartet auf die Freigabe, 1 – Freigegeben, 2 – Abgelehnt
absenceType Integer ID der Abwesenheitsart
absenceTypeName Text Kürzel der Abwesenheitsart

Abwesenheiten auflisten ohne Filter

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

Abwesenheiten auflisten mit Filter

Folgende Filter können verwendet werden:

Feldname Typ Beschreibung
user Text Benutzername
from Text Datum – Format: YYYY-MM-DD
to Text Datum – Format: YYYY-MM-DD
absenceType Integer ID der Abwesenheitsart

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

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

Bestimmte Abwesenheit abrufen

Pflichtparameter: ID der Abwesenheit. Im folgenden Beispiel ist die ID 1.

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

Neue Abwesenheit anlegen

Beim Anlegen der Abwesenheit können Sie alle Parameter des Abwesenheits-Objekts verwenden.

Pflichtparameter: username, from, to, absenceType

curl -X „POST“ „https://testkonto.timetrackenterprise.com/api/v2/ext/absences“
-H ‚Content-Type: application/json‘
-H ‚X-TimeTrack-Api-Secret: <API_SECRET_TOKEN>‚
-H ‚X-TimeTrack-Api-Key: <API_KEY>‚
-d $'{
„username“: „hansm“,
„absenceType“: 1,
„to“: „2020-10-28“,
„from“: „2020-10-26“
}‘

Bestehende Abwesenheit updaten

Beim Updaten der Abwesenheit können Sie den Status der Abwesenheit updaten.

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

Abwesenheit entfernen

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

Ressourcen