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/overtimecarry: Überstundenüberträge verwalten


Objekttyp „overtimecarryRow“

Parameter Typ Beschreibung
users_id integer Die ID des zugehörigen Mitarbeiters
year integer Jahr für welches der Übertrag gilt im Format YYYY
hours float Anzahl der Stunden
note string|null Notiz

Überstundenüberträge auflisten

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

Einzelnen Überstundenübertrag abrufen

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

Überstundenübertrag anlegen

Anfrage
POST /api/overtimecarry
Pflichtparameter users_id, year, hours
Optionale Parameter note
Antwort
{
  "overtimecarryRow": [object of type overtimecarryRow]
}

Überstundenübertrag bearbeiten

Anfrage
PUT /api/overtimecarry/[USERS_ID]/[YEAR]
Optionale Parameter hours, note
Antwort
{
  "overtimecarryRow": [object of type overtimecarryRow]
}

Überstundenübertrag löschen

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