InfraNestInfraNest
Automatisering

Automatiseer je DNS, monitors en servers met de InfraNest API

Wat je met de InfraNest API kunt automatiseren, zes taken die het scripten waard zijn, een gratis sandbox op elk abonnement om veilig te oefenen en open-source code die je vandaag kunt kopiëren.

IInfraNest· 9 november 2026· 9 min read
Automatiseer je DNS, monitors en servers met de InfraNest API

Vorige week lieten we zien hoe je Claude of ChatGPT vragen stelt over je infrastructuur. Deze week gaat over de klussen die je nooit meer met de hand wilt doen. Met de InfraNest API kunnen je eigen scripts, deploy-pipelines en tools zelfstandig DNS-records wijzigen, monitors toevoegen, alerts tijdens een deploy stilzetten en uptime rapporteren. Alles wat je nodig hebt om te beginnen staat op onze nieuwe developersite, developers.infranest.io.

Een API is gewoon een manier waarop software InfraNest gebruikt zoals jij dat in de app doet: in plaats van op een knop te klikken, stuurt een script een verzoek.

In het kort:

  • Automatiseer DNS, monitors, servers, incidenten, onderhoudsvensters en statuspagina's.
  • Probeer alles eerst uit in een gratis sandbox, op elk abonnement. Niets daarin bereikt het internet.
  • Kopieer kant-en-klare scripts en een GitHub Action uit onze open-source repository's.

Geen developer? Dan heb je de API misschien niet nodig

Veel automatisering in InfraNest vraagt helemaal geen code:

  • Automatiseringen in de app: „als dit gebeurt, doe dan dat”. Plaats bijvoorbeeld een bericht in Slack of Teams wanneer een monitor down gaat, of open er een Jira- of Linear-issue voor. Free bevat 3 automatiseringen, Pro 25.
  • Je AI-assistent: vraag Claude of ChatGPT wat er down is of wat er veranderd is, op elk abonnement, ook Free.
  • Kopiëren en plakken: de GitHub Action verderop heeft alleen een token en een paar regels configuratie nodig.

De rest van dit artikel is voor als je je eigen code de leiding wilt geven.

Wat je kunt automatiseren met de InfraNest API

De API kan bij dezelfde dingen die je in de app beheert:

  • DNS: zones en records uitlezen, en records toevoegen, wijzigen of verwijderen bij je DNS-provider. Elke wijziging komt in de geschiedenis van de zone terecht en kan daar ongedaan worden gemaakt.
  • Monitoring: monitors aanmaken, pauzeren en hervatten, direct een check uitvoeren, en resultaten en uptime uitlezen.
  • Servers: monitoring inschakelen voor een nieuwe server, de alerts ervan sluimeren, de alertregels aanpassen en de metrics uitlezen.
  • Incidenten en onderhoud: incidenten openen, bijwerken en oplossen, en onderhoudsvensters starten en beëindigen.
  • Statuspagina's, domeinen, certificaten, tags, kosten en de auditlog: uitlezen, en wijzigen wat de API-referentie als wijzigbaar aanmerkt.

Wat bewust in de app blijft. Alles wat geld kost of niet ongedaan kan worden gemaakt, vraagt om een persoon die in de app is ingelogd: een domein registreren, verlengen of verhuizen, servers aanmaken of verwijderen, een DNS-zone verwijderen, nameservers wijzigen. Hetzelfde geldt voor alles wat bepaalt wie er toegang heeft of waar alerts naartoe gaan, zoals leden, providerlogins en alertkanalen. Een uitgelekte token kan dus geen server bestellen en je niet buitensluiten uit je account.

Zes taken die het automatiseren waard zijn

Elke taak is een stapsgewijs recept op de developersite en een direct bruikbaar script in infranest-examples, in shell, Python, Node.js en PowerShell.

1. Wildcard-certificaten zonder een poort open te zetten

