API

Die TimeTrack Rest API können Sie nutzen, um TimeTrack mit anderen Systemen zu verbinden. 

Ausgaben

Mit diesem Endpoint können Sie:

  • Alle Ausgaben auflisten ohne Filter
  • Alle Ausgaben auflisten mit Filter
  • Bestimmte Ausgabe abrufen
  • Neue Ausgabe anlegen
  • Bestehende Ausgabe updaten
  • Ausgabe entfernen

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

Ausgaben auflisten ohne Filter

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

Ausgaben auflisten mit Filter

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

Bestimmte Ausgabe abrufen

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

Neue Ausgabe anlegen

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“
}‘

Bestehende Ausgabe updaten

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“
}‘

Ausgabe entfernen

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

Ressourcen