API · OAuth · Webhooks

Lass deine eigenen Tools die Routinearbeit erledigen, sicher

Deine Skripte und Pipelines können tun, was du heute von Hand machst, bei jedem Registrar, DNS-Host und jeder Cloud. Prüfe eine DNS-Änderung vorab, kündige Wartung aus einem Deploy an und erfahre, wenn etwas kaputtgeht. 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": "northwyndr.com",
  "provider_push": "per_record",
  "changes": [{
    "action": "create", "before": null,
    "after": { "type": "A", "name": "status", "value": "192.0.2.50", "ttl": 3600 }
  }]
}

Was dir die REST-API abnimmt

Alltägliche Aufgaben, erledigt von deinen eigenen Tools. Sie arbeiten mit denselben Einträgen, Monitoren und Servern, die du in der App siehst.

DNS ändern ohne Sorge

Prüfe eine Änderung vorab, führ sie aus und mach sie bei Bedarf rückgängig. Durchsuche jeden Eintrag in all deinen Zonen.

POST /dns-zones/{zone}/dns-records?dry_run=1

Geplante Arbeit ankündigen

Öffne ein Wartungsfenster aus deiner Pipeline. Füg einen Hinweis hinzu, und deine Statusseite und ihre Abonnenten sehen ihn.

POST /maintenance-windows

Mit jedem Release einen Monitor anlegen

Leg einen Monitor an, wenn ein neuer Dienst live geht. So erreicht nichts unbeobachtet die Produktion.

POST /monitoring-checks

Die Geschichte eines Vorfalls abrufen

Lies, was ihn verursacht hat, was er betroffen hat und wie er verlief. Übernimm die entworfene Zusammenfassung in deinen eigenen Bericht.

GET /incidents/{id}/story

Fragen, was zu beheben ist

Lies die Ratschläge der App: Setup-Prüfungen für jeden Server, jede Domain und Zone und ob ein Server eine Größe kleiner sein könnte.

GET /cloud-servers/{id}/advisor

Eigene Aufzeichnungen führen

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

GET /audit-logs

Lass deine Pipeline ihre eigene Arbeit prüfen

Nach einem Produktions-Deploy prüft InfraNest die Monitore des Deploys eine Stunde lang öfter. Dann vergleicht es diese Stunde mit der Stunde davor. Deine Pipeline liest ein Ergebnis: besser, unverändert oder schlechter. So findest du ein schlechtes Deploy, bevor deine Kunden es melden.

Dasselbe Ergebnis in der App und der API
Pro Monitor und pro Standort
Sagt es, wenn zu wenig Daten da sind

GET /deploy-events/{id}

e61f7d2 nach productionnorthwyndr/app · App — northwyndr-app.dev2c5e8b4 erneut deployen

Hat es etwas verschlechtert?

Schlechter

e61f7d2 nach production: p95 bis zu 30 % langsamer von jedem Standort, fehlgeschlagene Checks unverändert

Monitor	Standort	p95 davor → danach	Fehlgeschlagen davor → danach	Ergebnis
App — northwyndr-app.dev	Asien-Pazifik	391 ms → 502 ms	0% → 0%	Schlechter
App — northwyndr-app.dev	Europa	182 ms → 236 ms	0% → 0%	Schlechter
App — northwyndr-app.dev	Nordamerika	268 ms → 342 ms	0% → 0%	Schlechter

Die Stunde nach dem Deploy, verglichen mit der Stunde davor, für jeden Standort: die langsamsten 5 % der Antwortzeiten (p95) und der Anteil fehlgeschlagener Checks. Jede Seite braucht mindestens 10 Checks.

Sicher zu automatisieren, auch wenn ein Skript schiefgeht

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

Jede DNS-Änderung als Testlauf

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, Server und ein offener Vorfall. Nichts erreicht einen Anbieter oder das Internet, und kein Alarm geht raus.

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.

Ein Token für jede Aufgabe, nur mit dem nötigen Zugriff

Gib jedem Skript einen eigenen Token und hak an, was es ändern darf. Wird einer geleakt, kann er wenig anrichten, und du widerrufst ihn mit einem Klick. Eine plötzliche Flut von Änderungen durch einen Token wird den Workspace-Inhabern gemeldet.

