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
- Öffnen Sie im Kundenbereich API und Webhooks (https://domain.agiledeveloper.de/konto/entwickler).
- Geben Sie unter API-Schlüssel einen Name ein, zum Beispiel „Deploy-Skript“, und auf Wunsch ein Ablaufdatum.
- Wählen Sie die Rechte, zum Beispiel „Domains und ihren Status lesen“ oder „DNS-Einträge anlegen, ändern, löschen, Vorlagen anwenden“.
- 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.