Agile Developer Hilfe-Center › Agile Domain

Wie erstelle ich einen API-Schlüssel und richte Webhooks ein?

Unter Kundenbereich > API und Webhooks einen Schlüssel mit Rechten erzeugen (beginnt mit agile_dom_) und Webhooks mit signierten Ereignissen anlegen.

API-Schlüssel erzeugen

  1. Öffnen Sie im Kundenbereich API und Webhooks (https://domain.agiledeveloper.de/konto/entwickler).
  2. Geben Sie unter API-Schlüssel einen Name ein, zum Beispiel „Deploy-Skript“, und auf Wunsch ein Ablaufdatum.
  3. Wählen Sie die Rechte, zum Beispiel „Domains und ihren Status lesen“ oder „DNS-Einträge anlegen, ändern, löschen, Vorlagen anwenden“.
  4. Klicken Sie auf Schlüssel erzeugen und kopieren Sie den Schlüssel sofort. Er erscheint nur einmal, danach sehen Sie nur Anfang und Ende.

Schlüssel beginnen mit agile_dom_. Sie schicken ihn im Header mit: Authorization: Bearer agile_dom_…. Nicht mehr gebrauchte Schlüssel entfernen Sie mit Widerrufen.

Das Recht für kostenpflichtige Bestellungen ist getrennt. Auch damit braucht jede Bestellung eine ausdrückliche Bestätigung im Aufruf.

API-Dokumentation

Die vollständige Beschreibung aller Endpunkte finden Sie unter https://domain.agiledeveloper.de/docs, die OpenAPI-Datei unter https://domain.agiledeveloper.de/api/openapi.json.

Webhooks

Unter Webhooks tragen Sie eine Ziel-URL (https) ein, wählen die Ereignisse und klicken auf Webhook anlegen. Wir schicken die Ereignisse als signierten POST mit dem Header Agile-Signature (HMAC-SHA256). Das Signatur-Geheimnis ist nur direkt nach dem Anlegen sichtbar. Fehlgeschlagene Zustellungen wiederholen wir bis zu einen Tag lang. Mit Test senden und Protokoll prüfen Sie die Zustellung.

War dieser Artikel hilfreich?

Zuletzt aktualisiert am 11. Oktober 2026

Weitere Artikel zu Agile Domain

Nicht gefunden, was Sie suchen?Schreiben Sie uns. Wir helfen gern weiter.