Domains : DNS zone : history

Aangemaakt : 05-07-2024
Laatste update: -

Omschrijving

Haal lijst op met alle gemaakte wijzigingen aan de DNS zone

Endpoint

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

URL parameters

Bekijk voor meer informatie over de mogelijke zoekwaarden en de pagina: Zoekopdrachten

Parameter	Datatype	Omschrijving
date	Datetime	Datum en tijdstip waarop de wijziging werd gemaakt in UTC tijdzone in RFC 3339 Beschikbaar voor records aangemaakt na 01-01-2024 00:00:00

Antwoord

HTTP status code: 200 Ok

Parameter	Type	Omschrijving
Array: data[] met objecten:
date	Integer	Datum en tijdstip waarop het record werd aangemaakt UTC tijdzone in RFC 3339
records	Object	De gewijzigde records per type: add: array met alle toegevoegde records update: array met alle gewijzigde records del: array met alle verwijderde records
ttl	Object	De gewijzigde TTL: update: array met de gewijzigde gegevens
Object: pagination
current_page	Integer	Huidige pagina
per_page	Integer	Aantal resultaten per pagina
total_pages	Integer	Totaal aantal pagina's
total_results	Integer	Totaal aantal resultaten

Voorbeeld

Beschrijving:
Haal de geschiedenis op van de gemaakte wijzigingen aan een DNS zone

PHP
cURL

Opdracht in PHP:

<?php
$env      = "live"; // live or test
$api_key  = "XXXXXXXX-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
$api_url  = "/v2/domains/testdomeinnaam.nl/dnszone/history";
$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/history

Antwoord:

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

{
  "data":[
    {
      "date":"2024-03-12T12:39:22Z",
      "ttl":{
        "update":[
          {
            "update_type":"old",
            "ttl":"7200"
          },
          {
            "update_type":"new",
            "ttl":"3600"
          }
        ]
      }
    },   
    {
      "date":"2024-03-10T11:13:38Z",
      "records":{
        "add":[
          {
            "record_id":"6eabd1c01715889a",
            "name":"@",
            "fqdn":"testdomeinnaam.nl",
            "type":"MX",
            "content":"12.12.12.113",
            "priority":10,
            "date_created":"2024-03-10T11:13:38Z",
            "date_last_updated":null
          }
        ],
        "update":[
          {
            "update_type":"old",
            "record_id":"c997b17c02a2ba84",
            "name":"@",
            "fqdn":"testdomeinnaam.nl",
            "type":"MX",
            "content":"12.12.12.104",
            "priority":10,
            "date_created":"2024-01-23T18:04:52Z",
            "date_last_updated":"2024-06-14T11:11:42Z"
          },
          {
            "update_type":"new",
            "record_id":"c997b17c02a2ba84",
            "name":"@",
            "fqdn":"testdomeinnaam.nl",
            "type":"MX",
            "content":"12.12.12.105",
            "priority":10,
            "date_created":"2024-03-10T11:13:38Z",
            "date_last_updated":null
          }
        ],
        "del":[
          {
            "record_id":"c997b17c02a2ba84",
          },
          {
            "record_id":"0e879bd5735b4a14",
          },
        ]
      }
    }
  ],
  "pagination":{
    "current_page":1,
    "per_page":50,
    "total_pages":1,
    "total_results":2
  }
}