API Authentifizierung

Diese Seite beschreibt, wie mit dem Calenso API kommuniziert werden kann.

📖 Voraussetzungen

• Du hast eine Enterprise Calenso-Lizenz

• Du hast das "API-Keys"-Modul lizenziert

• Du hast Zugriff auf die Swagger API-Docs unter https://apidocs.calenso.com/. Die Anmeldedaten bekommst du von deinem Calenso Projekt-Manager.

🔐 API-Key generieren

Navigiere zu https://dashboard.calenso.com/app/settings/manage-api-keys und klicke auf "Generieren".

Definiere, welche Rolle der API-Key haben soll und klicke auf "Speichern".

Anschliessend kannst du dir den Key über die 3 Punkte "Kopieren" lassen. Er sollte mit x-calenso-.... anfangen.

▶️ API aufrufen

Damit dein API-Request authentifiziert werden kann, musst du für jeden Request den folgenden Header setzen:

Key: X-Api-Key

Value: [dein generierter API-Key]

Calenso unterstützt momentan noch verschiedene Auth-Anbieter (u.a. Auth0). Damit die korrekte Authorisierungslösung greift, benötigt es in einer Übergangsphase noch den folgenden Header.

Key: X-Calenso-Auth

Value: true

Beispiel:

X-Api-Key: xcalenso-8faccd4c-6b87-4289-xxxx-f756e04a08a1

X-Calenso-Auth: true

📋 API Endpunkte

• PROD: https://my.calenso.com/api/v1/

• Entwicklungssystem für Kunden: https://api.calenso.io/api/v1/

• Entwicklungssystem für Calenso: https://dev.my.calenso.com/api/v1/