--- title: "De DNSense API gebruiken met een API-sleutel | DNSense" description: "Maak een API-sleutel, roep de DNSense API aan vanuit een script en houd de sleutel veilig. Met curl-voorbeelden voor zones opvragen en een record toevoegen." canonical_url: "https://dnsense.io/nl/learn/how-to-use-the-dnsense-api-with-an-api-key" locale: nl meta: "og:description": "Maak een API-sleutel, roep de DNSense API aan vanuit een script en houd de sleutel veilig. Met curl-voorbeelden voor zones opvragen en een record toevoegen." "og:image": "https://dnsense.io/_nuxt/blog-api-key-dnsense.CBel4Pdh.jpg" "og:image:alt": "DNSense handleiding-cover: een API-sleutel die één keer wordt getoond" "og:title": "De DNSense API gebruiken met een API-sleutel | DNSense" --- > Index of every page on this site: [llms.txt](https://dnsense.io/llms.txt) # De DNSense API gebruiken met een API-sleutel **Dennis Postma****20 oktober 2026** **Leestijd****4 minuten** **Handleidingen** Maak een API-sleutel, roep de DNSense API aan vanuit een script en houd de sleutel veilig. Met curl-voorbeelden voor zones opvragen en een record toevoegen. ![DNSense handleiding-cover: een API-sleutel die één keer wordt getoond](https://dnsense.io/_nuxt/blog-api-key-dnsense.CBel4Pdh.jpg) Hetzelfde record met de hand aan dertig zones toevoegen is werk dat een script beter doet. DNSense heeft daar een API voor, en met een API-sleutel logt een script in zonder je wachtwoord. ## Wat een sleutel kan Een sleutel werkt als jij. Hij bereikt de zones, domeinen en koppelingen van het team waarin je werkt en kan doen wat je rol toestaat. Wijzigingen ermee komen in de zonegeschiedenis en de auditlog, net als alle andere. Eén grens: een sleutel kan je login, tweestapsverificatie en API-sleutels niet beheren. Daarvoor moet je zelf in de app zijn ingelogd, zodat een gelekte sleutel geen nieuwe sleutels kan maken en zichzelf niet kan verlengen. ## Een sleutel aanmaken 1. Open **Account** en zoek **API keys**. 2. Klik op **Create key** en geef hem de naam van de plek waar hij draait, zoals `CI pipeline`. 3. Kopieer het geheim. DNSense toont het één keer. Bewaar het in je wachtwoordmanager of in de secret store van je CI. Zet het nooit in een repository. ## Een verzoek doen Stuur het geheim mee als Bearer-token. Vraag de zones op die je kunt bereiken: ``` curl -H "Authorization: Bearer " https://api.dnsense.io/zones ``` Voeg een A-record toe aan een zone: ``` curl -X POST https://api.dnsense.io/zones//records \ -H "Authorization: Bearer " \ -H "Content-Type: application/json" \ -d '{"record": {"name": "shop", "type": "A", "content": "198.51.100.7", "ttl": 3600}}' ``` DNSense zet de wijziging in de wachtrij en voert hem uit bij de provider die de zone beheert. Een lege of ontbrekende `name` is de apex van de zone. Vraagt je team om goedkeuring voor wijzigingen, dan wacht deze erop, net als vanuit de app. De volledige lijst met endpoints en de velden per endpoint staat op `https://api.dnsense.io/docs`. ## Houd sleutels klein en gescheiden Maak één sleutel per taak. Als de pipeline wordt opgeheven, verwijder je zijn sleutel en gaat er niets anders stuk. De lijst toont wanneer elke sleutel is aangemaakt en voor het laatst gebruikt, dus een sleutel die al maanden niemand gebruikt, valt snel op. - **Disable** pauzeert een sleutel. Schakel hem weer in als je hem nodig hebt. - **Rotate** geeft een nieuw geheim uit en trekt het oude direct in. Doe dit als iemand die het geheim kende vertrekt en pas aan waar de sleutel wordt gebruikt. - **Delete** verwijdert de sleutel definitief. Aanmaken, vernieuwen, uitschakelen en verwijderen komen allemaal in de auditlog. ## Als een verzoek mislukt - `401`: de sleutel is fout, uitgeschakeld of verwijderd. Controleer de header en de sleutellijst. - `403`: je rol staat het niet toe. Een sleutel heeft nooit meer rechten dan jij. - `400`: een veld ontbreekt of is ongeldig. De melding noemt het veld. ```json {"@context":"https://schema.org","@graph":[{"@id":"https://dnsense.io/#website","@type":"WebSite","description":"Manage every domain, DNS zone and record from one platform. Connect the registrars you already use, share zones with your team or clients, and keep a full history of every change.","inLanguage":"nl-NL","name":"DNSense","url":"https://dnsense.io/","publisher":{"@id":"https://dnsense.io/#identity"},"translationOfWork":{"@id":"https://dnsense.io/#website"}},{"@id":"https://dnsense.io/nl/learn/how-to-use-the-dnsense-api-with-an-api-key#webpage","@type":"WebPage","datePublished":"2026-10-20","description":"Maak een API-sleutel, roep de DNSense API aan vanuit een script en houd de sleutel veilig. Met curl-voorbeelden voor zones opvragen en een record toevoegen.","name":"De DNSense API gebruiken met een API-sleutel","url":"https://dnsense.io/nl/learn/how-to-use-the-dnsense-api-with-an-api-key","breadcrumb":{"@id":"https://dnsense.io/nl/learn/how-to-use-the-dnsense-api-with-an-api-key#breadcrumb"},"isPartOf":{"@id":"https://dnsense.io/#website"},"potentialAction":[{"@type":"ReadAction","target":["https://dnsense.io/nl/learn/how-to-use-the-dnsense-api-with-an-api-key"]}],"primaryImageOfPage":{"@id":"https://dnsense.io/#logo"}},{"@id":"https://dnsense.io/#identity","@type":"Organization","email":"support@dnsense.io","name":"DNSense","url":"https://dnsense.io","logo":{"@id":"https://dnsense.io/#logo"},"sameAs":["https://www.linkedin.com/showcase/dnsense","https://twitter.com/dnsense_dns","https://discord.gg/GC9p7TY9Ex"]},{"@id":"https://dnsense.io/nl/learn/how-to-use-the-dnsense-api-with-an-api-key#article","@type":"Article","datePublished":"2026-10-20","description":"Maak een API-sleutel, roep de DNSense API aan vanuit een script en houd de sleutel veilig. Met curl-voorbeelden voor zones opvragen en een record toevoegen.","headline":"De DNSense API gebruiken met een API-sleutel","inLanguage":"nl-NL","thumbnailUrl":"https://dnsense.io/_nuxt/blog-api-key-dnsense.CBel4Pdh.jpg","author":{"@id":"https://dnsense.io/#/schema/person/1"},"image":{"@id":"https://dnsense.io/#/schema/image/1"},"isPartOf":{"@id":"https://dnsense.io/nl/learn/how-to-use-the-dnsense-api-with-an-api-key#webpage"},"mainEntityOfPage":{"@id":"https://dnsense.io/nl/learn/how-to-use-the-dnsense-api-with-an-api-key#webpage"},"publisher":{"@id":"https://dnsense.io/#identity"}},{"@id":"https://dnsense.io/nl/learn/how-to-use-the-dnsense-api-with-an-api-key#breadcrumb","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","name":"Home","item":"https://dnsense.io/nl","position":1},{"@type":"ListItem","name":"Kennisbank","item":"https://dnsense.io/nl/learn","position":2},{"@type":"ListItem","name":"De DNSense API gebruiken met een API-sleutel","item":"https://dnsense.io/nl/learn/how-to-use-the-dnsense-api-with-an-api-key","position":3}]},{"@id":"https://dnsense.io/#/schema/person/1","@type":"Person","name":"Dennis Postma"},{"@id":"https://dnsense.io/#logo","@type":"ImageObject","caption":"DNSense","contentUrl":"https://dnsense.io/icon-512.png","inLanguage":"nl-NL","url":"https://dnsense.io/icon-512.png"},{"@id":"https://dnsense.io/#/schema/image/1","@type":"ImageObject","contentUrl":"https://dnsense.io/_nuxt/blog-api-key-dnsense.CBel4Pdh.jpg","inLanguage":"nl-NL","url":"https://dnsense.io/_nuxt/blog-api-key-dnsense.CBel4Pdh.jpg"}]} ``` ## Sitemap See the full [sitemap](https://dnsense.io/sitemap.md) for all pages.