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/holidaysquota: Urlaubskontingente verwalten


Objekttyp „holidaysquotaRow“

Parameter Typ Beschreibung
id integer Die ID der Urlaubskontingent-Einstellung
users_id integer Die ID des zugehörigen Mitarbeiters
year_since integer Jahr ab welchem das Urlaubskontingent gilt im Format YYYY
year_until integer Jahr bis zu welchem das Urlaubskontingent gilt im Format YYYY
count float (nur halbe und ganze Werte erlaubt) Anzahl der Urlaubstage

Urlaubskontingente auflisten

Anfrage
GET /api/holidaysquota
Optionale Parameter users_id (integer) Benutzer auf welchen eingeschränkt werden soll
Antwort
{
  "holidaysquota": 
  {
    [object of type holidaysquotaRow],
    [object of type holidaysquotaRow], 
    ...
  }
}

Einzelnes Urlaubskontingent abrufen

Anfrage
GET /api/holidaysquota/[ID]
Antwort
{
  "holidaysquotaRow": [object of type holidaysquotaRow]
}

Urlaubskontingent anlegen

POST /api/holidaysquota
Pflichtparameter users_id, year_since, count
Optionale Parameter year_until
Antwort
{
  "holidaysquotaRow": [object of type holidaysquotaRow]
}

Urlaubskontingent bearbeiten

PUT /api/holidaysquota/[ID]
Optionale Parameter year_since, year_until, count
Antwort
{
  "holidaysquotaRow": [object of type holidaysquotaRow]
}

Urlaubskontingent löschen

DELETE /api/holidaysquota/[ID]
Antwort
{
  "success": true
}