API
Die TimeTrack Rest API können Sie nutzen, um TimeTrack mit anderen Systemen zu verbinden.
Projektzeiten
Projektzeiten sind Zeiteinträge für Projekte, der Aufwand den Sie auf die Projekte buchen.
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
Projekt-Zeiteintrag Objekt hat folgende Parameter:
| Feldname | Typ | Beschreibung |
|---|---|---|
| ID | Integer | ID |
| user | Text | Benutzername |
| clientName | Text | Kundenname |
| projectName | Text | Projektname |
| task | Text | Tätigkeit |
| hourRate | Number | Stundensatz |
| latitude | Text | GPS Koordinaten für Start – Latitude |
| longitude | Text | GPS Koordinaten für Start – Longitude |
| latitude1 | Text | GPS Koordinaten für Ende – Latitude |
| longitude1 | Text | GPS Koordinaten für Ende – Longitude |
| billable | Boolean | Verrechenbar oder nicht |
| flatRate | Boolean | Pauschaleintrag |
| details | Text | Notizen |
| tags | Text | Hashtags |
| from | Text | Start Zeitstempel – Format: YYYY-MM-DDTHH:MM:SS.fffZ, Beispiel: 2020-10-20T09:00:00.000Z |
| to | Text | End Zeitstempel – Format: YYYY-MM-DDTHH:MM:SS.fffZ, Beispiel: 2020-10-20T09:00:00.000Z |
| workedMinutes | Integer | Dauer der Arbeit in Minuten, abzüglich Pause |
| breakMinutes | Integer | Dauer der Pause |
Zeiteinträge auflisten ohne Filter
curl „https://testkonto.timetrackenterprise.com/api/v2/ext/project_time_entries/“
-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 |
|---|---|---|
| clientName | Text | Kundenname |
| projectName | Text | Projektname |
| 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 23.10.2020.
curl „https://testkonto.timetrackenterprise.com/api/v2/ext/project_time_entries?username=hansm&from=2020-10-01T00:00:00.000Z&to=2020-10-23T23:59:59.999Z““
-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/project_time_entries/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: clientName, projectName, user, from, to
curl -X „POST“ „https://testkonto.timetrackenterprise.com/api/v2/ext/project_time_entries“
-H ‚Content-Type: application/json‘
-H ‚X-TimeTrack-Api-Secret: <API_SECRET_TOKEN>‚
-H ‚X-TimeTrack-Api-Key: <API_KEY>‚
-d $'{
„username“: „hansm“,
„from“: „2020-10-20T10:00:00.000Z“,
„to“: „2020-10-20T14:00:00.000Z“
„clientName“: „Kunde 006“,
„projectName“: „Projekt 006_1“
„task“: „test1“,
„hourRate“: 50,
„breakMinutes“: 15,
„details“: „Das ist ein Test“
}‘
Bestehenden Zeiteintrag updaten
Beim Updaten des Zeiteintrags können Sie alle Parameter des Zeiteintrags-Objekts verwenden, mit Ausnahme folgender Parameter: clientName, projectName, user.
curl -X „PUT“ „https://testkonto.timetrackenterprise.com/api/v2/ext/project_time_entries/1“
-H ‚Content-Type: application/json‘
-H ‚X-TimeTrack-Api-Secret: <API_SECRET_TOKEN>‚
-H ‚X-TimeTrack-Api-Key: <API_KEY>‚
-d $'{
„hourRate“: 35.5,
„notes“: „Test Eintrag für das API“
}‘
Zeiteintrag entfernen
curl -X „DELETE“ „https://testkonto.timetrackenterprise.com/api/v2/ext/project_time_entries/1“
-H ‚Content-Type: application/json‘
-H ‚X-TimeTrack-Api-Secret: <API_SECRET_TOKEN>‚
-H ‚X-TimeTrack-Api-Key: <API_KEY>‚
-d $'{}‘