In diesem Artikel erfahren Sie, wie Sie Zugriffsdaten für die öffentlichen APIs von Personio generieren und verwalten. APIs ermöglichen es Personio, Daten mit anderen Diensten oder Tools zu teilen. API-Zugriffsdaten fungieren wie ein Schlüssel, der den Informationsfluss steuert und entscheidet, was geteilt wird.
Bevor Sie beginnen
- Um den Marketplace zu nutzen und Integrationen einzurichten, benötigen Sie Bearbeitungsrechte für die Marketplace-Integration und die API.
- Personio erstellt automatisch API-Zugriffsdaten für alle Integrationen, außer für individuelle.
Mehr über API-Zugriffsdaten erfahren
API-Zugriffsdaten bauen Verbindungen auf und schützen die Kommunikation zwischen Anwendungen. 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-Berechtigungen 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.
API-Zugriffsdaten für individuelle Integrationen generieren
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.
Hinweis:
Schreibberechtigungen schließen keinen Lesezugriff ein. Wenn Sie Daten über unsere APIs abrufen möchten, müssen Sie auch Leseberechtigungen gewähren.
| Integrationsberechtigungen | Leseberechtigungen | Schreibberechtigungen |
| Import von Mitarbeitenden |
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. |
| Abwesenheit |
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 in unserer technischen Dokumentation mehr über Webhooks. |
API-Zugriffsdaten für individuelle Integrationen aktualisieren
So aktualisieren Sie die Berechtigungen 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.
API-Zugriffsdaten für individuelle Integrationen trennen oder deaktivieren
So trennen oder deaktivieren Sie API-Zugriffsdaten für individuelle Integrationen:
- 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 gesamte API-Dokumentation finden Sie in unserem Developer Hub. Dazu gehören Endpunkte, Webhooks, Datendetails und Tutorials. 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.