InfraNestInfraNest
API · OAuth · Webhooks

Automatisiere DNS, Monitoring und Server mit einer API

Eine REST-API für alles, was du in InfraNest verwaltest, bei jedem Registrar, DNS-Host und jeder Cloud. Ändere DNS aus einem Skript, öffne ein Wartungsfenster aus deiner CI und bekomm einen signierten Webhook, wenn etwas passiert. Probier jeden Aufruf zuerst in einer kostenlosen Sandbox.

Zur Entwickler-Doku →Kostenlos starten

Kostenlose Sandbox · API-Tokens ab Pro · Dein erster Aufruf in fünf Minuten

api.infranest.io
200 OK · dry run
# Sieh, was eine DNS-Änderung bewirken würde, bevor du sie machst
curl -X POST "https://api.infranest.io/api/organizations/42/dns-zones/7/dns-records?dry_run=1" \
  -H "Authorization: Bearer $INFRANEST_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"type": "A", "name": "status", "value": "192.0.2.50", "ttl": 3600}'

{
  "dry_run": true,
  "zone": "northwind.com",
  "provider_push": "per_record",
  "changes": [{
    "action": "create", "before": null,
    "after": { "type": "A", "name": "status", "value": "192.0.2.50", "ttl": 3600 }
  }]
}

Was du automatisieren kannst

Die tägliche Arbeit, in einer API. Dieselben Einträge, Monitore und Server, die du im Dashboard siehst.

DNS-Einträge

Einträge anlegen, ändern und löschen, Vorlagen anwenden und Zonen synchronisieren. Jeden Eintrag in all deinen Zonen durchsuchen.

POST /dns-zones/{zone}/dns-records

Monitore

Leg beim Deploy einen Monitor an, pausier ihn, während du arbeitest, und lies Ergebnisse und Uptime.

POST /monitoring-checks

Wartung und Vorfälle

Öffne ein Wartungsfenster aus deiner Pipeline und poste Vorfall-Updates auf deine Statusseite.

POST /maintenance-windows

Domains

Jede Domain mit Ablaufdatum, Auto-Verlängerung und Nameservern. Neue verfolgen, Notizen und Labels hinzufügen.

GET /domains

Server

Server in jeder Cloud, mit ihren aktuellen Metriken und dem, was Aufmerksamkeit braucht.

GET /cloud-servers/metrics-overview

Auditprotokoll und Berichte

Kopier das Auditprotokoll in dein SIEM und hol den monatlichen Uptime-Bericht ab.

GET /audit-logs

Gebaut, um sicher automatisiert zu werden

Skripte brechen, Netzwerke laufen in Timeouts und KI-Agenten machen Fehler. Die API ist dafür gemacht.

Jede DNS-Änderung als Dry Run

Häng ?dry_run=1 an und sieh genau, welche Einträge sich ändern würden. Nichts wird gespeichert oder an deinen Anbieter gesendet.

Eine kostenlose Sandbox

Beispielzonen, Monitore und ein Server, wo nichts einen Anbieter oder das Internet erreicht. Test-Tokens funktionieren nur dort.

Wiederholungen ohne Dubletten

Schick einen Idempotency-Key mit, und eine wiederholte Anfrage passiert nur einmal. Keine doppelten Einträge oder Monitore.

Fehler, auf die du programmieren kannst

Jeder Fehler hat einen festen Code und einen Hinweis, was zu tun ist. Codes ändern sich nie.

Tokens mit genau dem Zugriff, den sie brauchen

Gib jedem Skript einen eigenen Token, mit Lesen oder Schreiben pro Bereich. Wird einer geleakt, kann er wenig anrichten, und du widerrufst ihn mit einem Klick.

  • Lesen oder Schreiben pro Bereich: DNS, Domains, Server, Monitoring und mehr
  • Standardmäßig eine Organisation, alle nur, wenn du es willst
  • Läuft nach 30 bis 365 Tagen ab, mit einer E-Mail eine Woche vorher
  • Beschränk einen Token auf die IP-Adresse deines CI-Runners
  • Domains kaufen, Server oder Zonen löschen und Mitglieder verwalten bleiben bei einer Person in der App

Du baust eine Integration? Nimm OAuth

Bau einen Button „Mit InfraNest verbinden“ in deine App. Leute melden sich an, wählen eine Organisation und erlauben, was deine App darf. Niemand kopiert einen Token, und sie können deine App jederzeit entfernen.

  • OAuth 2.1 mit PKCE und Refresh-Tokens
  • Dieselben Scopes und Limits wie API-Tokens
  • Eine App kann nie mehr als die Person, die sie erlaubt hat
  • Unter Autorisierte Apps aufgeführt, mit einem Klick entfernbar

Webhooks für die Ereignisse, die dir wichtig sind

InfraNest schickt JSON an deine URL, wenn etwas passiert: eine Domain läuft bald ab, ein Monitor geht down, DNS-Einträge ändern sich. Jede Anfrage ist signiert, damit du prüfen kannst, dass sie wirklich von uns kommt. Eine fehlgeschlagene Zustellung wird fünfmal wiederholt, verteilt über etwa zehn Stunden.

