API & webhooks

Eén REST API voor je hele stack

Alles wat je in InfraNest kunt doen, kun je automatiseren. Domeinen, DNS, servers, certificaten en monitoring zitten achter één endpoint en één token — met ondertekende webhooks en ingest-endpoints voor de tools die je al gebruikt.

Verken de API-documentatie →Haal een API-sleutel

Gratis plan · Geen creditcard nodig · Scoped tokens in seconden

api.infranest.app

200 OK

# DNS-records opsommen
curl https://api.infranest.app/v1/dns/records \
  -H "Authorization: Bearer inf_live_•••"

{
  "data": [
    { "type": "A", "name": "@", "synced": true }
  ]
}

Eén API voor alles wat InfraNest doet

Elk productgebied is beschikbaar via dezelfde REST-API — schone JSON, één token, en dezelfde acties die je in het dashboard zou doen.

Domeinen & contacten

Registreer, zet over, verleng en lees domeinen, contacten en verloop bij alle registrars.

GET /v1/domains

DNS

Maak, werk bij en synchroniseer zones, records en sjablonen — met driftdetectie.

POST /v1/dns/zones/{id}/records

Servers & cloud

Provisioneer, herstart, maak snapshots en lees metrics van servers, volumes en firewalls.

POST /v1/servers/{id}/actions

Certificaten

Lees je certificaatinventaris, verloop, beveiligingshouding en dekkingsgaten.

GET /v1/certificates

Monitoring

Beheer checks, lees incidenten en onderhoud, en stuur statuspagina’s aan.

GET /v1/monitors

Dynamisch IP

Beheer dynamische IP-bronnen en de records en firewallregels die ze aansturen.

GET /v1/dynamic-ips

Tokens met precies de toegang die je nodig hebt

Geef elk API-token alleen de rechten die het nodig heeft — lezen of schrijven, per gebied — met een optioneel verloop. Zie wanneer een token voor het laatst is gebruikt, en trek het op elk moment in.

Lees- of schrijftoegang per gebied — of alleen-lezen en volledige toegang
Optioneel verloop; het token wordt één keer getoond, daarna blijft alleen een hint
Fair-use rate limits houden alles stabiel

Nieuw API-token · ci-deploy-botAanmaken

dns.write

domains.read

monitoring.read

cloud.write

inf_live_9f2c•••••••••••••••• · verloopt over 90 d

Webhooks voor de events die er voor jou toe doen

Wijs een URL naar de events die je kiest en InfraNest post ernaartoe wanneer ze gebeuren — elk bericht ondertekend zodat je kunt verifiëren dat het echt van ons komt. Leveringen worden gelogd, en mislukkingen worden automatisch opnieuw geprobeerd.

domain.expiringdomain.status_changeddns.records_changedserver.status_changedmonitor.alertwatched_domain.dropping_soonwatched_domain.availablewatched_domain.registered

POSTyour-app.com/webhooks

X-InfraNest-Event: domain.expiring
X-InfraNest-Timestamp: 1720353600
X-InfraNest-Signature: sha256=a1b2c3…

{
  "event": "domain.expiring",
  "data": { "domain": "example.com", "expires_at": "2026-08-01" }
}

Ingest-endpoints voor de tools die je al gebruikt

Eenvoudige, token-beveiligde endpoints die je infrastructuur naar InfraNest toe aanroept — geen login, elk met zijn eigen scoped token.

Dynamische-IP-updates

Je router of ddclient meldt een wisselend IP, en je DNS-records en firewallregels werken zich automatisch bij.

Heartbeats

Een cronjob pingt een unieke URL volgens een schema — een ontbrekende ping geeft een melding.

Deploy-hooks

Trigger een deploy vanuit je CI/CD-pipeline met een eenvoudige inkomende webhook — gelogd met wie het deed.

Externe probes

Voer monitoringchecks uit vanaf je eigen locaties en stuur de resultaten veilig terug.

Serveragent

Een lichte agent op je servers pusht data naar binnen — zoals de certificaten van een server in je inventaris.

Veilig van opzet

Elk token krijgt alleen de toegang die je kiest, met optioneel verloop

Ondertekende webhooks die je kunt verifiëren — zodat je weet dat ze van InfraNest komen

Veilige levering, en elk geheim versleuteld opgeslagen

Fair-use rate limits en een volledig auditlog van elke actie

API- & webhook-FAQ’s

Hoe verifieer ik dat een webhook echt van InfraNest komt?

Elke webhook wordt ondertekend met een geheim dat alleen jij en InfraNest delen. Elk verzoek draagt een signature-header — herbereken die uit de request-body en je geheim, en controleer of de twee overeenkomen. Zo ja, dan komt het bericht echt van InfraNest en is het onderweg niet gewijzigd. Stapsgewijze voorbeelden staan in de documentatie.

Welke events kunnen webhooks versturen?

Een domein dat verloopt of van status verandert, DNS-records die wijzigen, een server die up of down gaat, een monitoringmelding, en de drop-catch-levenscyclus (een gevolgd domein dat beschikbaar komt of geregistreerd wordt). Je kiest precies welke events elke endpoint ontvangt.

Heb ik een betaald plan nodig om de API te gebruiken?

Je kunt op het gratis plan starten. API-toegang en het aantal webhook-endpoints schalen mee met je plan, dus zwaardere automatisering zit op de betaalde niveaus.

Is er een rate limit?

Ja — fair-use limieten beschermen het platform en schalen mee met je plan. Als je er een raakt, antwoordt de API met een duidelijke “probeer het zo opnieuw”-reactie, zodat je script kan terugschakelen en opnieuw proberen.

Bouw op InfraNest

Volledige endpoint-referentie, authenticatie en voorbeelden vind je in de interactieve API-documentatie.

Open de API-documentatie Kennisbank

Gratis plan · Geen creditcard nodig