Anwesenheiten / Arbeitszeiten
Arbeitszeiten bzw. Anwesenheiten sind Zeiteinträge ohne Projektzuweisung, das einfache “Kommen und Gehen” der Mitarbeiter.
Mit diesem Endpoint können Sie:
- Alle Zeiteinträge auflisten ohne Filter
- Alle Zeiteinträge auflisten mit Filter
- Bestimmten Zeiteintrag abrufen
- Neuen Zeiteintrag anlegen
- Bestehenden Zeiteintrag updaten
- Zeiteintrag entfernen
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 |
Zeiteinträge auflisten ohne Filter
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 $'{}’
Zeiteinträge auflisten mit Filter
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 $'{}’
Bestimmten Zeiteintrag abrufen
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 $'{}’
Neuen Zeiteintrag anlegen
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”
}’
Bestehenden Zeiteintrag updaten
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”
}’
Zeiteintrag entfernen
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 $'{}’
