API & Webhooks

Eine REST-API für deinen gesamten Stack

Alles, was Sie in InfraNest tun können, können Sie automatisieren. Domains, DNS, Server, Zertifikate und Monitoring liegen hinter einem Endpunkt und einem Token — mit signierten Webhooks und Ingest-Endpunkten für die Tools, die Sie bereits nutzen.

API-Dokumentation erkunden →API-Schlüssel holen

Kostenloser Tarif · Keine Kreditkarte nötig · Bereichsbezogene Tokens in Sekunden

api.infranest.app

200 OK

# DNS-Einträge auflisten
curl https://api.infranest.app/v1/dns/records \
  -H "Authorization: Bearer inf_live_•••"

{
  "data": [
    { "type": "A", "name": "@", "synced": true }
  ]
}

Eine API für alles, was InfraNest kann

Jeder Produktbereich ist über dieselbe REST-API verfügbar — sauberes JSON, ein Token und dieselben Aktionen, die Sie im Dashboard ausführen würden.

Domains & Kontakte

Domains, Kontakte und Ablauf über Registrare hinweg registrieren, transferieren, verlängern und auslesen.

GET /v1/domains

DNS

Zonen, Einträge und Vorlagen erstellen, aktualisieren und synchronisieren — mit Drift-Erkennung.

POST /v1/dns/zones/{id}/records

Server & Cloud

Server, Volumes und Firewalls provisionieren, neustarten, snapshotten und Metriken auslesen.

POST /v1/servers/{id}/actions

Zertifikate

Ihren Zertifikatsbestand, Ablauf, Sicherheitslage und Abdeckungslücken auslesen.

GET /v1/certificates

Monitoring

Checks verwalten, Vorfälle und Wartung auslesen und Statusseiten steuern.

GET /v1/monitors

Dynamische IP

Dynamische IP-Quellen und die Einträge und Firewall-Regeln, die sie steuern, verwalten.

GET /v1/dynamic-ips

Tokens mit genau dem Zugriff, den Sie brauchen

Geben Sie jedem API-Token nur die Berechtigungen, die es braucht — Lesen oder Schreiben, pro Bereich — mit optionalem Ablauf. Sehen Sie, wann ein Token zuletzt genutzt wurde, und widerrufen Sie es jederzeit.

Lese- oder Schreibzugriff pro Bereich — oder nur lesen und Vollzugriff
Optionaler Ablauf; das Token wird einmal angezeigt, danach bleibt nur ein Hinweis
Fair-Use-Ratenlimits halten alles stabil

Neues API-Token · ci-deploy-botErstellen

dns.write

domains.read

monitoring.read

cloud.write

inf_live_9f2c•••••••••••••••• · läuft in 90 Tagen ab

Webhooks für die Ereignisse, die Ihnen wichtig sind

Richten Sie eine URL auf die Ereignisse Ihrer Wahl, und InfraNest sendet an sie, wenn sie eintreten — jede Nachricht signiert, sodass Sie überprüfen können, dass sie wirklich von uns kam. Zustellungen werden protokolliert, und Fehlschläge werden automatisch wiederholt.

domain.expiringdomain.status_changeddns.records_changedserver.status_changedmonitor.alertwatched_domain.dropping_soonwatched_domain.availablewatched_domain.registered

POSTyour-app.com/webhooks

X-InfraNest-Event: domain.expiring
X-InfraNest-Timestamp: 1720353600
X-InfraNest-Signature: sha256=a1b2c3…

{
  "event": "domain.expiring",
  "data": { "domain": "example.com", "expires_at": "2026-08-01" }
}

Ingest-Endpunkte für die Tools, die Sie bereits nutzen

Einfache, token-geschützte Endpunkte, die Ihre Infrastruktur in InfraNest hineinruft — kein Login, jeder mit seinem eigenen bereichsbezogenen Token.

Dynamische-IP-Updates

Ihr Router oder ddclient meldet eine wechselnde IP, und Ihre DNS-Einträge und Firewall-Regeln aktualisieren sich automatisch.

Heartbeats

Ein Cron-Job pingt eine eindeutige URL nach Zeitplan an — ein fehlender Ping löst eine Warnung aus.

Deploy-Hooks

Lösen Sie ein Deployment aus Ihrer CI/CD-Pipeline mit einem einfachen eingehenden Webhook aus — protokolliert, wer es getan hat.

Remote-Sonden

Führen Sie Monitoring-Checks von Ihren eigenen Standorten aus und senden Sie die Ergebnisse sicher zurück.

Server-Agent

Ein leichter Agent auf Ihren Servern schiebt Daten hinein — etwa die Zertifikate eines Servers in Ihren Bestand.

Sicher konzipiert

Jedes Token erhält nur den Zugriff, den Sie wählen, mit optionalem Ablauf

Signierte Webhooks, die Sie überprüfen können — sodass Sie wissen, dass sie von InfraNest kamen

Sichere Zustellung, und jedes Geheimnis verschlüsselt gespeichert

Fair-Use-Ratenlimits und ein vollständiges Audit-Log jeder Aktion

API- & Webhook-FAQs

Wie überprüfe ich, dass ein Webhook wirklich von InfraNest kommt?

Jeder Webhook wird mit einem Geheimnis signiert, das nur Sie und InfraNest teilen. Jede Anfrage trägt einen Signatur-Header — berechnen Sie ihn aus dem Anfrage-Body und Ihrem Geheimnis neu und prüfen Sie, ob beide übereinstimmen. Wenn ja, kam die Nachricht wirklich von InfraNest und wurde unterwegs nicht verändert. Schritt-für-Schritt-Beispiele finden Sie in der Dokumentation.

Welche Ereignisse können Webhooks senden?

Eine ablaufende Domain oder eine Statusänderung, sich ändernde DNS-Einträge, ein Server, der online oder offline geht, eine Monitoring-Warnung und der Drop-Catch-Lebenszyklus (eine beobachtete Domain wird verfügbar oder wird registriert). Sie wählen genau, welche Ereignisse jeder Endpunkt empfängt.

Brauche ich einen bezahlten Tarif, um die API zu nutzen?

Sie können im kostenlosen Tarif starten. Der API-Zugang und die Anzahl der Webhook-Endpunkte skalieren mit Ihrem Tarif, sodass umfangreichere Automatisierung in den bezahlten Stufen liegt.

Gibt es ein Ratenlimit?

Ja — Fair-Use-Limits schützen die Plattform und skalieren mit Ihrem Tarif. Wenn Sie eines erreichen, antwortet die API mit einer klaren „Bitte gleich erneut versuchen“-Antwort, sodass Ihr Skript zurückweichen und es erneut versuchen kann.

Auf InfraNest aufbauen

Vollständige Endpunkt-Referenz, Authentifizierung und Beispiele findest du in der interaktiven API-Dokumentation.

API-Dokumentation öffnen Wissensdatenbank

Kostenloser Tarif · Keine Kreditkarte nötig