Die Erstellung eines Zugriffstokens ist ein unkomplizierter Prozess, der Anwendungen oder Skripten die Möglichkeit gibt, mit deinem Konto zu interagieren. Im Folgenden findest du eine schrittweise Anleitung zur Erstellung eines Zugriffstokens:
Suche das Benutzermenü:
Navigiere zunächst in die linke untere Ecke des Dashboards, wo du das Benutzermenü findest. Das wird normalerweise durch deinen Avatar dargestellt.
Rufe die Seite "Zugriffstoken" auf:
Suche im Benutzermenü nach einem Menüpunkt mit der Bezeichnung "Access Tokens" und klicke darauf. Dadurch gelangst du auf die Seite, auf der du Zugangstoken verwalten oder neu erstellen kannst.
Formular zur Token-Erstellung öffnen:
Suche auf der Seite "Zugangstoken" die Schaltfläche "Token erstellen" und klicke darauf, um den Prozess der Erstellung eines neuen Zugangstokens zu starten.
Konfigurieren des Tokens:
Du wirst aufgefordert, einen Namen für Ihr neues Zugangstoken einzugeben. Wählen Sie einen Namen, der beschreibend ist und Ihnen hilft, sich an den Zweck des Tokens zu erinnern.
Lege als Nächstes die Gültigkeitsdauer für das Token fest, falls diese Option verfügbar ist. Die Gültigkeitsdauer ist das Datum, bis zu dem das Token gültig bleibt. Je nach Bedarf kannst du festlegen, dass das Token nie abläuft oder dass es nach einem bestimmten Zeitraum abläuft.
Kopieren des neues Zugriffstokens:
Nachdem Sie das Token erstellt haben, wird es auf dem Bildschirm angezeigt. Kopieren Sie dieses Token unbedingt und bewahren Sie es an einem sicheren Ort auf, da es nicht wieder angezeigt wird. Wenn Sie dieses Token verlieren, müssen Sie es möglicherweise widerrufen und ein neues erstellen.
Stellen Sie sicher, dass Sie den Token vollständig kopieren und sicher aufbewahren. Behandeln Sie es genauso sensibel wie Ihr Passwort, da es Ihnen
Zusammenfassung
Sobald du das Token hast, kannst du autorisierte HTTP-Anfragen an die API stellen. Dazu füge das Token in die Kopfzeile der HTTP-Anforderung ein, indem du das Feld Authorization mit dem Bearer-Schema verwendest. Hier ist ein Beispiel, wie der Header aussehen könnte:
Authorization: Bearer YOUR_ACCESS_TOKEN_HERE
Wenn das Token ungültig oder abgelaufen ist, antwortet der Server mit einem Statuscode 401 Unauthorized.
Das allgemeine Format für API-Endpunkte innerhalb von DotSimple ist wie folgt:
/app/api/*
/api/
ist ein fester Teil des Pfades, der angibt, dass die Anfrage auf das API-Segment der DotSimple-Instanz abzielt.*
(Sternchen) ist ein Platzhalter für nachfolgende Teile der API-Endpunkt-URL..
Wichtiger Hinweis: Das Zugriffstoken dient als Schlüssel zu Ihrem Konto für die spezifischen Zwecke, für die Sie es generiert haben. Es ist wichtig, dass Sie es sicher aufbewahren und nur mit vertrauenswürdigen Anwendungen oder Diensten teilen. Wenn Sie den Verdacht haben, dass Ihr Zugangstoken kompromittiert wurde, sollten Sie es sofort widerrufen und ein neues generieren.