Om je een certificaat te geven, moet Let's Encrypt bewijs zien dat jij het domein beheert. Bij een wildcard-certificaat (*.example.com) is het enige geaccepteerde bewijs een tijdelijk DNS-record. Je certificaattool, zoals certbot, vraagt InfraNest dat record toe te voegen, wacht tot Let's Encrypt het heeft gecontroleerd en verwijdert het daarna weer. Er hoeft geen webserver bereikbaar te zijn, en het werkt voor elk domein waarvan de DNS in InfraNest staat.

curl -X POST https://api.infranest.io/api/organizations/42/dns-zones/318/dns-records \
  -H "Authorization: Bearer $INFRANEST_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: acme-$CERTBOT_DOMAIN-$CERTBOT_VALIDATION" \
  -d '{"type":"TXT","name":"_acme-challenge","value":"'"$CERTBOT_VALIDATION"'","ttl":60}'

Recept: Let's Encrypt met InfraNest DNS

2. Geen alerts tijdens je deploy

Een deploy herstart dingen, en voor je monitors ziet een herstart eruit als een storing. Open vóór de deploy een onderhoudsvenster en sluit het daarna: niemand wordt wakker gebeld, en je statuspagina vertelt bezoekers wat er aan de hand is. Op GitHub doet onze InfraNest Maintenance Window-action het in één stap:

- name: Silence alerts during the deploy
  id: window
  uses: InfraNest-Infrastructure-Organized/infranest-action@v1
  with:
    token: ${{ secrets.INFRANEST_TOKEN }}
    organization: ${{ vars.INFRANEST_ORG }}
    command: maintenance-open
    check-ids: 1201,1202
    minutes: 30

Een tweede stap aan het einde van de job sluit het venster weer, ook als de deploy mislukt. Wordt de job halverwege afgebroken, dan sluit het venster na 30 minuten vanzelf.

Recept: een onderhoudsvenster vanuit je pipeline

3. Elke nieuwe service krijgt een monitor

Voeg één stap toe aan de pipeline die een nieuwe service uitrolt, en niets komt in productie zonder dat erop wordt gelet. Draait de stap twee keer, dan krijg je nog steeds één monitor, niet twee.

Recept: een monitor aanmaken bij je deploy

4. Nieuwe servers worden vanaf hun eerste uur bewaakt

Een server aangemaakt bij Hetzner, DigitalOcean of een andere gekoppelde provider? InfraNest vindt hem bij de volgende synchronisatie. Eén verzoek zet de monitoring ervoor aan, een tweede voegt een check op de website toe.

Recept: een nieuwe server gaan bewaken

5. Uptime op je eigen dashboard of in een klantrapport

Eén verzoek beantwoordt de vraag „is alles nu up?”: elke monitor en server met zijn status, openstaande incidenten en lopend onderhoud, met een samenvattende telling. Andere verzoeken geven de uptime van een monitor over de vorige maand en de geschiedenis per uur. Gebruik ze voor een wandscherm, een chatbot of het maandrapport dat je naar je klanten stuurt.

Recept: status, uptime en geschiedenis

6. Dynamische DNS, en de auditlog in je logplatform

Laat een naam als home.example.com wijzen naar een verbinding waarvan het IP-adres verandert: een klein script controleert het adres en werkt het record alleen bij als het anders is. Of kopieer elke wijziging in je workspace, in de app of via de API, één keer per dag naar een logplatform zoals Splunk of Elastic.

Recept: dynamische DNS vanuit een script · Recept: auditlog naar een SIEM

Agencies en MSP's: één klant tegelijk

Beheer je infrastructuur voor klanten? Er zijn twee manieren om een script tot één klant te beperken:

  • Eén workspace per klant (Business: 5 workspaces, Enterprise: onbeperkt). Een token werkt alleen in de workspace waarin hij is aangemaakt, dus een script voor klant A kan niet bij klant B. Een tool die echt alle workspaces nodig heeft, kan één token krijgen met Werkt in al mijn workspaces.
  • Eén workspace, een tag per klant. Vraag de status op met de tag van die klant, en je krijgt alleen diens monitors, servers, incidenten en onderhoud. Zo heb je een klantrapport in één verzoek.