22 Ereignisse

domain.expiringdomain.status_changeddomain.dnssec_brokenserver.status_changedmonitor.alertdns.records_changeddns.live_mismatchcertificate.expiringcertificate.expiredcertificate.changedcertificate.weakcertificate.unexpectedcertificate.revokeddynamic_ip.changedwatched_domain.dropping_soonwatched_domain.availablewatched_domain.registeredwatched_domain.failedwatched_domain.in_auctionwatched_domain.releasedwatched_domain.renewedwatched_domain.funding_short
POSTyour-app.example/webhooks/infranest
X-InfraNest-Event: monitor.alert
X-InfraNest-Delivery: 9f6c2e1a-…
X-InfraNest-Timestamp: 1793030400
X-InfraNest-Signature-V2: sha256=5d41ab…

{
  "event": "monitor.alert",
  "created_at": "2026-10-26T09:30:00Z",
  "data": { "check_name": "Checkout flow", "status": "down", "monitor_type": "http" }
}

Frag deinen KI-Assistenten, oder lass ihn den Code schreiben

Verbinde Claude oder ChatGPT mit dem MCP-Server und frag einfach nach deinem Konto, kostenlos in jedem Plan. Coding-Agenten wie Claude Code und Cursor bekommen eine Doku, die für sie gemacht ist: llms.txt, eine Markdown-Version jeder Seite und die OpenAPI-Beschreibung.

So funktioniert der MCP-Server →

Fertiger Code

Open Source auf GitHub. Kopieren, anpassen, ausführen.

Beispiele

Dynamisches DNS, Let’s Encrypt DNS-01, ein Wartungsfenster rund um ein Deploy und mehr, in Shell, Python, Node.js und PowerShell.

GitHub Action

Schalte Alarme stumm, während ein Workflow deployt, und danach wieder ein.

Postman, Bruno und Insomnia

Jeder Endpunkt, fertig zum Import, mit einer Umgebung für deinen Token.

OpenAPI-Beschreibung

Generier einen Client, oder beobachte das Repository, um neue Endpunkte mitzubekommen.

Fragen zur API

Welche Pläne enthalten die API?

API-Tokens gibt es ab Pro, zum Lesen und Schreiben. In jedem Plan, auch im kostenlosen, kannst du die API in einer kostenlosen Sandbox mit Test-Tokens ausprobieren und Claude oder ChatGPT über den MCP-Server verbinden.

Kann ich sie ausprobieren, ohne echte Infrastruktur anzufassen?

Ja. Erstell eine Sandbox unter Mein Konto → Entwickler. Sie kommt mit Beispielzonen, Monitoren, Domains und einem Server. Schreiben funktioniert dort, und nichts erreicht je einen Anbieter oder das Internet.

Funktioniert Schreiben sofort?

Während die API ausgerollt wird, schalten wir Schreibzugriffe pro Organisation frei. Lesen funktioniert sofort; frag uns, und wir schalten deine Organisation frei. In deiner Sandbox funktioniert Schreiben schon.

Welche Rate Limits gibt es?

Jeder Token bekommt 300 Anfragen und 60 Änderungen pro Minute sowie 1.000 Änderungen pro Stunde. Jede Antwort sagt dir, wie viel noch übrig ist. Über einem Limit antwortet die API mit 429 und der Anzahl Sekunden, die du warten sollst.

Was kann ein Token nie?

Alles, was kauft, zerstört oder bestimmt, wer reinkommt: Domains registrieren oder verlängern, Server bestellen oder löschen, Zonen löschen, Nameserver ändern, Mitglieder, Anbieter-Zugangsdaten und dein eigenes Konto. Das bleibt bei einer Person, die in der App angemeldet ist.

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

Jede Anfrage enthält X-InfraNest-Signature-V2: einen HMAC-SHA256 aus Zeitstempel und Body, erstellt mit dem Secret deines Endpunkts. Rechne ihn nach, vergleich beide und lehn einen Zeitstempel ab, der mehr als fünf Minuten abweicht. Die Doku hat fertigen Code.

Ändert sich die API einfach so?

Neue Felder und Endpunkte kommen ohne Ankündigung dazu. Etwas zu entfernen oder umzubenennen kündigen wir sechs Monate vorher im Changelog an, den du per RSS verfolgen kannst. Fehlercodes ändern sich nie.

API-Token oder OAuth?

Ein API-Token ist für deine eigenen Skripte, CI und Tools. OAuth ist für eine App, die andere Leute mit ihrem eigenen InfraNest-Konto verbinden. Beide nutzen dieselben Scopes und Limits.

Dein erster Aufruf in fünf Minuten

Die Doku bringt dich vom fehlenden Token zur funktionierenden Anfrage, mit einer kostenlosen Sandbox zum Ausprobieren.

Zur Entwickler-Doku Kostenlos starten

Kostenlose Sandbox · API-Tokens ab Pro