API · OAuth · Webhooks

Laat je eigen tools het routinewerk doen, veilig

Je scripts en pipelines kunnen doen wat je nu met de hand doet, bij elke registrar, DNS-host en cloud. Bekijk een DNS-wijziging vooraf, kondig onderhoud aan vanuit een deploy en hoor het als er iets stukgaat. Probeer elke call eerst in een gratis sandbox.

Lees de developer docs →Gratis beginnen

Gratis sandbox · API-tokens vanaf Pro · Je eerste call in vijf minuten

api.infranest.io

200 OK · dry run

# Zie wat een DNS-wijziging zou doen, voordat je hem doorvoert
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 }
  }]
}

Wat de REST API je uit handen neemt

Dagelijkse klussen, gedaan door je eigen tools. Ze werken op dezelfde records, monitors en servers die je in de app ziet.

Wijzig DNS zonder zorgen

Bekijk een wijziging vooraf, voer hem uit en draai hem terug als dat nodig is. Doorzoek elk record in al je zones.

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

Kondig gepland werk aan

Open een onderhoudsvenster vanuit je pipeline. Voeg een melding toe, en je statuspagina en de abonnees zien het.

POST /maintenance-windows

Voeg bij elke release een monitor toe

Maak een monitor aan als een nieuwe dienst live gaat, zodat niets onbewaakt in productie komt.

POST /monitoring-checks

Krijg het verhaal van een incident

Lees wat het veroorzaakte, wat het raakte en hoe het verliep. Haal de opgestelde samenvatting op voor je eigen rapport.

GET /incidents/{id}/story

Vraag wat er opgelost moet worden

Lees het advies van de app zelf: controles voor elke server, elk domein en elke zone, en of een server een maat kleiner kan.

GET /cloud-servers/{id}/advisor

Houd je eigen administratie bij

Kopieer de auditlog naar je SIEM en haal het maandelijkse uptimerapport op.

GET /audit-logs

Laat je pipeline zijn eigen werk controleren

Na een productiedeploy controleert InfraNest de monitors van die deploy een uur lang vaker. Daarna vergelijkt het dat uur met het uur ervoor. Je pipeline leest één oordeel: beter, ongewijzigd of slechter. Zo vind je een slechte deploy voordat je klanten hem melden.

Hetzelfde oordeel in de app en de API
Per monitor en per locatie
Zegt het als er te weinig data is

GET /deploy-events/{id}

e61f7d2 naar productionnorthwyndr/app · App — northwyndr-app.dev2c5e8b4 opnieuw deployen

Werd het er slechter van?

Slechter

e61f7d2 naar production: p95 tot 30% trager vanuit elke locatie, mislukte checks onveranderd

Monitor	Locatie	p95 ervoor → erna	Mislukt ervoor → erna	Uitkomst
App — northwyndr-app.dev	Azië-Pacific	391 ms → 502 ms	0% → 0%	Slechter
App — northwyndr-app.dev	Europa	182 ms → 236 ms	0% → 0%	Slechter
App — northwyndr-app.dev	Noord-Amerika	268 ms → 342 ms	0% → 0%	Slechter

Het uur na de deploy, vergeleken met het uur ervoor, voor elke locatie: de traagste 5% van de responstijden (p95) en het aandeel mislukte checks. Aan elke kant zijn minstens 10 checks nodig.

Veilig om te automatiseren, ook als een script misgaat

Scripts gaan stuk, netwerken time-outen en agents maken fouten. De API is daarop gemaakt.

Elke DNS-wijziging eerst als dry run

Voeg ?dry_run=1 toe en zie precies welke records zouden veranderen. Er wordt niets opgeslagen of naar je provider gestuurd.

Een gratis sandbox

Voorbeeldzones, monitors, servers en een open incident. Niets bereikt een provider of het internet, en er gaat geen melding uit.

Retries die nooit dubbel uitvallen

