Direct naar de inhoud

DNSense API-documentatie: een API voor domein- en DNS-beheer

Account

Eén REST API om domeinen en DNS te beheren bij Cloudflare, Route 53, TransIP en meer. Bekijk de referentie op api.dnsense.io/docs, inclusief OpenAPI-download.

Een API-sleutel met de naam CI pipeline met de acties uitschakelen, vernieuwen en verwijderen

Eén API voor domeinen en DNS, bij welke provider ze ook staan

De meeste teams verdelen hun domeinen over een paar registrars en DNS-hosts. Elk heeft een eigen API, eigen authenticatie en een eigen idee van hoe een record eruitziet. DNSense zet er één REST API voor.

Je stuurt hetzelfde verzoek, of de zone nu bij Cloudflare, Route 53 of TransIP staat. DNSense voert de wijziging uit bij de provider die de zone beheert. Alle ondersteunde providers staan op een rij.

De referentie van elk endpoint staat hier:

https://api.dnsense.io/docs

De DNSense API-referentie voor domein- en DNS-beheer, met links de lijst met endpoints en rechts de panelen Server, Authentication en Client Libraries

Wat je via de API kunt beheren

De zijbalk groepeert endpoints per onderdeel. Deze gebruiken de meeste mensen eerst:

  • Zones: zones opvragen en DNS-records toevoegen, wijzigen of verwijderen.
  • Domains en Connections: de domeinen van je team en de provideraccounts waar ze vandaan komen.
  • Templates: herbruikbare sets records die je op andere zones toepast.
  • Teams en Spaces: leden, rollen en uitnodigingen.
  • Audit Log: elke wijziging met een sleutel, naast de zonegeschiedenis.

Alles wat je in de app kunt, kan een script ook. Een sleutel werkt als jij, binnen je rol, dus goedkeuringen blijven gelden.

Verzoeken authenticeren

Maak eerst een API-sleutel aan, zie hoe maak en beheer ik een API-sleutel. Stuur hem mee als Bearer-token in de Authorization-header. Het paneel Authentication op de referentiepagina neemt ook een sleutel aan, zodat de voorbeeldverzoeken hem voor je invullen.

Je eerste verzoek

Vraag de zones op die je sleutel kan bereiken:

curl -H "Authorization: Bearer <jouw sleutel>" https://api.dnsense.io/zones

Een voorbeeld met een record en de details eromheen lees je in hoe je de DNSense API gebruikt met een API-sleutel.

Uitproberen, importeren of een client genereren

Kies onder Client Libraries een taal voor een voorbeeld in Shell, Ruby, Node.js, PHP of Python. Met Open API Client verstuur je een verzoek direct vanaf de pagina.

De pagina biedt ook het OpenAPI-document aan als JSON en YAML. Importeer het in Postman of Insomnia, of geef het aan een codegenerator voor een getypeerde client in je eigen taal.

Veelgestelde vragen

Is er één API voor meerdere DNS-providers?

Ja. De DNSense API werkt op zones van elke gekoppelde provider, met dezelfde endpoints en hetzelfde recordformaat. Je schrijft dus geen nieuwe integratie per registrar.

Heeft de DNSense API een OpenAPI-specificatie?

Ja. Download hem als JSON of YAML via api.dnsense.io/docs.

Welke abonnementen bevatten API-toegang?

Alle. Er zit niets in DNSense achter een abonnement.

Kan een AI-assistent de API gebruiken?

Ja, via MCP. Lees kan ik Claude of een andere AI-assistent koppelen of bekijk API-sleutels en MCP voor het overzicht.

Hulp nodig?

Vragen over de API? Neem contact op met ons supportteam.