Mit der API authentifizieren
Um die REST-API nutzen zu können, ist eine Authentifizierung mit einem API-Token erforderlich.
API aktivieren
Der API-Token kann in campflow über das Zahnrad-Symbol und anschließendem Klick auf “API-Zugang” abgerufen werden. Bei erstmaliger Nutzung der API musst du auf “Zugang aktivieren” klicken.
Der Token wird dir nur einmalig, direkt nach der Generierung, angezeigt und läuft niemals aus.
Token bei Anfragen übergeben
Um den Token zu übergeben, muss er als Bearer Token im Authorization
Header deiner REST-API-Anfrage enthalten sein. Hier ist ein Beispiel:
Authorization: Bearer <dein_api_token>
Fehlt der Token oder ist ungültig, wird ein 401 Statuscode zurückgegeben.
Token erneuern
Tokens laufen nicht automatisch ab, können aber jederzeit zurückgezogen oder erneuert werden.
Wenn du einen neuen Token generieren möchtest, klicke einfach auf “API Token neu generieren”. Dadurch wird dein bisheriger Token ungültig und es wird ein neuer Token ausgestellt.
Wenn du den aktuellen Token deaktivieren möchtest, klicke auf “Zugang deaktivieren”. Dadurch wird lediglich der aktuelle Token deaktiviert und der API-Zugriff wird sofort geschlossen. Du kannst die API jederzeit wieder erneut aktivieren.