Stuur een Idempotency-Key mee en een herhaald verzoek gebeurt één keer. Geen dubbele records of monitors.

Fouten waar je op kunt programmeren

Elke fout heeft een vaste code en een hint die zegt wat je moet doen. Codes veranderen nooit.

Een token per klus, met alleen de toegang die nodig is

Geef elk script een eigen token en vink aan wat het mag wijzigen. Lekt er een uit, dan kan het weinig, en je trekt het met één klik in. Een plotselinge stroom wijzigingen van een token wordt gemeld aan de eigenaars van je workspace.

Lezen of schrijven per onderdeel, in één workspace
Verloopt na 30 tot 365 dagen, en is aan één adres te binden
Kopen, servers verwijderen en leden beheren blijven in de app

Nieuw API-token

Werkt in al mijn workspacesUit: de token werkt alleen in Northwind Cloud. Zet dit alleen aan voor een tool die echt elke workspace nodig heeft waar je lid van bent.

Tokennaam

deploy-pipeline

Verloopt na

90 dagen

Toegestane adressen (optioneel)

203.0.113.10

Toegangsniveau

Volledige toegangAlleen lezenAangepast

ResourceLezenSchrijven

Domeinen & Contacten

DNS

Monitoring

Wat je met een token doet, gebeurt op jouw naam en kan kosten veroorzaken bij je providers.

AnnulerenToken aanmaken

Bouw je een integratie? Gebruik OAuth

Zet een knop “Koppelen met InfraNest” in je app. Mensen loggen in, kiezen een workspace en keuren goed wat je app mag. Niemand kopieert een token, en ze kunnen je app altijd weer verwijderen.

OAuth 2.1 met PKCE en refresh tokens
Dezelfde scopes en limieten als API-tokens
Een app kan nooit meer dan de persoon die hem goedkeurde

Claude wil je InfraNest-account gebruiken

Gepubliceerd op claude.ai. Na je antwoord ga je terug naar claude.ai.

Geverifieerd door InfraNest

Welke workspace mag de app gebruiken?

De app werkt alleen in de workspace die je kiest. Voor een andere koppel je de app opnieuw.

Northwind Cloud

SandboxSandbox

Wat Claude mag doen

Claude kan je domeinen, DNS, servers, monitoring, drop catches, leden en teams, facturering, auditlog en data-exports en -imports bekijken. Claude kan niets wijzigen.

Claude ook laten handelen bij incidenten en monitors

Een incident bevestigen, het team een notitie achterlaten, een monitor een tijdje stil zetten en een onderhoudsvenster starten of beëindigen. De app vraagt het je vóór elke actie, en dit zijn de enige wijzigingen die ze met haar InfraNest-tools kan doen.

De app houdt deze toegang tot je die verwijdert in Mijn account → Geautoriseerde apps.

AnnulerenToestaan

Hoor het op het moment dat het gebeurt

InfraNest stuurt JSON naar je URL als er iets gebeurt: een domein dat bijna verloopt, een monitor die down gaat, DNS-records die veranderen. Elk verzoek is ondertekend, zodat je kunt controleren dat het echt van ons komt. Een mislukte aflevering wordt vijf keer opnieuw geprobeerd, verspreid over zo’n tien uur. Webhooks zitten in Pro en hoger.

22 events

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

Laat je assistent de on-call-klusjes doen

Koppel Claude of ChatGPT aan de MCP-server en vraag wat er down is, op elk plan. Met jouw akkoord kan hij een incident bevestigen, een monitor stilzetten of onderhoud starten. Coding agents zoals Claude Code en Cursor krijgen docs die voor hen gemaakt zijn: llms.txt, een Markdown-versie van elke pagina en de OpenAPI-beschrijving.

Zo werkt de MCP-server →

Je assistentInfraNest gekoppeld

Ik pak Checkout flow op. Bevestig het en laat het team weten dat we terugdraaien.

Gewijzigd in InfraNest · acknowledge_incident

