API
Die TimeTrack Rest API können Sie nutzen, um TimeTrack mit anderen Systemen zu verbinden.
Abwesenheiten
Mit diesem Endpoint können Sie:
- Alle Abwesenheiten auflisten ohne Filter
- Alle Abwesenheiten auflisten mit Filter
- Bestimmte Abwesenheit abrufen
- Neue Abwesenheit anlegen
- Bestehende Abwesenheit updaten
- Abwesenheit entfernen
Abwesenheit-Objekt hat folgende Parameter:
| Feldname | Typ | Beschreibung |
|---|---|---|
| ID | Integer | ID |
| user | Text | Benutzername |
| from | Text | Start-Datum – Format: YYYY-MM-DD |
| to | Text | End-Datum – Format: YYYY-MM-DD |
| status | Integer | Status der Abwesenheit, 0 – Neu und Wartet auf die Freigabe, 1 – Freigegeben, 2 – Abgelehnt |
| absenceType | Integer | ID der Abwesenheitsart |
| absenceTypeName | Text | Kürzel der Abwesenheitsart |
Abwesenheiten auflisten ohne Filter
curl „https://testkonto.timetrackenterprise.com/api/v2/ext/absences/“
-H ‚Content-Type: application/json‘
-H ‚X-TimeTrack-Api-Secret: <API_SECRET_TOKEN>‚
-H ‚X-TimeTrack-Api-Key: <API_KEY>‚
-d $'{}‘
Abwesenheiten auflisten mit Filter
Folgende Filter können verwendet werden:
| Feldname | Typ | Beschreibung |
|---|---|---|
| user | Text | Benutzername |
| from | Text | Datum – Format: YYYY-MM-DD |
| to | Text | Datum – Format: YYYY-MM-DD |
| absenceType | Integer | ID der Abwesenheitsart |
In diesem Beispiel fragen wir nach den Abwesenheiten des Benutzers „hansm“ zwischen 01.10.2020 und 31.10.2020.
curl „https://testkonto.timetrackenterprise.com/api/v2/ext/absences?username=hansm&from=2020-10-01&to=2020-10-31“
-H ‚Content-Type: application/json‘
-H ‚X-TimeTrack-Api-Secret: <API_SECRET_TOKEN>‚
-H ‚X-TimeTrack-Api-Key: <API_KEY>‚
-d $'{}‘
Bestimmte Abwesenheit abrufen
Pflichtparameter: ID der Abwesenheit. Im folgenden Beispiel ist die ID 1.
curl „https://testkonto.imetrackenterprise.com/api/v2/ext/absences/1“
-H ‚Content-Type: application/json‘
-H ‚X-TimeTrack-Api-Secret: <API_SECRET_TOKEN>‚
-H ‚X-TimeTrack-Api-Key: <API_KEY>‚
-d $'{}‘
Neue Abwesenheit anlegen
Beim Anlegen der Abwesenheit können Sie alle Parameter des Abwesenheits-Objekts verwenden.
Pflichtparameter: username, from, to, absenceType
curl -X „POST“ „https://testkonto.timetrackenterprise.com/api/v2/ext/absences“
-H ‚Content-Type: application/json‘
-H ‚X-TimeTrack-Api-Secret: <API_SECRET_TOKEN>‚
-H ‚X-TimeTrack-Api-Key: <API_KEY>‚
-d $'{
„username“: „hansm“,
„absenceType“: 1,
„to“: „2020-10-28“,
„from“: „2020-10-26“
}‘
Bestehende Abwesenheit updaten
Beim Updaten der Abwesenheit können Sie den Status der Abwesenheit updaten.
curl -X „PUT“ „https://testkonto.timetrackenterprise.com/api/v2/ext/absences/1“
-H ‚Content-Type: application/json‘
-H ‚X-TimeTrack-Api-Secret: <API_SECRET_TOKEN>‚
-H ‚X-TimeTrack-Api-Key: <API_KEY>‚
-d $'{
„status“: „1“
}‘
Abwesenheit entfernen
curl -X „DELETE“ „https://testkonto.timetrackenterprise.com/api/v2/ext/absences/1“
-H ‚Content-Type: application/json‘
-H ‚X-TimeTrack-Api-Secret: <API_SECRET_TOKEN>‚
-H ‚X-TimeTrack-Api-Key: <API_KEY>‚
-d $'{}‘