Dieser Artikel bietet eine Einführung in Personios öffentliche APIs, Webhooks und den Developer Hub. APIs ermöglichen es Softwareanwendungen, zu interagieren und Daten auszutauschen. Personios öffentliche APIs ermöglichen den Datenaustausch zwischen Personio und anderen Diensten oder Tools. Sie stellen Endpunkte bereit, um Daten aus Ihrem Personio-Account abzurufen und zu bearbeiten.
Tipp:
Der Developer Hub ist die zentrale Anlaufstelle für Informationen zu den APIs und Webhooks von Personio.
Öffentliche Personio APIs aufrufen
Informationen zu den öffentlichen APIs und Webhooks von Personio finden Sie im Developer Hub. Das ist die zentrale Anlaufstelle für Informationen zu Personios APIs und Webhooks und dient als zentrale Ressource für eine detaillierte Dokumentation.
Versionen der öffentlichen Personio APIs
Personio bietet zwei Versionen von APIs mit unterschiedlichen API-Endpunkten:
- v1-APIs pflegen bestehende Integrationen und gewährleisten so Stabilität und umfassende Funktionalität.
- v2-APIs führen neue Funktionen ein und erweitern die Integrationsmöglichkeiten.
Beide API-Versionen arbeiten zusammen, um Ihnen mehr Funktionen und eine bessere Stabilität zu bieten. Sie können dieselben API-Zugriffsdaten sowohl für v1 als auch für v2 verwenden. Sie müssen sich nicht separat registrieren oder neue Zugriffsdaten generieren, um v2 zu verwenden. Die v2-API befindet sich derzeit in der Beta-Phase. Die Endpunkte sind verfügbar, befinden sich aber noch in der aktiven Entwicklung.
Beispiele für v1- und v2-APIs
Hinweis:
Am 31. Januar 2027 stellen wir bestimmte v1-API-Endpunkte für Anwesenheiten und Projekte ein. Nur diese Endpunkte werden außer Betrieb genommen. Alle anderen v1-Endpunkte bleiben weiterhin verfügbar. Sie können unter Einstellungen > Sicherheit & Integrationen > API-Zugriffsdaten feststellen, ob dies Auswirkungen auf Ihren Account hat, indem Sie Ihre aktiven API-Zugriffsdaten überprüfen. Falls Ihre individuelle Integration diese Endpunkte verwendet, bitten Sie Ihr IT-Team, auf die entsprechenden v2-Endpunkte zu migrieren.
- Anwesenheiten: Ersetzen Sie die Aufrufe des v1-Anwesenheiten-Endpunkts durch /v2/attendance-periods.
- Projekte: Ersetzen Sie die Aufrufe des v1-Projekte-Endpunkts durch /v2/projects.
Vollständige technische Details finden Sie im Developer Hub.
Die nachstehende Tabelle zeigt Beispiele der in den beiden Versionen verfügbaren APIs. Eine vollständige Liste der API-Funktionen und -Endpunkte finden Sie im Developer Hub.
| API-Version | API | Beispielhafte Funktionen |
|---|---|---|
v1 |
Personen |
|
v1 |
Abwesenheit |
|
v2 |
Anwesenheiten |
|
v2 |
Projekte |
|
v2 |
Dokumentenverwaltung: |
|
v2 |
Beschäftigungen |
|
v2 |
Stelle |
|
v2 |
Gehaltsbänder |
|
v2 |
Berichte |
|
API-Zugriffsdaten
Erfahren Sie mehr darüber, wie Sie API-Anmeldedaten für Personaldaten erstellen und verwalten. Beachten Sie, dass Sie zum Erstellen einer eigenen individuellen Integration mithilfe unserer öffentlichen API den Personio Plan CorePro benötigen.
Webhooks
Webhooks sind ein spezieller Teil der öffentlichen Personio-APIs. Webhooks senden Daten von Personio an Ihre App oder Datenbank, wenn bestimmte Events eintreten. Eine vollständige Liste der Webhooks und Details zu ihrer Funktionsweise finden Sie im Developer Hub (v2).
Der Developer Hub
Der Developer Hub bietet die neuesten Informationen zu den öffentlichen APIs und Webhooks von Personio. Der Developer Hub hat zwei Versionen:
- Der Developer Hub (v1) unterstützt bestehende APIs.
- Der Developer Hub (v2) führt neue APIs und Webhooks ein.
Um auf die v2 OpenAPI-Dateien zuzugreifen, rufen Sie die Seite developer.personio.de/openapi auf.
Mehr Informationen