Bevestigd. Herhaalde meldingen zijn gestopt, en het team ziet dat je ermee bezig bent.

Je assistent vraagt het eerst

Het team een notitie achterlaten bij een incident

add_incident_note · Checkout returning 503

Notitie

We draaien de laatste storefront-deploy terug.

Alleen voor het team. Nooit zichtbaar op een statuspagina.

WeigerenToestaan

Vraag naar je domeinen, DNS of servers…

Kant-en-klare code

Open source op GitHub. Kopieer het, pas het aan, draai het.

Voorbeelden

Dynamische DNS, Let’s Encrypt DNS-01, een monitor per deploy en meer, in shell, Python, Node.js en PowerShell.

GitHub Action

Zet meldingen stil terwijl een workflow deployt, en daarna weer aan.

Postman, Bruno en Insomnia

Elk endpoint, klaar om te importeren, met een environment voor je token.

OpenAPI-beschrijving

Genereer een client, of volg de repository om nieuwe endpoints te zien.

Vragen over de REST API

Bij welke plannen zit de API?

API-tokens en webhooks zitten in Pro en hoger, voor lezen en schrijven. Op elk plan, ook Free, kun je de API proberen in een gratis sandbox met testtokens, en Claude of ChatGPT koppelen via de MCP-server.

Kan ik de API proberen zonder echte infrastructuur te raken?

Ja. Maak een sandbox via Mijn account → Ontwikkelaar. Die heeft voorbeeldzones, monitors, domeinen, twee servers en een open incident. Schrijven werkt daar, en niets bereikt ooit een provider of het internet.

Kan ik zien wat een DNS-wijziging doet voordat ik hem uitvoer?

Ja. Voeg ?dry_run=1 toe aan een DNS-schrijfactie en het antwoord toont elk record dat zou veranderen, voor en na. Er wordt niets opgeslagen, en hetzelfde verzoek zonder die toevoeging voert precies die wijziging uit.

Werkt schrijven meteen?

Zolang de API wordt uitgerold, zetten we schrijven per workspace aan. Lezen werkt meteen; vraag het ons en we zetten die van jou aan. In je sandbox werkt schrijven al.

Wat zijn de API-rate limits?

Elk token krijgt 300 verzoeken en 60 wijzigingen per minuut, en 1.000 wijzigingen per uur. Elk antwoord zegt hoeveel er nog over is. Boven een limiet antwoordt de API met 429 en het aantal seconden dat je moet wachten.

Wat kan een token nooit?

Alles wat koopt, vernietigt of bepaalt wie erin mag: domeinen registreren of verlengen, servers bestellen of verwijderen, zones verwijderen, nameservers wijzigen, leden, providergegevens, webhooks en je eigen account. Dat blijft bij iemand die in de app is ingelogd.

Hoe controleer ik dat een webhook echt van InfraNest komt?

Elk verzoek bevat X-InfraNest-Signature-V2: een HMAC-SHA256 van de timestamp en de body, gemaakt met het geheim van je endpoint. Reken hem na, vergelijk de twee en weiger een timestamp die meer dan vijf minuten afwijkt. De docs hebben kant-en-klare code.

Verandert de API zomaar?

Nieuwe velden en endpoints komen erbij zonder aankondiging. Iets verwijderen of hernoemen kondigen we zes maanden vooraf aan in de changelog, die je als RSS kunt volgen. Foutcodes veranderen nooit.

API-token of OAuth?

Een API-token is voor je eigen scripts, CI en tools. OAuth is voor een app die andere mensen aan hun eigen InfraNest-account koppelen. Beide gebruiken dezelfde scopes en limieten.

Doe je eerste call in vijf minuten

Maak een gratis sandbox, maak een testtoken en bekijk je eerste DNS-wijziging vooraf. Er wordt niets echts geraakt.

Open de developer docs Gratis beginnen

Gratis sandbox · API-tokens vanaf Pro