API-Schlüssel für dein Hosting erstellen und widerrufen

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

  1. Öffne im Panel über dein Konto-Menü API & KI-Zugriff.
  2. Gib dem API-Schlüssel 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; zum endgültigen Löschen einzelner Backups gibt es das eigene Recht backups:delete, das nie in einer Schnellauswahl steckt. static:deploy gilt 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.
  4. 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.
  5. 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

  • 0 Benutzer fanden dies hilfreich
War diese Antwort hilfreich?