API

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

Projekte

Mit diesem Endpoint können Sie:

  • Alle Projekte auflisten ohne Filter
  • Alle Projekte auflisten mit Filter
  • Bestimmtes Projekt abrufen
  • Neues Projekt anlegen
  • Bestehendes Projekt updaten
  • Projekt deaktivieren

Projekt Objekt hat folgende Parameter:

Feldname Typ Beschreibung
ID Integer ID
projectName Text Name des Projektes
clientName Text Name des Kunden
projectEnabled Boolean Projekt ist aktiviert oder deaktiviert.
notes Text Notizen
hourRate Number Stundensatz
timeEstimated Number Geplante Gesamtdauer des Projektes
budgetEstimated Number Geplantes Budget des Projektes

Projekte auflisten ohne Filter

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

Projekte auflisten mit Filter

Folgende Filter können verwendet werden:

Feldname Typ Beschreibung
projectName Text Wird als Teilstring interpretiert.
clientName Text Wird als Teilstring interpretiert.

In diesem Beispiel fragen wir nach den Projekten, die in den Projektnamen Test enthalten.

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

Bestimmtes Projekt abrufen

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

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

Neues Projekt anlegen

Beim Anlegen des Projektes können Sie alle Parameter des Projekt Objekts verwenden.

Pflichtparameter: clientName, projectName

curl -X „POST“ „https://testkonto.timetrackenterprise.com/api/v2/ext/projects“
-H ‚Content-Type: application/json‘
-H ‚X-TimeTrack-Api-Secret: <API_SECRET_TOKEN>‚
-H ‚X-TimeTrack-Api-Key: <API_KEY>‚
-d $'{
„projectName“: „Test Projekt 001“,
„clientName“: „Test GmbH“
}‘

Bestehendes Projekt updaten

Beim Updaten des Projektes können Sie alle Parameter des Projekt Objekts verwenden. Erinnerung: Der Kundenname muss mit einem bestehenden Kunden übereinstimmen.

curl -X „PUT“ „https://testkonto.timetrackenterprise.com/api/v2/ext/projects/1“
-H ‚Content-Type: application/json‘
-H ‚X-TimeTrack-Api-Secret: <API_SECRET_TOKEN>‚
-H ‚X-TimeTrack-Api-Key: <API_KEY>‚
-d $'{
„hourRate“: „50“,
„notes“: „Test Projekt fuer API“
}‘

Projekt deaktivieren

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

Ressourcen