REST-API

Die clockodo-API ermöglicht die Anbindung von clockodo an andere Systeme. Rechnungs- und Projektmanagement-Anwendungen oder eigene Shell-Skripte sind Beispiele für nützliche Mash-Ups mit clockodo.

api/users: Mitarbeiter verwalten


Objekttyp „user“

Parameter Typ Beschreibung
id integer Die ID des Mitarbeiters
name string Der Name des Mitarbeiter
number string Personalnummer
email string Die E-Mail-Adresse des Mitarbeiters
role string Die Rolle des Mitarbeiters
active boolean Ist der Mitarbeiter aktiviert?
edit_lock date (YYYY-MM-DD) Aktive Bearbeitungssperre für den Mitarbeiter

Mitarbeiter auflisten

Anfrage
GET /api/users
Antwort
{
  "users": 
  {
    [object of type user],
    [object of type user], ...
  }
}

Einen Mitarbeiter abrufen

Anfrage
GET /api/users/[ID]
Antwort
{
  "user": [object of type user]
}

Mitarbeiter anlegen

Anfrage
POST /api/users
Notwendige Parameter name, number, email, role
Optionale Parameter keine
Antwort
{
  "user": [object of type user]
}

Mitarbeiter bearbeiten

Anfrage
PUT /api/users/[ID]
Notwendige Parameter keine
Optionale Parameter name, number, active, role
Antwort
{
  "user": [object of type user]
}

Mitarbeiter deaktivieren

Anfrage
DELETE /api/users/[ID]
Antwort
{
  "user": [object of type user]
}