DNS templates : 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/dns/templates/dnstemplate/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 wijzigingen gemaakt 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
template_name	Object	De gewijzigde naam van de template: update: array met de gewijzigde gegevens
deleted	Boolean	Geeft aan dat de template werd verwijderd
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

Voorbeelden

Beschrijving:
Haal alle wijzigingen van DNS template 43d3fd8a4f45cbee op die na 30-04-2024 zijn gemaakt

PHP
cURL

Opdracht in PHP:

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

Antwoord:

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

{
  "data": [
    {
      "date": "2024-05-18T19:21:48Z",
      "deleted": "true" 
    },
    {
      "date": "2024-05-14T11:20:17Z",
      "template_name": {
	"update": [
	  {
	    "update_type": "old",
	    "template_name": "parked-domains"
	  },
	  {
	    "update_type": "new",
	    "template_name": "some-template-name"
  	  }
        ]
      },
      "ttl": {
        "update": [
	  {
	    "update_type": "old",
	    "ttl": "0"
	  },
	  {
	    "update_type": "new",
	    "ttl": "3600"
	  }
	]
      }    
    },
    {
      "date": "2024-05-12T19:43:19Z",
      "records": {
	"add": [
	  {
	    "record_id": "a6031e47260b8f7e",
	    "name": "shop",
	    "type": "A",
	    "content": "123.123.123.123",
	    "date_created": "2024-05-12T19:43:19Z",
	    "date_last_updated": null
	  }
        ],
	"del": [
	  {
	    "record_id": "a6031e36160b8f4a",
	    "name": "store",
	    "type": "A",
	    "content": "123.123.123.124",
	    "date_created": "2024-05-01T08:15:37Z",
	    "date_last_updated": null
	  },
	  {
	    "record_id": "b21b27807f8f89007",
	    "name": "webstore",
	    "type": "A",
	    "content": "123.123.123.124",
	    "date_created": "2024-05-01T08:15:34Z",
	    "date_last_updated": null
	  }
        ]
      }   
    },
    {
      "date": "2024-05-06T13:57:23Z",
      "records": {
	"update": [
	  {
            "update_type" : "old",
	    "record_id": "23dd59754cee1f59",
	    "name": "www",
	    "type": "A",
	    "content": "123.123.123.123",
	    "date_created": "2024-05-12T19:43:19Z",
	    "date_last_updated": null
	  },
	  {
            "update_type" : "new",
	    "record_id": "23dd59754cee1f59",
	    "name": "www",
	    "type": "A",
	    "content": "123.123.123.124",
	    "date_created": "2024-05-12T19:43:19Z",
	    "date_last_updated": "2024-05-06T13:57:23Z"
	  }
        ]
      }
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 50,
    "total_pages": 1,
    "total_results": 3
  }
}