Glue records : History

Aangemaakt: 28-08-2026

Omschrijving

Haal de lijst op met alle wijzigingen die aan een glue record zijn gedaan: aanmaken en verwijderen, de bijbehorende IP-adressen vóór en na de wijziging, en via welk kanaal de opdracht werd gegeven. Ook mislukte opdrachten worden vastgelegd, inclusief de reden.

Endpoint

GET https://api.nextname.nl/v2/glue/host/history

URL parameters

Bekijk voor de volledige syntax van zoekwaarden, operatoren en paginering de pagina Zoekopdrachten.

Parameter	Datatype	Omschrijving
date	Datetime	Zoekwaarde voor de datum en het tijdstip waarop de wijziging werd gemaakt, formaat: YYYY-MM-DDThh:mm:ssZ in UTC tijdzone volgens RFC 3339

Antwoord

HTTP status code: 200 Ok

Parameter	Type	Omschrijving
Array: data[] met object:
action	String	De uitgevoerde opdracht: create (glue record aangemaakt) of delete (glue record verwijderd)
status	String	Het resultaat van de opdracht: success of failed
message	String	Toelichting bij een mislukte opdracht, bijvoorbeeld Host address: 127.0.0.1 reserved and cannot be used. Bij een geslaagde opdracht is dit null
date	Datetime	Datum en tijdstip waarop de wijziging werd gemaakt in UTC tijdzone volgens RFC 3339
event_id	String	Unieke ID van de gebeurtenis, of null bij oudere wijzigingen waarvoor nog geen ID werd vastgelegd
addresses_before	Array	De IP-adressen zoals ze vóór de wijziging bekend waren, elk als object met version (v4 of v6) en address. Alleen aanwezig bij delete
addresses_after	Array	De IP-adressen zoals ze na de wijziging zijn vastgelegd, zelfde opbouw als addresses_before. Alleen aanwezig bij create
initiated_via	Object	Het kanaal waarlangs de opdracht is gegeven: interface: api-v2, api-v1 of web (het control panel) api_key_prefix: de eerste tekens van de gebruikte API-key, alleen aanwezig bij een opdracht via de API
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 glue record ns1.testdomeinnaam.nl. In het antwoord staan zowel geslaagde als mislukte opdrachten, gegeven via de API en via het control panel.

PHP
cURL

Opdracht in PHP:

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

Antwoord:

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

{
  "data": [
    {
      "action": "create",
      "status": "success",
      "message": null,
      "date": "2026-08-27T06:11:48Z",
      "event_id": null,
      "addresses_after": [
        {
          "version": "v4",
          "address": "124.124.124.124"
        }
      ],
      "initiated_via": {
        "interface": "api-v1"
      }
    },
    {
      "action": "delete",
      "status": "success",
      "message": null,
      "date": "2026-08-27T12:14:05Z",
      "event_id": null,
      "addresses_before": [
        {
          "version": "v4",
          "address": "124.124.124.124"
        }
      ],
      "initiated_via": {
        "interface": "web"
      }
    },
    {
      "action": "create",
      "status": "failed",
      "message": "Host address: 127.0.0.1 reserved and cannot be used",
      "date": "2026-08-27T12:14:50Z",
      "event_id": null,
      "addresses_after": [
        {
          "version": "v4",
          "address": "127.0.0.1"
        }
      ],
      "initiated_via": {
        "interface": "web"
      }
    },
    {
      "action": "create",
      "status": "success",
      "message": null,
      "date": "2026-08-28T06:58:54Z",
      "event_id": "acb6a2989837cacc",
      "addresses_after": [
        {
          "version": "v4",
          "address": "185.84.140.164"
        },
        {
          "version": "v4",
          "address": "80.127.105.252"
        },
        {
          "version": "v6",
          "address": "2001:07b8:060c:0001:0004:0100:16e2:0001"
        }
      ],
      "initiated_via": {
        "interface": "api-v2",
        "api_key_prefix": "Ab12Cd34"
      }
    }
  ],
  "pagination": {
    "current_page": 1,
    "per_page": 50,
    "total_pages": 1,
    "total_results": 4
  }
}