API

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:

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:

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