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