API
Die TimeTrack Rest API können Sie nutzen, um TimeTrack mit anderen Systemen zu verbinden.
Arbeitszeiten bzw. Anwesenheiten sind Zeiteinträge ohne Projektzuweisung, das einfache “Kommen und Gehen” der Mitarbeiter.
Mit diesem Endpoint können Sie:
Zeiteintrag-Objekt hat folgende Parameter:
Feldname | Typ | Beschreibung |
---|---|---|
ID | Integer | ID |
user | Text | Benutzername |
from | Text | Start-Zeitstempel der Erfassung – Format: YYYY-MM-DDTHH:MM:SS.fffZ, Beispiel: 2020-10-20T09:00:00.000Z |
to | Text | End-Zeitstempel der Erfassung – Format: YYYY-MM-DDTHH:MM:SS.fffZ, Beispiel: 2020-10-20T09:00:00.000Z |
notes | Text | Notizen |
manual | Boolean | Info ob der Zeiteintrag manuell oder mit der Stempeluhr angelegt ist. |
workedMinutes | Integer | Dauer der Arbeit in Minuten |
breakMinutes | Integer | Dauer der Pause in Minuten |
latitudeStart | Number | Start GPS Koordinaten Latitude |
longitudeStart | Text | End GPS Koordinaten Longitude |
latitudeEnd | Text | Start GPS Koordinaten Latitude |
longitudeEnd | Text | End GPS Koordinaten Longitude |
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 $'{}’
Folgende Filter können verwendet werden:
Feldname | Typ | Beschreibung |
---|---|---|
user | Text | Benutzername |
from | Text | Von, Format: YYYY-MM-DDTHH:MM:SS.fffZ, Beispiel: 2020-10-20T09:00:00.000Z |
to | Text | Bis, Format: YYYY-MM-DDTHH:MM:SS.fffZ, Beispiel: 2020-10-20T09:00:00.000Z |
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 $'{}’
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 $'{}’
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”
}’
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”
}’
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 $'{}’