Domains : DNS zone

Aangemaakt : 05-07-2024
Laatste update: -

Omschrijving

Haal de informatie op van de DNS zone van een domeinnaam die de nameservers van NextName gebruikt

Endpoint

GET https://api.nextname.nl/v2/domains/domain/dnszone

URL parameters

Bij dit commando worden geen extra parameters opgegeven

Antwoord

HTTP status code: 200 Ok

Parameter	Type	Omschrijving
ttl	Integer	TTL (Time To Live) van de DNS zone
date_last_updated	String	Datum en tijdstip waarop de DNS zone voor het laatst werd gewijzigd in UTC tijdzone in RFC 3339 Beschikbaar voor DNS zones gewijzigd na 01-01-2024 00:00:00
soa_serial	Integer	Het serienummer van het SOA record van de DNS zone, formaat: YYYYMMDDnn
snapshot_count	Integer	Aantal beschikbare snapshots
history_count	Integer	Aantal wijzigingen die zijn gemaakt aan de DNS zone

Voorbeeld

Beschrijving:
Haal de DNS zone informatie op van een domeinnaam

PHP
cURL

Opdracht in PHP:

<?php
$env      = "live"; // live or test
$api_key  = "XXXXXXXX-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
$api_url  = "/v2/domains/testdomeinnaam.nl/dnszone";
$api_host = $env === "live" ? "https://api.nextname.nl" : "https://api-test.nextname.nl";

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $api_host . $api_url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, array("Authorization: Bearer $api_key"));
$output = curl_exec($ch);
curl_close($ch);

echo $output;

Opdracht in cURL:

curl -H "Authorization: Bearer XXXXXXXX-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" \
https://api-test.nextname.nl/v2/domains/testdomeinnaam.nl/dnszone

Antwoord:

HTTP/1.1 200 OK
Content-Type: application/json;charset=utf-8

{
  "ttl": 7200,
  "date_last_updated": "2023-10-13T23:18:12Z",
  "soa_serial": 2023101301,
  "snapshot_count": 5,
  "history_count": 23
}