Integrationen
API-Schlüssel und die User Provisioning API
Mit der User Provisioning API können Sie Ihr Team programmgesteuert verwalten. Sie können Benutzer einladen, entfernen, Teammitglieder und deren Nutzung auflisten, ausstehende Einladungen auflisten und Buchungen aus Ihren eigenen Systemen erstellen.
Der API-Zugriff wird mit API-Schlüsseln authentifiziert, die der Eigentümer des Workspace unter Einstellungen → API-Schlüssel verwaltet.
Gut zu wissen
Die User Provisioning API wird auf Anfrage aktiviert. Wenn Sie die Seite API-Schlüssel nicht sehen, wenden Sie sich an uns unter contact@onecal.io, um Zugang anzufordern.
Einen API-Schlüssel generieren
- Gehen Sie zu Einstellungen → API-Schlüssel und klicken Sie auf Neuen Schlüssel generieren.
- Geben Sie dem Schlüssel einen Namen, der beschreibt, wofür er verwendet wird.
- Wählen Sie die Zugriffsart: Vollzugriff oder Nur-Lesezugriff. Schlüssel mit Nur-Lesezugriff können keine Änderungen vornehmen.
- Wählen Sie ein Ablaufdatum: 7 Tage, 30 Tage, 90 Tage, 1 Jahr oder nie.
Der Schlüsselwert wird nur einmal angezeigt, direkt nach dem Generieren. Kopieren Sie ihn sofort, Sie können ihn danach nicht mehr einsehen.
Die API verwenden
Senden Sie Ihren Schlüssel im x-api-key-Header. Die Basis-URL lautet:
https://app.onecal.io/api/v1
Die vollständige API-Referenz, einschließlich Authentifizierung, Paginierung, Rate Limits und aller Endpunkte, finden Sie unter apidocs.onecal.io.
Schlüssel überwachen und widerrufen
Die Liste der API-Schlüssel zeigt, wann jeder Schlüssel erstellt wurde, wann er abläuft und wann er zuletzt verwendet wurde, sodass Sie ungenutzte oder ablaufende Schlüssel erkennen können.
Klicken Sie auf Widerrufen, um einen Schlüssel zu deaktivieren. Apps, die diesen Schlüssel verwenden, funktionieren sofort nicht mehr, und das Widerrufen kann nicht rückgängig gemacht werden. Schlüssel eines Benutzers werden außerdem automatisch widerrufen, wenn dieser Benutzer aus dem Team entfernt wird.
