Skripte, CI und Automatisierung (n8n, Zapier, Make)
In Skripten und CI-Pipelines genügt die API selbst: ein Token aus Einstellungen → Integrationen → API-Tokens im Kopf Authorization: Bearer, der Rest ist curl und jq. Die Antworten sind dieselben JSON-Strukturen wie im Dashboard.
Für einen Deploy-Job ist meist die Frage entscheidend, ob etwas offen ist: status=critical auf der Domainliste, oder eine der kostenlosen Prüfungen, die ganz ohne Token läuft. Wer den Schritt scheitern lassen will, wertet die Anzahl der Befunde aus – jq macht daraus einen Exit-Code.
Schreibende Aufrufe (Domain anlegen, sofort prüfen) brauchen ein Token mit Schreibrecht; lesende genügen für alles andere.
export DOMAINWARN_TOKEN=dw_…
BASIS=https://api.domainwarn.com/api/v1/orgs/agentur
# kritische Domains; bricht den Schritt ab, wenn es welche gibt
curl -sf -H "Authorization: Bearer $DOMAINWARN_TOKEN" "$BASIS/domains?status=critical" \
| jq -e '.data | length == 0'
# vor dem Deploy: Zertifikat prüfen, ohne Token
curl -sf "https://api.domainwarn.com/api/v1/tools/ssl?domain=kunde.de" \
| jq -e '.data.issues == 0'Zapier und Make sprechen dieselbe API über ihren HTTP-Knoten mit Authorization: Bearer <TOKEN>; für den umgekehrten Weg – DomainWarn meldet etwas an das Szenario – gibt es Webhooks als Benachrichtigungskanal. Für n8n gibt es eigene Knoten (unten).
Siehe auch: API-Dokumentation
n8n: Trigger und Knoten
Das Community-Paket n8n-nodes-domainwarn bringt zwei Knoten mit. Der DomainWarn Trigger startet einen Workflow bei Meldungen (eröffnet, eskaliert, Erinnerung, behoben), bei Änderungen wie neuen DNS-Einträgen und bei gefährdeten SLA-Zielen; mit „Only Expiry Warnings“ nur bei Ablaufwarnungen für Zertifikate, Domains, DNSSEC-Signaturen und security.txt. Der Knoten DomainWarn listet, legt an, pausiert und setzt Domains fort, prüft alle Monitore einer Domain sofort, fragt Meldungen ab und quittiert sie und führt jede kostenlose Prüfung für beliebige Domains aus.
Der Trigger braucht kein Einrichten in DomainWarn: Beim Aktivieren des Workflows legt er über die API einen signierten Webhook an (er erscheint unter Einstellungen → Benachrichtigungen → Kanäle mit dem Hinweis auf das Token), beim Deaktivieren löscht er ihn wieder. Jede Zustellung prüft er anhand der HMAC-Signatur und des Zeitstempels; gefälschte oder ältere Zustellungen als fünf Minuten weist er ab. Mindestschwere, Ruhezeiten und Wartungsfenster gelten wie für jeden Kanal, und das Abo zählt zum Kanallimit des Tarifs.
- In n8n unter Einstellungen → Community Nodes das Paket
n8n-nodes-domainwarninstallieren (selbst gehostetes n8n; in n8n Cloud, sobald n8n das Paket freigegeben hat). - In DomainWarn unter Einstellungen → Integrationen → API-Tokens ein Token anlegen – mit Schreibrecht, wenn du den Trigger oder ändernde Aktionen nutzt.
- In n8n Zugangsdaten vom Typ „DomainWarn API“ mit dem Token anlegen; die Organisation ergibt sich aus dem Token.
- Den Trigger in einen Workflow ziehen, Ereignisse und Mindestschwere wählen und den Workflow aktivieren. n8n muss dafür über eine öffentliche https-Adresse erreichbar sein.
Wird das Token widerrufen oder läuft es ab, endet auch das Abo; wer das Token angelegt hat und die Organisation verlässt, dessen Abos bekommen nichts mehr.
Siehe auch: API-Dokumentation