API

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

Tätigkeiten

Mit diesem Endpoint können Sie:

  • Alle Tätigkeiten auflisten ohne Filter
  • Alle Tätigkeiten auflisten mit Filter
  • Bestimmte Tätigkeit abrufen
  • Neue Tätigkeit anlegen
  • Bestehende Tätigkeit updaten
  • Tätigkeit entfernen

Tätigkeit Objekt hat folgende Parameter:

Feldname Typ Beschreibung
ID Integer ID
name Text Name / Bezeichnung der Tätigkeit
notes Text Notizen
hourRate Number Stundensatz

Tätigkeiten auflisten ohne Filter

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

Tätigkeiten auflisten mit Filter

Folgende Filter können verwendet werden:

Feldname Typ Beschreibung
name Text Wird als Teilstring interpretiert.

In diesem Beispiel fragen wir nach den Tätigkeiten, die in den Namen Test enthalten.

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

Bestimmte Tätigkeit abrufen

Pflichtparameter: ID der Tätigkeit. Im folgenden Beispiel ist die ID 1.

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

Neue Tätigkeit anlegen

Beim Anlegen der Tätigkeit können Sie alle Parameter des Tätigkeit Objekts verwenden.

Pflichtparameter: name

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

Bestehende Tätigkeit updaten

Beim Updaten der Tätigkeit können Sie alle Parameter des Tätigkeit-Objekts verwenden, mit Ausnahme folgender Parameter: name.

curl -X „PUT“ „https://testkonto.timetrackenterprise.com/api/v2/ext/tasks/1“
-H ‚Content-Type: application/json‘
-H ‚X-TimeTrack-Api-Secret: <API_SECRET_TOKEN>‚
-H ‚X-TimeTrack-Api-Key: <API_KEY>‚
-d $'{
„hourRate“: 35.5,
„notes“: „Test Tätigkeit für das API“
}‘

Tätigkeit entfernen

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

Ressourcen