Access Tokens

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:

1. 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.

2. 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.

3. 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.

4. Konfigurieren des Tokens:

• Du wirst aufgefordert, einen Namen für dein neues Zugangstoken einzugeben. Wähle einen Namen, der beschreibend ist und dir hilft, dich 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.

5. Kopieren des neues Zugriffstokens:

Nachdem du das Token erstellt hast, wird es auf dem Bildschirm angezeigt. Kopiere dieses Token unbedingt und bewahre es an einem sicheren Ort auf, da es nicht wieder angezeigt wird. Wenn du dieses Token verlierst, musst du es möglicherweise widerrufen und ein neues erstellen.

Stelle sicher, dass du den Token vollständig kopierst und sicher aufbewahrst. Behandle es genauso sensibel wie dein Passwort.

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:

https://app.dotsimple.io/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 deinem Account für die spezifischen Zwecke, für die du es generierst. Es ist wichtig, dass du Zugriffstoken sicher aufbewahrst und nur mit vertrauenswürdigen Anwendungen oder Diensten teilst. Wenn du den Verdacht hast, dass dein Zugangstoken kompromittiert wurde, solltest du ihn sofort widerrufen und einen neuen generieren.