InfraNestInfraNest
API · OAuth · Webhooks

Automatiseer je DNS, monitoring en servers met één API

Eén REST API voor alles wat je in InfraNest beheert, bij elke registrar, DNS-host en cloud. Pas DNS aan vanuit een script, open een onderhoudsvenster vanuit je CI en krijg een ondertekende webhook als er iets gebeurt. 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": "northwind.com",
  "provider_push": "per_record",
  "changes": [{
    "action": "create", "before": null,
    "after": { "type": "A", "name": "status", "value": "192.0.2.50", "ttl": 3600 }
  }]
}

Wat je kunt automatiseren

Het dagelijkse werk, in één API. Dezelfde records, monitors en servers die je in het dashboard ziet.

DNS-records

Records aanmaken, wijzigen en verwijderen, templates toepassen en zones synchroniseren. Doorzoek elk record in al je zones.

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

Monitors

Maak een monitor aan bij een deploy, pauzeer hem terwijl je werkt en lees resultaten en uptime.

POST /monitoring-checks

Onderhoud en incidenten

Open een onderhoudsvenster vanuit je pipeline en plaats incidentupdates op je statuspagina.

POST /maintenance-windows

Domeinen

Elk domein met verloopdatum, automatisch verlengen en nameservers. Volg nieuwe domeinen, voeg notities en labels toe.

GET /domains

Servers

Servers in elke cloud, met hun laatste metrics en wat aandacht nodig heeft.

GET /cloud-servers/metrics-overview

Auditlog en rapporten

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

GET /audit-logs

Gebouwd om veilig te automatiseren

Scripts gaan stuk, netwerken time-outen en AI-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 en een server, waar niets een provider of het internet bereikt. Testtokens werken alleen daar.

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.

Tokens met precies de toegang die ze nodig hebben

Geef elk script een eigen token, met lezen of schrijven per onderdeel. Lekt er een uit, dan kan hij weinig, en je trekt hem met één klik in.

  • Lezen of schrijven per onderdeel: DNS, domeinen, servers, monitoring en meer
  • Standaard één organisatie, alle organisaties alleen als jij dat kiest
  • Verloopt na 30 tot 365 dagen, met een mail een week van tevoren
  • Koppel een token aan het IP-adres van je CI-runner
  • Domeinen kopen, servers of zones verwijderen en leden beheren blijven bij een persoon in de app

Bouw je een integratie? Gebruik OAuth

Zet een knop “Koppelen met InfraNest” in je app. Mensen loggen in, kiezen een organisatie 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
  • Zichtbaar onder Geautoriseerde apps, met één klik te verwijderen

Webhooks voor de events die jij belangrijk vindt

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.

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

Vraag het je AI-assistent, of laat hem de code schrijven

Koppel Claude of ChatGPT aan de MCP-server en stel gewoon je vragen over je account, gratis op elk plan. 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 →

Kant-en-klare code

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

Voorbeelden

Dynamische DNS, Let’s Encrypt DNS-01, een onderhoudsvenster rond een 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 API

Bij welke plannen zit de API?

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

Kan ik het proberen zonder echte infrastructuur te raken?

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

Werkt schrijven meteen?

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

Wat zijn de rate limits?

Elke token krijgt 300 verzoeken en 60 wijzigingen per minuut, en 1.000 wijzigingen per uur. Elk antwoord vertelt 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 en je eigen account. Dat blijft bij een persoon 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

De docs brengen je van geen token naar een werkend verzoek, met een gratis sandbox om in te proberen.

Open de developer docs Gratis beginnen

Gratis sandbox · API-tokens vanaf Pro