API-Schlüssel für dein Hosting erstellen und widerrufen
Diese Anleitung zeigt dir, wie du einen API-Schlüssel (in der Technik auch Token genannt) 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. Bei einem API-Schlüssel mit dem Ziel „Ausgewählte Websites“ kommen später angelegte Websites nicht automatisch dazu. Die Ziele „Ganzes Konto“ und „Ein Kunde“ gelten auch für neue Websites; du brauchst sie für die Agentur-API. Webhooks und das Pflegen von Lizenzangaben gehen nur mit „Ganzes Konto“.
API-Schlüssel anlegen
- Öffne im Panel über dein Konto-Menü API & KI-Zugriff.
- Gib dem API-Schlüssel einen Namen, der Zweck und Umgebung erkennen lässt, etwa „CI Staging Theme“.
- Wähle nur die benötigten Rechte und die konkreten Ziele. Für reine Anzeigen genügt
sites:read; ein Backupjob benötigtbackups:create; zum endgültigen Löschen einzelner Backups gibt es das eigene Rechtbackups:delete, das nie in einer Schnellauswahl steckt.static:deploygilt ausschließlich für AI Launch. Die Berechtigungen stehen nach Bereichen geordnet (Websites, Backups, Updates und Plugins, Staging, Agentur, Webhooks); mit dem Suchfeld darüber findest du eine schnell. Ausgegraute Berechtigungen passen nicht zum gewählten Ziel oder zu den gewählten Websites, der Hinweis an der Zeile nennt den Grund. - Wähle 30, 90 oder 365 Tage oder „unbefristet“; Standard sind 90 Tage. Erstelle den API-Schlüssel und kopiere das einmal angezeigte Secret in den Secret Store deiner Anwendung oder CI-Plattform.
- Prüfe die Liste der API-Schlüssel: 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-Schlüssel vorgesehen. Rechte/Ziele lassen sich nicht nachträglich erweitern. Lege für zusätzliche Berechtigungen einen neuen API-Schlüssel an und widerrufe den alten.
API-Schlüssel widerrufen
Öffne erneut API & KI-Zugriff, finde den API-Schlüssel am Namen und widerrufe ihn. Inhaber können alle API-Schlüssel des Kontos widerrufen; Teammitglieder nur eigene. Bereits abgelaufene und widerrufene API-Schlüssel 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
- Bereich für API-Schlüssel 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. Alten API-Schlüssel widerrufen und neuen anlegen.
- 401 nach zuvor erfolgreichem Aufruf: Ablauf, Widerruf und Benutzerzuordnung prüfen.
Weitere Anleitungen
Agentur-API · Webhooks · OpenAPI-Referenz · Fehler und Timeouts · KI-Zugriff für Claude/ChatGPT