Für die API benötigst du ein Plus-Abonnement. Siehe Plan-Feature-Matrix. Wenn du noch keines hast, schließe zuerst ein Abonnement ab, damit du einen API-Schlüssel erstellen kannst.
Schritt 1: API-Schlüssel abrufen
Jede Anfrage braucht einen API-Schlüssel. Ohne ihn lehnt die API den Aufruf ab. Melde dich im absentify Dashboard an und erstelle einen Schlüssel. Wenn du dich per E-Mail registriert hast, bestätige zuerst deine Adresse. Unter Authentication steht, wie du den Schlüssel sendest.Schritt 2: Authentifizierung einrichten
Sende den Schlüssel bei jeder Anfrage:- Header-Name:
x-api-key - Header-Wert: Dein API-Schlüssel
Schritt 3: Erste Anfrage senden
GET /requests listet Abwesenheitsanfragen, die sich mit einem Zeitraum überschneiden. start und end sind Pflichtfelder.
"your_api_key_here" durch den Schlüssel aus Schritt 1. Dieses Beispiel gibt alle Anfragen zurück, die sich mit dem Juni 2026 überschneiden.
Datums- und Zeitformat
Viele Endpunkte akzeptieren Datums- oder Zeitparameter, zum Beispiel die Pflichtfelderstart und end beim Abrufen von Anfragen oder Abwesenheiten sowie employment_start_date und birthday beim Erstellen eines Benutzers.
Sende Datums- und Zeitwerte immer im Format ISO 8601:
Wenn du eine Uhrzeit sendest, gib immer eine Zeitzonenangabe an (
Z für UTC oder einen Offset wie +02:00). Ein Wert ohne Zeitzonenangabe wird in der Zeitzone des Servers interpretiert und kann das Ergebnis verschieben.
Datums- und Zeitwerte in API-Antworten werden ebenfalls im ISO-8601-Format mit dem UTC-Suffix Z zurückgegeben, zum Beispiel 2026-06-01T00:00:00.000Z.
end ist einschließlich. start=2026-06-01&end=2026-06-30 gibt alle Einträge zurück, die sich mit dem Juni überschneiden, einschließlich Abwesenheiten am 30. Juni.
Für /requests, /requests_per_day und /absences_per_day darf der Zeitraum start…end höchstens 1826 Tage (5 Jahre) umfassen. Größere oder umgekehrte Zeiträume geben 400 zurück. Rufe längere Zeiträume nacheinander in kleineren Abschnitten ab. Details findest du unter Limits.
Nach Benutzer oder Abteilung filtern
Listen-Endpunkte wie/requests, /requests_per_day und /absences_per_day akzeptieren die optionalen Filter request_member_ids und department_ids.
Übermittle mehrere IDs als kommagetrennte Zeichenfolge, zum Beispiel department_ids=dept1,dept2. Semikolons (;) werden aus Gründen der Abwärtskompatibilität ebenfalls akzeptiert.
locale an, zum Beispiel locale=de. Siehe Lokalisierte Namen.
Nächste Schritte
- Unter Limits findest du das Ratenlimit und die Obergrenze für Datumsbereiche.
- Unter Responses stehen Erfolg- und Fehlerantworten.
- Die Introduction erklärt Kontingente und lokalisierte Namen.