In diesem Artikel erfahren Sie, wie Sie Zugriffsdaten für die öffentlichen APIs von Personio generieren und verwalten.
Mehr über API-Zugriffsdaten erfahren
APIs ermöglichen es Personio, Daten mit anderen Diensten oder Tools zu teilen. API-Zugriffsdaten funktionieren wie ein Schlüssel. Sie kontrollieren den Informationsfluss und legen fest, was weitergegeben wird. Diese Zugriffsdaten bauen Verbindungen auf und schützen die Kommunikation zwischen Anwendungen.
API-Zugriffsdaten in Personio verwalten
In Personio erstellt das System API-Zugriffsdaten für Folgendes:
-
- Recruiting API
- Integrationen von Personio
- Integrationen von Personio-Partnern
Sie können diese Zugriffsdaten nicht selbst verwalten. Sie können diese Integrationen über den Personio Marketplace aktualisieren. Das System legt die meisten API-Zugriffsrechte auf der Ebene fest, die für eine funktionelle Integration erforderlich ist. In der Regel erstellen und verwalten Sie die API-Zugriffsdaten für individuelle Integrationen manuell. Mitarbeitende können den Marketplace nur nutzen und Integrationen einrichten, wenn sie über Bearbeitungsrechte für die Marketplace-Integration und die API verfügen.
API-Zugriffsdaten für individuelle Integrationen generieren
Personio erstellt automatisch API-Zugriffsdaten für alle Integrationen, außer für individuelle. So generieren Zugriffsdaten für individuelle Integrationen:
- Navigieren Sie zu Marketplace > Verbundene Integrationen.
- Klicken Sie oben rechts auf dem Bildschirm auf Individuelle Integration erstellen.
- Konfigurieren Sie die Einrichtung.
| Zugriffsrechte für die Integration | Leseberechtigungen | Schreibberechtigungen |
| Mitarbeitende |
Gestatten Sie Drittanbietern, Daten aus Personio abzurufen. |
Gestatten Sie Drittanbietern, in Personio Daten zu erstellen und zu aktualisieren. |
| Anwesenheiten |
Gestatten Sie Drittanbietern, Daten aus Personio abzurufen. |
Gestatten Sie Drittanbietern, in Personio Daten zu erstellen, zu aktualisieren und zu löschen. |
| Abwesenheiten |
Gestatten Sie Drittanbietern, Daten aus Personio abzurufen. |
Gestatten Sie Drittanbietern, in Personio Daten zu erstellen und zu aktualisieren. |
| Dokumente |
Gestatten Sie Drittanbietern, Dokumentkategorie-ID's aus Personio abzurufen. |
Gestatten Sie es Drittanbietern, Dokumente in Personio zu erstellen. |
| Individuelle Berichte |
Gestatten Sie Drittanbietern, alle vorhandenen individuellen Berichte aus Personio abzurufen. Aktivieren Sie diese Checkbox, um alle Attribute in einem individuellen Bericht abrufbar zu machen. Dies gilt auch, wenn sie nicht unter Lesbare Mitarbeitenattribute erscheinen. |
Nicht zutreffend. |
| Webhooks |
Rufen Sie Metadaten zum Webhook ab. |
Webhooks erstellen, aktualisieren und löschen. Lese- und Schreibberechtigungen haben keinen Einfluss darauf, ob ein Webhook getriggert wird. Ein Webhook funktioniert auch nach dem Erstellen weiter, unabhängig von der Berechtigungseinstellungen. Erfahren Sie mehr über Webhooks in unserer technischen Dokumentation. |
Verwalten von API-Zugriffsdaten für individuelle Integrationen
So aktualisieren die Zugriffsrechte für individuelle Integrationen:
- Gehen Sie zu Marketplace > Verbundene Integrationen.
- Klicken Sie auf die Integration, die Sie aktualisieren möchten.
- Nehmen Sie Ihre Änderungen im Fenster vor, das nun erscheint.
- Speichern Sie Ihre Einstellungen.
Sie können von hier aus auch die API-Zugriffsdaten zurücksetzen, indem Sie der Anleitung folgen.
Trennen oder deaktivieren API-Zugriffsdaten
- Gehen Sie zu Marketplace > Verbundene Integrationen.
- Klicken Sie in der Spalte Aktion auf die drei Punkte.
- Klicken Sie auf Deaktivieren, um Zugriffsdaten vorübergehend zu deaktivieren.
- Klicken Sie auf Trennen, um die Zugriffsdaten dauerhaft zu löschen.
Auf die technische Dokumentation zugreifen
Die komplette API-Dokumentation, u. a. Informationen über Endpunkte, Webhooks, Datendetails und Tutorials, finden Sie in unserem Developer Hub.. Der Developer Hub ist in zwei Versionen mit unterschiedlichem Inhalt verfügbar. Die Webhook-Informationen sind in Version 2.0 enthalten. Um zwischen den beiden Versionen zu wechseln, klicken Sie auf die Versionsnummer oben auf der Startseite.