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 $'{}‘
