Die TimeTrack Rest API können Sie nutzen, um TimeTrack mit anderen Systemen zu verbinden.
Lieber Entwickler, Sie können TimeTrack API nutzen, um auf bestimmte Ressourcen in Ihrem TimeTrack Enterprise Konto zuzugreifen bzw. dieselben zu verwalten.
Aktuell können Sie folgende Ressourcen verwalten:
Die API wird laufend weiterentwickelt und bekommt laufend neue Ressourcen. Die Beispiele der API Aufrufe werden in Shell (als CURL) geführt.
Falls Sie Inkonsistenzen merken oder Fragen haben, kontaktieren Sie uns unter support AT timetrackenterprise.com
Viel Spaß beim Coden wünscht Ihnen Ihr TimeTrack Team!
TimeTrack verwendet App Key und App Secret für die Authentifizierung. Sie können bei Ihrem Konto in den Einstellungen / Allgemein / API den AppKey und die AppSecret holen. Diese verwenden Sie bei jedem Request wie im folgendem Beispiel:
curl „<ENDPOINT_URL>“ -H ‚Content-Type: application/json‘ -H ‚X-TimeTrack-Api-Secret: <APP_SECRET_TOKEN>‚ -H ‚X-TimeTrack-Api-Key: <APP_KEY>‚
ApiKey wird für Sie einmalig automatisch generiert. ApiSecret können Sie jederzeit neu generieren lassen.
<APP_SECRET_TOKEN> müssen Sie durch Ihr AppSecret aus der Web-App / Einstellungen / Allgemein / API ersetzen.
<APP_KEY> müssen Sie durch Ihr AppKey aus der Web-App / Einstellungen / Allgemein / API ersetzen.
In den folgenden Beispielen wird TESTKONTO als Beispielskonto verwendet. Verwenden Sie Ihren Kontonamen für die Abfragen.
Beim Lese-Zugriff auf die Ressourcen werden die Ressourcen in Seiten ausgegeben. Wenn Sie keine Seite bzw. das Limit übergeben werden maximal 50 Datensätze zurückgegeben.
Sie können das Paging mit 2 Parameter steuern, „page_number“ (0 bis unendlich) und „limit“ (0 bis 1000). Diese übergeben Sie ganz normal zu den anderen Filter parameter. Für Limit können Sie maximal 1000 eintragen.
Alle Requests sind in JSON format.
Datumsformat ist YYYY-MM-DD. Beispiele: 2020-10-23, 2020-01-01
Zeitstempel YYYY-MM-DDTHH:MM:SSZ. Beispiele 2020-10-23T14:30:00Z, 2020-10-23T00:00:00.000Z
Zahlenformat, z.B. der Stundensatz 20.5.
Booleans, z.B. true oder false, 1 oder 0
Fehlermeldungen kommen im folgenden Format zurück:
{ „errors“: [ { „title“: „TimeEntry exist but it is deleted“, „status“: 404, „code“: 15020, „detail“: „TimeEntry is deleted and can not be used.“ } ] }
Titel gibt die Fehlermeldung für das Objekt, das betroffen ist.
Status Codes:
Code ist interner Fehlermeldung-Code, für die interne Fehlerüberprüfung. Diesen Code können Sie uns bei Problemen weitergeben.
Detail: gibt mehr Details über die Fehlermeldung, falls vorhanden.
Aktuell sind die APIs auf 30 Requests pro Minute limitiert. Bei On-Premise Kunden sind diese Limitierungen einstellbar.
