API
Die TimeTrack Rest API können Sie nutzen, um TimeTrack mit anderen Systemen zu verbinden.
Projekte
Mit diesem Endpoint können Sie:
- Alle Projekte auflisten ohne Filter
- Alle Projekte auflisten mit Filter
- Bestimmtes Projekt abrufen
- Neues Projekt anlegen
- Bestehendes Projekt updaten
- Projekt deaktivieren
Projekt Objekt hat folgende Parameter:
| Feldname | Typ | Beschreibung |
|---|---|---|
| ID | Integer | ID |
| projectName | Text | Name des Projektes |
| clientName | Text | Name des Kunden |
| projectEnabled | Boolean | Projekt ist aktiviert oder deaktiviert. |
| notes | Text | Notizen |
| hourRate | Number | Stundensatz |
| timeEstimated | Number | Geplante Gesamtdauer des Projektes |
| budgetEstimated | Number | Geplantes Budget des Projektes |
Projekte auflisten ohne Filter
curl „https://testkonto.timetrackenterprise.com/api/v2/ext/projects/“
-H ‚Content-Type: application/json‘
-H ‚X-TimeTrack-Api-Secret: <API_SECRET_TOKEN>‚
-H ‚X-TimeTrack-Api-Key: <API_KEY>‚
-d $'{}‘
Projekte auflisten mit Filter
Folgende Filter können verwendet werden:
| Feldname | Typ | Beschreibung |
|---|---|---|
| projectName | Text | Wird als Teilstring interpretiert. |
| clientName | Text | Wird als Teilstring interpretiert. |
In diesem Beispiel fragen wir nach den Projekten, die in den Projektnamen Test enthalten.
curl „https://testkonto.timetrackenterprise.com/api/v2/ext/projects?projectName=Test“
-H ‚Content-Type: application/json‘
-H ‚X-TimeTrack-Api-Secret: <API_SECRET_TOKEN>‚
-H ‚X-TimeTrack-Api-Key: <API_KEY>‚
-d $'{}‘
Bestimmtes Projekt abrufen
Pflichtparameter: ID des Projektes. Im folgenden Beispiel ist die ID 1.
curl „https://testkonto.timetrackenterprise.com/api/v2/ext/projects/1“
-H ‚Content-Type: application/json‘
-H ‚X-TimeTrack-Api-Secret: <API_SECRET_TOKEN>‚
-H ‚X-TimeTrack-Api-Key: <API_KEY>‚
-d $'{}‘
Neues Projekt anlegen
Beim Anlegen des Projektes können Sie alle Parameter des Projekt Objekts verwenden.
Pflichtparameter: clientName, projectName
curl -X „POST“ „https://testkonto.timetrackenterprise.com/api/v2/ext/projects“
-H ‚Content-Type: application/json‘
-H ‚X-TimeTrack-Api-Secret: <API_SECRET_TOKEN>‚
-H ‚X-TimeTrack-Api-Key: <API_KEY>‚
-d $'{
„projectName“: „Test Projekt 001“,
„clientName“: „Test GmbH“
}‘
Bestehendes Projekt updaten
Beim Updaten des Projektes können Sie alle Parameter des Projekt Objekts verwenden. Erinnerung: Der Kundenname muss mit einem bestehenden Kunden übereinstimmen.
curl -X „PUT“ „https://testkonto.timetrackenterprise.com/api/v2/ext/projects/1“
-H ‚Content-Type: application/json‘
-H ‚X-TimeTrack-Api-Secret: <API_SECRET_TOKEN>‚
-H ‚X-TimeTrack-Api-Key: <API_KEY>‚
-d $'{
„hourRate“: „50“,
„notes“: „Test Projekt fuer API“
}‘
Projekt deaktivieren
curl -X „DELETE“ „https://testkonto.timetrackenterprise.com/api/v2/ext/projects/1“
-H ‚Content-Type: application/json‘
-H ‚X-TimeTrack-Api-Secret: <API_SECRET_TOKEN>‚
-H ‚X-TimeTrack-Api-Key: <API_KEY>‚
-d $'{}‘