API
Die TimeTrack Rest API können Sie nutzen, um TimeTrack mit anderen Systemen zu verbinden.
Mit diesem Endpoint können Sie:
Ausgaben-Objekt hat folgende Parameter:
Feldname | Typ | Beschreibung |
---|---|---|
ID | Integer | ID |
user | Text | Benutzername |
clientName | Text | Kundenname |
projectName | Text | Projektname |
name | Text | Ausgabenname |
price | Number | Preis |
quantity | Integer | Anzahl / Stück / Menge |
billable | Boolean | Verrechenbar oder nicht |
payType | Text | Bezahlart, z.B. Kreditkarte, Bar |
details | Text | Notizen |
tags | Text | Hashtags |
date | Text | Zeitstempel der Erfassung – Format: YYYY-MM-DDTHH:MM:SS.fffZ, Beispiel: 2020-10-20T09:00:00.000Z |
curl “https://testkonto.timetrackenterprise.com/api/v2/ext/expenses/”
-H ‘Content-Type: application/json’
-H ‘X-TimeTrack-Api-Secret: <API_SECRET_TOKEN>‘
-H ‘X-TimeTrack-Api-Key: <API_KEY>‘
-d $'{}’
Folgende Filter können verwendet werden:
Feldname | Typ | Beschreibung |
---|---|---|
name | Text | Bezeichnung der Ausgabe / Ausgabenname |
projectName | Text | Projektname |
clientName | Text | Kundenname |
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 Ausgaben des Benutzers “hansm” zwischen 01.10.2020 und 23.10.2020.
curl “https://testkonto.timetrackenterprise.com/api/v2/ext/expenses?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 $'{}’
Pflichtparameter: ID der Ausgabe. Im folgenden Beispiel ist die ID 1.
curl “https://testkonto.timetrackenterprise.com/api/v2/ext/expenses/1”
-H ‘Content-Type: application/json’
-H ‘X-TimeTrack-Api-Secret: <API_SECRET_TOKEN>‘
-H ‘X-TimeTrack-Api-Key: <API_KEY>‘
-d $'{}’
Beim Anlegen der Ausgabe können Sie alle Parameter des Ausgaben-Objekts verwenden.
Pflichtparameter: clientName, projectName, user, name, quantity, price, date
curl -X “POST” “https://testkonto.timetrackenterprise.com/api/v2/ext/expenses”
-H ‘Content-Type: application/json’
-H ‘X-TimeTrack-Api-Secret: <API_SECRET_TOKEN>‘
-H ‘X-TimeTrack-Api-Key: <API_KEY>‘
-d $'{
“quantity”: 1,
“price”: 25.5,
“clientName”: “Kunde 006”,
“date”: “2020-10-20T10:00:00.000Z”,
“username”: “hansm”,
“projectName”: “Projekt 006_1”,
“name”: “Ticket”
}’
Beim Updaten der Ausgabe können Sie alle Parameter des Ausgaben-Objekts verwenden, mit Ausnahme folgender Parameter: clientName, projectName, user, name.
curl -X “PUT” “https://testkonto.timetrackenterprise.com/api/v2/ext/expenses/1”
-H ‘Content-Type: application/json’
-H ‘X-TimeTrack-Api-Secret: <API_SECRET_TOKEN>‘
-H ‘X-TimeTrack-Api-Key: <API_KEY>‘
-d $'{
“price”: 35.5,
“notes”: “Test Ausgabe für das API”
}’
curl -X “DELETE” “https://testkonto.timetrackenterprise.com/api/v2/ext/expenses/1”
-H ‘Content-Type: application/json’
-H ‘X-TimeTrack-Api-Secret: <API_SECRET_TOKEN>‘
-H ‘X-TimeTrack-Api-Key: <API_KEY>‘
-d $'{}’