Uitproberen zonder iets echts aan te raken

Elk InfraNest-abonnement, ook Free, heeft een sandbox: een privé-oefenworkspace gevuld met voorbeeld-DNS-zones, monitors met geschiedenis, twee servers met metrics, domeinen, certificaten en incidenten. Tokens die je daar aanmaakt zijn testtokens, en niets wat je daar doet bereikt een DNS-provider, een cloudprovider of het internet. Er gaan ook geen alerts uit; je ziet wat er verstuurd zou zijn.

Iets stukgemaakt? Sandbox resetten zet de voorbeelddata terug.

De quickstart kost in de sandbox ongeveer vijf minuten: lees de voorbeeldzones uit, bekijk een wijziging vooraf, voer hem uit en maak hem weer ongedaan.

Veilig in scripts die zonder toezicht draaien

Scripts draaien 's nachts als niemand meekijkt, en sommige worden door AI-codeeragents geschreven. Daarom hebben we deze waarborgen ingebouwd:

  • Tokens die jij beheert. Geef elke token alleen de onderdelen die hij nodig heeft, lezen of schrijven per gebied. Kies wanneer hij verloopt: na 30, 90, 180 of 365 dagen, met een e-mail een week van tevoren. En beperk hem tot de IP-adressen waarvandaan hij wordt gebruikt, zodat een token die uit een buildlog is gekopieerd nergens anders bruikbaar is.
Het dialoogvenster Nieuw token in InfraNest, ingevuld voor een deploy-pipeline: de token werkt in één workspace, verloopt na 90 dagen, is beperkt tot één IP-adres en mag DNS en Monitoring lezen en wijzigen.

Een token voor een deploy-pipeline: één workspace, 90 dagen, één IP-adres, alleen DNS en Monitoring.

  • Eerst bekijken, dan wijzigen. Voeg ?dry_run=1 toe aan een DNS-wijziging en zie precies welke records zouden veranderen, voor en na, zonder iets te wijzigen.
  • Herhalingen leiden nooit tot dubbelingen. Stuur bij elk nieuw verzoek een herhaalsleutel (Idempotency-Key) mee. Krijgt het verzoek een time-out en stuurt je script het opnieuw, dan krijg je nog steeds één record of één monitor, niet twee.
  • Foutmeldingen waar een script iets mee kan. Elke fout heeft een vaste code, een hint wat je moet doen en een link naar de uitleg.
  • Limieten op papier. Elke rate limit staat op de limietenpagina, en elk antwoord vertelt hoeveel ruimte je nog hebt.
  • Je scripts blijven werken. Er is één versie van de API, en die groeit alleen. Alles wat een script zou breken, wordt minstens zes maanden vooraf aangekondigd in de changelog, en de changelog heeft een RSS-feed.
  • Alles wordt vastgelegd. Elke wijziging die een token maakt, verschijnt in de auditlog onder de naam van de token.

Eén ding kan geen enkele waarborg veranderen: een token handelt namens jou. Wat hij bij je DNS- of cloudprovider wijzigt, telt als jouw wijziging, en sommige providers rekenen kosten voor API-gebruik of voor wat je wijzigt. Begin in de sandbox, en houd na de eerste runs de auditlog in de gaten. Meer in verantwoordelijkheid en kosten.

Open source, klaar om te kopiëren

Alles staat openbaar op GitHub:

  • infranest-examples: de recepten als uitvoerbare scripts, getest tegen de sandbox.
  • infranest-action: onderhoudsvensters, monitorpauzes en sandboxresets in GitHub Actions.
  • infranest-openapi: de volledige beschrijving van de API (OpenAPI 3), dagelijks bijgewerkt. Genereer er een clientbibliotheek mee, of volg de repository om op de hoogte te blijven van nieuwe functies.
  • infranest-agent: de serveragent. Hij leest alleen en verstuurt alleen: hij opent geen poorten en neemt geen opdrachten aan. Lees precies wat hij op je machines doet.
  • infranest-mcp: de koppeling met je AI-assistent uit het artikel van vorige week.

