TerraBytes.Personio.SDK

Dieser Client stellt eine typsichere, strukturierte Anbindung an die Personio REST API v1 zur Verfügung. Ziel ist eine vollständige Integration aller API-Endpunkte mit übersichtlicher Struktur, konfigurierbarer Authentifizierung und sauberem Paging- und Fehlerverhalten.

Struktur

Projekte

Personio.Api.Client: Enthält alle HTTP-Clients, DTOs, Konfigurationsmodelle und Endpunktdefinitionen

Personio.Api.XafBridge (optional): Adapter für DevExpress XAF-Objektspeicherung

Hauptklassen (Clients)

EmployeeClient: Zugriff auf Mitarbeitende (/v1/company/employees)

TimeOffClient: Zugriff auf Abwesenheiten (/v1/company/time-offs)

TimeOffTypeClient: Zugriff auf Abwesenheitstypen (/v1/company/time-off-types)

AttendanceClient: Zugriff auf An- und Abwesenheiten

AbsencePeriodClient: Zugriff auf Zeiträume

DocumentCategoryClient: Zugriff auf Dokumentenkategorien

Serviceklasse

PersonioDataFetchService: Koordiniert den sequentiellen Abruf aller Personio-Daten, verwendet die einzelnen Clients


Authentifizierung

Die Authentifizierung erfolgt über ClientId und ClientSecret. Die Klasse PersonioAuthService verwaltet das Token und aktualisiert es automatisch.

Header:

Authorization: Bearer {token}

X-Personio-Partner-ID

X-Personio-App-ID

Proin bibendum

Curabitur ut egestas justo, vitae molestie ante. Integer magna purus, commodo in diam nec, pretium auctor sapien.

Curabitur sed iaculis dolor, non congue ligula. Maecenas imperdiet ante eget hendrerit posuere. Nunc urna libero, congue porta nibh a, semper feugiat sem.