Lesen oder Schreiben pro Bereich, in einem Workspace
Läuft nach 30 bis 365 Tagen ab, an eine Adresse bindbar
Kaufen, Server löschen und Mitglieder verwalten bleiben in der App

Neuer API-Token

Funktioniert in allen meinen WorkspacesAus: Der Token funktioniert nur in Northwind Cloud. Nur einschalten, wenn ein Tool wirklich jeden Workspace braucht, in dem du Mitglied bist.

Token-Name

deploy-pipeline

Läuft ab nach

90 Tagen

Erlaubte Adressen (optional)

203.0.113.10

Zugriffsebene

VollzugriffNur lesenBenutzerdefiniert

RessourceLesenSchreiben

Domains & Kontakte

DNS

Monitoring

Was mit einem Token passiert, geschieht in deinem Namen und kann bei deinen Anbietern Kosten verursachen.

AbbrechenToken erstellen

Du baust eine Integration? Nimm OAuth

Bau einen Button „Mit InfraNest verbinden“ in deine App. Leute melden sich an, wählen einen Workspace 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

Claude möchte dein InfraNest-Konto nutzen

Veröffentlicht auf claude.ai. Nach deiner Antwort geht es zurück zu claude.ai.

Von InfraNest verifiziert

Welcher Workspace darf die App nutzen?

Die App funktioniert nur im Workspace, den du wählst. Für einen anderen verbindest du die App erneut.

Northwind Cloud

SandboxSandbox

Was Claude darf

Claude kann deine Domains, DNS, Server, Monitoring, Drop Catches, Mitglieder und Teams, Abrechnung, Auditprotokoll und Datenexporte und -importe sehen. Ändern kann die App nichts.

Claude auch bei Vorfällen und Monitoren handeln lassen

Einen Vorfall bestätigen, dem Team eine Notiz hinterlassen, einen Monitor eine Weile stummschalten und ein Wartungsfenster starten oder beenden. Die App fragt dich vor jeder Aktion, und das sind die einzigen Änderungen, die mit ihren InfraNest-Werkzeugen möglich sind.

Die App behält diesen Zugriff, bis du ihn unter Mein Konto → Autorisierte Apps entfernst.

AbbrechenErlauben

Erfahre es in dem Moment, in dem es passiert

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. Webhooks gibt es ab Pro.

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" }
}

Lass deinen Assistenten die Bereitschaftsaufgaben erledigen

Verbinde Claude oder ChatGPT mit dem MCP-Server und frag, was down ist, in jedem Tarif. Mit deinem OK kann er einen Vorfall bestätigen, einen Monitor stummschalten oder Wartung starten. 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 →

Dein AssistentInfraNest verbunden

Ich kümmere mich um Checkout flow. Bestätige es und sag dem Team, dass wir zurückrollen.

In InfraNest geändert · acknowledge_incident

Bestätigt. Wiederholte Alarme sind gestoppt, und das Team sieht, dass du dran bist.

Dein Assistent fragt zuerst

Dem Team eine Notiz zu einem Vorfall hinterlassen

add_incident_note · Checkout returning 503

Notiz

Wir rollen das letzte Storefront-Deploy zurück.

Nur fürs Team. Nie auf einer Statusseite sichtbar.

AblehnenErlauben

Frag nach deinen Domains, DNS oder Servern …

Fertiger Code

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

Beispiele

Dynamisches DNS, Let’s Encrypt DNS-01, ein Monitor pro 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 REST-API

Welche Tarife enthalten die API?

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

Kann ich die API ausprobieren, ohne echte Infrastruktur zu berühren?

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

Kann ich sehen, was eine DNS-Änderung bewirkt, bevor ich sie mache?

Ja. Häng ?dry_run=1 an einen DNS-Schreibaufruf, und die Antwort listet jeden Eintrag auf, der sich ändern würde, vorher und nachher. Nichts wird gespeichert, und dieselbe Anfrage ohne den Parameter macht genau diese Änderung.

Funktioniert Schreiben sofort?

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

Welche Rate Limits hat die API?

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, Webhooks 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.

Mach deinen ersten Aufruf in fünf Minuten

Erstell eine kostenlose Sandbox, leg einen Test-Token an und prüfe deine erste DNS-Änderung vorab. Nichts Echtes wird berührt.

Zur Entwickler-Doku Kostenlos starten

Kostenlose Sandbox · API-Tokens ab Pro