Liever klikken dan commando's typen? Importeer de kant-en-klare collectie in Postman, Bruno of Insomnia.

Bouw je een app voor anderen?

  • OAuth: je gebruikers klikken op Connect with InfraNest, keuren je app goed en kiezen één workspace. Niemand hoeft een token te kopiëren, en ze kunnen je app op elk moment verwijderen. Zie OAuth voor integraties.
  • Webhooks: InfraNest stuurt een ondertekend bericht naar jouw URL wanneer een monitor down gaat, een domein bijna verloopt of DNS-records veranderen (Pro en hoger). Zie Webhooks.

Laat een AI-codeeragent het script schrijven

Claude Code, Cursor, Codex en Copilot kunnen scripts schrijven voor de API. Elke pagina op de developersite is ook als platte tekst beschikbaar voor AI-tools (zet .md achter het adres), met een index op llms.txt. Geef de agent een testtoken voor de sandbox, en niets wat hij probeert kan je echte infrastructuur bereiken terwijl hij leert. Zie Codeeragents.

Wat het kost

API-tokens zitten bij Pro (5 tokens), Business (20) en Enterprise (onbeperkt). De sandbox en de testtokens werken op elk abonnement, ook Free, dus je kunt bouwen en testen voordat je upgradet. Zie prijzen.

Aan de slag in drie stappen

  1. Open in InfraNest Mijn account → Ontwikkelaar en maak je sandbox aan met Sandbox maken.
  2. Maak daar een testtoken aan en volg de quickstart.
  3. Werkt het? Maak dan een token aan in je echte workspace. Een eigenaar zet API-wijzigingen eenmalig aan voor de workspace; lezen werkt meteen.

Al het andere vind je op developers.infranest.io.

Veelgestelde vragen

#Bij welke InfraNest-abonnementen zit de API?

API-tokens zitten bij Pro (5 tokens), Business (20) en Enterprise (onbeperkt). De sandbox en de testtokens werken op elk abonnement, ook Free, dus je kunt bouwen en testen voordat je upgradet.

#Moet ik developer zijn om InfraNest te automatiseren?

Nee. Automatiseringen in de app („als dit gebeurt, doe dan dat”) vragen geen code, en je kunt Claude of ChatGPT op elk abonnement vragen stellen over je infrastructuur. De API is voor als je je eigen scripts, pipelines of tools de leiding wilt geven.

#Kan ik de API uitproberen zonder mijn echte infrastructuur aan te raken?

Ja. Maak een sandbox aan met Sandbox maken onder Mijn account → Ontwikkelaar. Hij is gevuld met voorbeelddata, en niets wat je daar doet bereikt een DNS-provider, een cloudprovider of het internet. Je kunt hem resetten wanneer je wilt.

#Kan een API-token domeinen registreren of servers verwijderen?

Nee. Alles wat geld kost of niet ongedaan kan worden gemaakt, zoals domeinen registreren of verlengen, servers aanmaken of verwijderen en nameservers wijzigen, blijft voorbehouden aan een persoon die in de app is ingelogd.

#Hoe houd ik een API-token veilig?

Geef hem alleen de gebieden die hij nodig heeft, kies wanneer hij verloopt (30, 90, 180 of 365 dagen) en beperk hem tot de IP-adressen waarvandaan hij wordt gebruikt. Elke wijziging die hij maakt, verschijnt in de auditlog onder de naam van de token.

#Gaan mijn scripts kapot als de API verandert?

Nee. De API heeft één versie en groeit alleen. Alles wat een script zou breken, wordt minstens zes maanden vooraf aangekondigd in de changelog.

Nieuwe artikelen, rechtstreeks in je inbox

Ik ontvang graag productupdates en nieuwe artikelen van InfraNest per e-mail. Ik kan me op elk moment afmelden.

Privacyverklaring

Gerelateerde artikelen

Begin in seconden

Breng je hele infrastructuur samen in één modern dashboard.

Gratis plan · Geen creditcard nodig · In enkele minuten ingesteld