API
Die TimeTrack Rest API können Sie nutzen, um TimeTrack mit anderen Systemen zu verbinden.
Mit diesem Endpoint können Sie:
Projekt-Stempeluhr-Objekt hat folgende Parameter:
Feldname | Typ | Beschreibung |
---|---|---|
username | Text | Benutzername |
Text | Eindeutige E-Mail Adresse, eindeutig | |
startedAt | Text | Start Zeitstempel |
workedSeconds | Integer | Gestempelte Arbeitsdauer in Sekunden. Das ist die letzte gespeicherte Dauer. Wenn die Stempeluhr den Status „playing“ hat, muss diese Dauer jedes Mal neu berechnet werden. Formal für die Berechnung: workedSeconds = (CurrentDate – startedAt) – breakSeconds |
breakSeconds | Integer | Gestempelte Pause in Sekunden. Das ist die letze gespeicherte Dauer. Wenn die Stempeluhr den Status „paused“ hat, muss dies Dauer jedes Mal neu berechnet werden. Formal für die Berechnung: breakSeconds = (CurrentDate – startedAt) – workedSeconds |
playing | Boolean | true oder false, 0 oder 1 |
stopped | Boolean | true oder false, 0 oder 1 |
paused | Boolean | true oder false, 0 oder 1 |
clientName | Text | Kundenname |
projectName | Text | Projektname |
taskName | Text | Tätigkeit |
note | Text | Notizen |
Bei der Abfrage der Stempeluhr muss immer ein Datum übergeben werden.
curl „https://testkonto.timetrackenterprise.com/api/v2/ext/project_timer?username=hansm&date=2020-10-23T16:00:00.000Z“
-H ‚Content-Type: application/json‘
-H ‚X-TimeTrack-Api-Secret: <API_SECRET_TOKEN>‚
-H ‚X-TimeTrack-Api-Key: <API_KEY>‚
-d $'{}‘
Beim Start der Stempeluhr müssen folgende Daten übergeben werden: date, clientName, projectName, username
curl -X „POST“ „https://testkonto.timetrackenterprise.com/api/v2/ext/project_timer/start“
-H ‚Content-Type: application/json‘
-H ‚X-TimeTrack-Api-Secret: <API_SECRET_TOKEN>‚
-H ‚X-TimeTrack-Api-Key: <API_KEY>‚
-d $'{
„username“: „hansm“,
„clientName“: „Kunde 006“,
„projectName“: „Projekt 006_1“,
„date“: „2020-10-23T15:00:00.000Z“
}‘
Beim Pausieren der Stempeluhr müssen folgende Daten übergeben werden: date, username
curl -X „POST“ „https://testkonto.timetrackenterprise.com/api/v2/ext/project_timer/pause“
-H ‚Content-Type: application/json‘
-H ‚X-TimeTrack-Api-Secret: <API_SECRET_TOKEN>‚
-H ‚X-TimeTrack-Api-Key: <API_KEY>‚
-d $'{
„date“: „2020-10-23T15:30:00.000Z“,
„username“: „hansm“
}‘
Beim Fortsetzen der Stempeluhr müssen folgende Daten übergeben werden: date, username
curl -X „POST“ „https://testkonto.timetrackenterprise.com/api/v2/ext/project_timer/resume“
-H ‚Content-Type: application/json‘
-H ‚X-TimeTrack-Api-Secret: <API_SECRET_TOKEN>‚
-H ‚X-TimeTrack-Api-Key: <API_KEY>‚
-d $'{
„date“: „2020-10-23T15:30:00.000Z“,
„username“: „hansm“
}‘
Beim Stoppen der Stempeluhr müssen folgende Daten übergeben werden: date, username
curl -X „POST“ „https://testkonto.timetrackenterprise.com/api/v2/ext/project_timer/stop“
-H ‚Content-Type: application/json‘
-H ‚X-TimeTrack-Api-Secret: <API_SECRET_TOKEN>‚
-H ‚X-TimeTrack-Api-Key: <API_KEY>‚
-d $'{
„date“: „2020-10-23T15:30:00.000Z“,
„username“: „hansm“
}‘
Arbeitszeit-Stempeluhr-Objekt hat folgende Parameter:
Feldname | Typ | Beschreibung |
---|---|---|
id | Integer | ID |
user | Text | Benutzername |
latitudeStart | Number | Start GPS Koordinaten – Latitude |
longitudeStart | Number | Start GPS Koordinaten – Longitude |
latitudeEnd | Number | Stop GPS Koordinaten – Latitude |
latitudeEnd | Number | Stop GPS Koordinaten – Longitude |
from | Text | Start Zeitstempel |
to | Text | End Zeitstempel |
workedMinutes | Integer | Dauer der Arbeit in Minuten |
breakMinutes | Integer | Dauer der Pause in Minuten |
manual | Boolean | Manuel angelegt oder nicht |
notes | Text | Notizen |
Bei der Abfrage der Stempeluhr muss immer ein Datum übergeben werden.
curl „https://testkonto.timetrackenterprise.com/api/v2/ext/attendance_timer?username=hansm&date=2020-10-23T16:00:00.000Z“
-H ‚Content-Type: application/json‘
-H ‚X-TimeTrack-Api-Secret: <API_SECRET_TOKEN>‚
-H ‚X-TimeTrack-Api-Key: <API_KEY>‚
-d $'{}‘
Beim Start der Stempeluhr müssen folgende Daten übergeben werden: date, username
curl -X „POST“ „https://testkonto.timetrackenterprise.com/api/v2/ext/attendance_timer/start“
-H ‚Content-Type: application/json‘
-H ‚X-TimeTrack-Api-Secret: <API_SECRET_TOKEN>‚
-H ‚X-TimeTrack-Api-Key: <API_KEY>‚
-d $'{
„username“: „hansm“,
„date“: „2020-10-23T15:00:00.000Z“
}‘
Beim Stop der Stempeluhr müssen folgende Daten übergeben werden: date, username
curl -X „POST“ „https://testkonto.timetrackenterprise.com/api/v2/ext/attendance_timer/stop“
-H ‚Content-Type: application/json‘
-H ‚X-TimeTrack-Api-Secret: <API_SECRET_TOKEN>‚
-H ‚X-TimeTrack-Api-Key: <API_KEY>‚
-d $'{
„username“: „hansm“,
„date“: „2020-10-23T15:00:00.000Z“
}‘