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/holidayscarry: Urlaubsüberträge verwalten


Objekttyp „holidayscarryRow“

Parameter Typ Beschreibung
users_id integer Die ID des zugehörigen Mitarbeiters
year integer Jahr für welches der Übertrag gilt im Format YYYY
count float (nur halbe und ganze Werte erlaubt) Anzahl der Tage
note string|null Notiz

Urlaubsüberträge auflisten

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

Einzelnen Urlaubsübertrag abrufen

Anfrage
GET /api/holidayscarry/[USERS_ID]/[YEAR]
Antwort
{
  "holidayscarryRow": [object of type holidayscarryRow]
}

Urlaubsübertrag anlegen

Anfrage
POST /api/holidayscarry
Pflichtparameter users_id, year, count
Optionale Parameter note
Antwort
{
  "holidayscarryRow": [object of type holidayscarryRow]
}

Urlaubsübertrag bearbeiten

Anfrage
PUT /api/holidayscarry/[USERS_ID]/[YEAR]
Optionale Parameter count, note
Antwort
{
  "holidayscarryRow": [object of type holidayscarryRow]
}

Urlaubsübertrag löschen

Anfrage
DELETE /api/holidayscarry/[USERS_ID]/[YEAR]
Antwort
{
  "success": true
}