API & Webhooks

Eine REST-API für deinen gesamten Stack

Alles, was du in InfraNest tun kannst, kannst du 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 du bereits nutzt.

API-Dokumentation erkunden →API-Schlüssel holen

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

api.infranest.io

200 OK

# DNS-Einträge auflisten
curl https://api.infranest.io/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 du im Dashboard ausführen würdest.

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

Deinen 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 du brauchst

Gib jedem API-Token nur die Berechtigungen, die es braucht — Lesen oder Schreiben, pro Bereich — mit optionalem Ablauf. Sieh, wann ein Token zuletzt genutzt wurde, und widerrufe 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 dir wichtig sind

Richte eine URL auf die Ereignisse deiner Wahl, und InfraNest sendet an sie, wenn sie eintreten — jede Nachricht signiert, sodass du überprüfen kannst, 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": "northwind.com", "expires_at": "2026-08-01" }
}

Ingest-Endpunkte für die Tools, die du bereits nutzt

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

Dynamische-IP-Updates

Dein Router oder ddclient meldet eine wechselnde IP, und deine 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öse ein Deployment aus deiner CI/CD-Pipeline mit einem einfachen eingehenden Webhook aus — protokolliert, wer es getan hat.

Remote-Sonden

Führe Monitoring-Checks von deinen eigenen Standorten aus und sende die Ergebnisse sicher zurück.

Server-Agent

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

Sicher konzipiert

Jedes Token erhält nur den Zugriff, den du wählst, mit optionalem Ablauf

Signierte Webhooks, die du überprüfen kannst — sodass du weißt, 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 du und InfraNest teilen. Jede Anfrage trägt einen Signatur-Header — berechne ihn aus dem Anfrage-Body und deinem Geheimnis neu und prüfe, ob beide übereinstimmen. Wenn ja, kam die Nachricht wirklich von InfraNest und wurde unterwegs nicht verändert. Schritt-für-Schritt-Beispiele findest du 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). Du wählst genau, welche Ereignisse jeder Endpunkt empfängt.

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

Du kannst im kostenlosen Tarif starten. Der API-Zugang und die Anzahl der Webhook-Endpunkte skalieren mit deinem Tarif, sodass umfangreichere Automatisierung in den bezahlten Stufen liegt.

Gibt es ein Ratenlimit?

Ja — Fair-Use-Limits schützen die Plattform und skalieren mit deinem Tarif. Wenn du eines erreichst, antwortet die API mit einer klaren „Bitte gleich erneut versuchen“-Antwort, sodass dein 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 Docs

Kostenloser Tarif · Keine Kreditkarte nötig