API-Token für dein Hosting erstellen und widerrufen

API-Token für dein Hosting erstellen und widerrufen

Diese Anleitung zeigt dir, wie du einen begrenzten API-Zugang für eigene Websites anlegst und bei Bedarf wieder sperrst. Die API steht für Hosting-Konten zur Verfügung.

Voraussetzungen

• Du bist im Kundenkonto angemeldet und darfst die betreffenden Hostingverträge verwalten. Für Teammitglieder begrenzen ihre aktuellen Rechte die Auswahl.
• Du kennst die benötigten Sites und Funktionen. Ein Token erhält keine automatisch hinzukommenden Websites.

Token anlegen

1. Öffne im Panel über dein Konto-Menü API & KI-Zugriff.
2. Gib dem Token einen Namen, der Zweck und Umgebung erkennen lässt, etwa „CI Staging Theme“.
3. Wähle nur die benötigten Rechte und die konkreten Ziele. Für reine Anzeigen genügt sites:read; ein Backupjob benötigt backups:create. static:deploy gilt ausschließlich für AI Launch.
4. Wähle 30, 90 oder 365 Tage oder „unbefristet“; Standard sind 90 Tage. Erstelle das Token und kopiere das einmal angezeigte Secret in den Secret Store deiner Anwendung oder CI-Plattform.
5. Prüfe die Tokenliste: Name, Rechte, Ziele und Ablauf müssen deiner Auswahl entsprechen. Die Liste zeigt das Secret nicht erneut.

Pro Konto sind höchstens 20 aktive API-Tokens vorgesehen. Rechte/Ziele lassen sich nicht nachträglich erweitern. Lege für zusätzliche Berechtigungen ein neues Token an und widerrufe das alte.

Token widerrufen

Öffne erneut API & KI-Zugriff, finde das Token am Namen und widerrufe es. Inhaber können alle API-Tokens des Kontos widerrufen; Teammitglieder nur eigene. Bereits abgelaufene und widerrufene Tokens bleiben zur Einordnung in der Liste. Ein Widerruf gilt auch für späteres Auslesen eines Jobs. Wurde dasselbe CI-System über einen SSH-Key angebunden, widerrufe diesen Key separat.

Typische Probleme

• API-Tokenbereich fehlt: Prüfe, ob du im Kundenkonto angemeldet bist und im Konto-Menü API & KI-Zugriff geöffnet hast. Fehlt der Bereich weiterhin, wende dich an den Support.
• Site oder Recht fehlt in der Auswahl: Prüfe Tarif, Installation und deine aktuellen Kontorechte.
• Secret verloren: Das Secret wird nicht erneut angezeigt. Altes Token widerrufen und neues anlegen.
• 401 nach zuvor erfolgreichem Aufruf: Ablauf, Widerruf und Benutzerzuordnung prüfen.

Weitere Anleitungen

OpenAPI-Referenz · Fehler und Timeouts · KI-Zugriff für Claude/ChatGPT