API

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

Benutzer

Mit diesem Endpoint können Sie:

  • Alle Benutzer auflisten ohne Filter
  • Alle Benutzer auflisten mit Filter
  • Bestimmte Benutzer abrufen
  • Neuen Benutzer anlegen
  • Bestehenden Benutzer updaten
  • Benutzer deaktivieren

Benutzer-Objekt hat folgende Parameter:

Feldname Typ Beschreibung
ID Integer ID
email Text Eindeutige E-Mail Adresse, eindeutig
username Text Eindeutiger Benutzername
firstName Text Vorname
lastName Text Nachname
personalNumber Text Personalnummer
language Text Sprache, aktuell sind folgende Werte erlaubt: de, en
hourRate Text Stundensatz, intern
admin Boolean Ist der Benutzer ein Admin
external Boolean Ist der Benutzer ein externer Mitarbeiter
teamLead Boolean Ist der Benutzer ein Term Leiter
enabled Boolean Ist der Benutzer aktiviert

Benutzer auflisten ohne Filter

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

Benutzer auflisten mit Filter

Folgende Filter können verwendet werden:

Feldname Typ Beschreibung
username Text Benutzername
email Text E-Mail
firstName Text Vorname
lastName Text Nachname
enabled Boolean Aktiv oder inaktiv. Erlaubt sind 0 oder 1, false oder true

In diesem Beispiel fragen wir nach dem Benutzer mit Benutzernamen hansm

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

Bestimmten Benutzer abrufen

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

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

Neuen Benutzer anlegen

Beim Anlegen des Benutzers können Sie alle Parameter des Benutzers-Objekts verwenden.

Pflichtparameter: username, firstName, lastName, email, password

curl -X „POST“ „https://testkonto.imetrackenterprise.com/api/v2/ext/users“
-H ‚Content-Type: application/json‘
-H ‚X-TimeTrack-Api-Secret: <API_SECRET_TOKEN>‚
-H ‚X-TimeTrack-Api-Key: <API_KEY>‚
-d $'{
„teamLead“: false,
„password“: „123123123“,
„firstName“: „Max“,
„admin“: true,
„username“: „test6“,
„email“: „test4@test.com“,
„language“: „de“,
„personalNumber“: 100,
„lastName“: „Mustermann“
}‘

Bestehenden Benutzer updaten

Beim Updaten des Benutzers können Sie alle Parameter des Benutzer-Objekts verwenden, mit Ausnahme folgender Parameter: enabled, username.

curl -X „PUT“ „https://testkonto.imetrackenterprise.com/api/v2/ext/users/1“
-H ‚Content-Type: application/json‘
-H ‚X-TimeTrack-Api-Secret: <API_SECRET_TOKEN>‚
-H ‚X-TimeTrack-Api-Key: <API_KEY>‚
-d $'{
„password“: „122122122“,
„admin“: true,
„firstName“: „Tester“,
„langauge“: „de“,
„email“: „test3_@test.com“
}‘

Benutzer deaktivieren

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

Ressourcen