Authorization-Header enthalten. Tokens sind an die Organisation gebunden, in der sie erstellt wurden. Der verwendete Token bestimmt daher, welche Organisationsdaten zurückgegeben werden.
Einen API-Token erstellen
Eigentümer und Administratoren der Organisation können API-Tokens in ClearPolicy erstellen.1
API-Einstellungen öffnen
Gehe im ClearPolicy-Dashboard zu Einstellungen -> API.
2
Einen Token erstellen
Klicke auf API-Token erstellen. Gib dem Token einen klaren Namen, zum Beispiel
Berichtsautomatisierung, damit dein Team weiß, wofür er verwendet wird.3
Den Bearer-Token kopieren
Kopiere den Token, wenn ClearPolicy ihn anzeigt. Nachdem du den Dialog geschlossen hast, kannst du den vollständigen Token nicht erneut anzeigen.
4
Sicher speichern
Speichere den Token in deinem Passwortmanager, Secret-Manager oder in den Einstellungen deiner Integration. Teile ihn nicht per E-Mail, Chat oder öffentlichem Code.
Das Token in Anfragen übergeben
Füge das Token in denAuthorization-Header jeder API-Anfrage ein:
Fehlerantworten
Tokens sind organisationsspezifisch. Alle API-Antworten spiegeln die Organisation wider, in der das Token erstellt wurde.
Der API-Zugriff richtet sich außerdem nach der Rolle des Teammitglieds in ClearPolicy. Eigentümer und Administratoren können API-Tokens erstellen und verwalten. Tokens, die an Gruppenleitende gebunden sind, können den Token mit
GET /me bestätigen, aber Endpunkte für Personen, Dokumente und Bestätigungsanfragen geben 403 Forbidden zurück.