API

Kunden

Mit diesem Endpoint können Sie:

• Alle Kunden auflisten ohne Filter
• Alle Kunden auflisten mit Filter
• Bestimmten Kunden abrufen
• Neuen Kunden anlegen
• Bestehenden Kunden updaten
• Kunden deaktivieren

Kunden Objekt hat folgende Parameter:

Kunden auflisten ohne Filter

curl „https://testkonto.timetrackenterprise.com/api/v2/ext/clients/“
-H ‚Content-Type: application/json‘
-H ‚X-TimeTrack-Api-Secret: <API_SECRET_TOKEN>‚
-H ‚X-TimeTrack-Api-Key: <API_KEY>‚
-d $'{}‘

Kunden auflisten mit Filter

Folgende Filter können verwendet werden:

In diesem Beispiel fragen wir nach den Kunden die in den Namen Mayer enthalten.

curl „https://testkonto.timetrackenterprise.com/api/v2/ext/clients?name=Mayer“
-H ‚Content-Type: application/json‘
-H ‚X-TimeTrack-Api-Secret: <API_SECRET_TOKEN>‚
-H ‚X-TimeTrack-Api-Key: <API_KEY>‚
-d $'{}‘

Bestimmten Kunden abrufen

Pflichtparameter: ID des Kunden. Im folgenden Beispiel ist die ID 1.

curl „https://testkonto.timetrackenterprise.com/api/v2/ext/clients/1“
-H ‚Content-Type: application/json‘
-H ‚X-TimeTrack-Api-Secret: <API_SECRET_TOKEN>‚
-H ‚X-TimeTrack-Api-Key: <API_KEY>‚
-d $'{}‘

Neuen Kunden anlegen

Beim Anlegen des Kunden können Sie alle Parameter des Kunden Objekts verwenden.

Pflichtparameter: name

curl -X „POST“ „https://testkonto.timetrackenterprise.com/api/v2/ext/clients“
-H ‚Content-Type: application/json‘
-H ‚X-TimeTrack-Api-Secret: <API_SECRET_TOKEN>‚
-H ‚X-TimeTrack-Api-Key: <API_KEY>‚
-d $'{
„name“: „Kunde Herr Mayer“,
„field1“: „UID: DE12345678“
}‘

Bestehenden Kunden updaten

Beim Updaten des Kunden können Sie alle Parameter des Kunden Objekts verwenden, mit Ausnahme folgender Parameter: name, enabled.

curl -X „PUT“ „https://testkonto.timetrackenterprise.com/api/v2/ext/clients/6“
-H ‚Content-Type: application/json‘
-H ‚X-TimeTrack-Api-Secret: <API_SECRET_TOKEN>‚
-H ‚X-TimeTrack-Api-Key: <API_KEY>‚
-d $'{
„email“: „mayer@timetrackapp.com“,
„field2“: „Test“
}‘

Kunden deaktivieren

curl -X „DELETE“ „https://testkonto.timetrackenterprise.com/api/v2/ext/clients/6“
-H ‚Content-Type: application/json‘
-H ‚X-TimeTrack-Api-Secret: <API_SECRET_TOKEN>‚
-H ‚X-TimeTrack-Api-Key: <API_KEY>‚
-d $'{}‘