In diesem Abschnitt3 Artikel
Einen Token erstellen und widerrufen
Erstelle unter Einstellungen → API einen persönlichen API-Token, kopiere ihn einmal und widerrufe ihn dort, wenn eine App ihn nicht mehr braucht.
Zum Erstellen eines Tokens brauchst du den Label-Plan. Siehe API-Zugang im Label-Plan. Erstelle und widerrufe Tokens, während du in der App angemeldet bist: Ein Token kann keine anderen Tokens erstellen oder widerrufen.
Einen Token erstellen
- Prüfe, dass der richtige Workspace aktiv ist. Der Token liest die Daten des Workspaces, in dem du gerade bist.
- Öffne Einstellungen → API und wähle Neuer Token.
- Gib einen Token-Namen ein, an dem du erkennst, wo du ihn nutzt, zum Beispiel „CI-Pipeline“. Wähle Token erstellen.
- Wähle Token kopieren und bewahre den Token an einem sicheren Ort auf, etwa in einem Passwortmanager oder in den geheimen Einstellungen deiner App.
- Wähle Ich habe ihn gespeichert.
Deine Tokens ansehen
Einstellungen → API listet deine aktiven Tokens des aktuellen Workspaces mit Namen, dem Anfang des Tokens, dem Erstellungsdatum und wann er Zuletzt genutzt wurde. Nie heißt, dass noch keine Anfrage ihn genutzt hat.
Einen Token widerrufen
- Such den Token unter Einstellungen → API in der Liste. Wähle im Web das Papierkorb-Symbol daneben. Wähle in den Apps Widerrufen.
- Wähle bei Diesen Token widerrufen? die Option Token widerrufen.
Jede App, die den Token nutzt, funktioniert sofort nicht mehr. Das lässt sich nicht rückgängig machen. Durch das Widerrufen wird ein Platz frei, sodass du einen neuen Token erstellen kannst.
In den iPhone- und Android-Apps
Einstellungen → API funktioniert in den Apps genauso. Das Feld Token-Name und Token erstellen sind immer auf der Seite, der neue Token erscheint unter Dein neuer Token, und jeder Token in der Liste hat eine Schaltfläche Widerrufen.
Fragen
Ich habe meinen API-Token verloren. Kann ich ihn noch einmal sehen?
Nein. Den vollständigen Token zeigen wir nur einmal. Widerrufe den verlorenen Token unter Einstellungen → API und erstelle einen neuen.
Werden meine API-Tokens beim Abmelden widerrufen?
Nein. Beim Abmelden enden deine App-Sitzungen, aber Tokens funktionieren weiter, bis du sie widerrufst. Wenn du einen Workspace verlässt, daraus entfernt wirst oder dein Konto löschst, enden seine Tokens.
Warum kann ich keinen weiteren Token erstellen?
Du kannst 5 aktive Tokens haben. Widerrufe einen, den du nicht mehr nutzt, und erstelle dann den neuen.
