Glue records : Create

Aangemaakt: 28-08-2026

Omschrijving

Maak een nieuwe glue record aan: koppel de hostname van een nameserver aan één of meer IP-adressen bij de registry. Je geeft in één opdracht alle IP-adressen mee die bij de host horen, zowel IPv4 als IPv6. Wil je de IP-adressen van een bestaande glue record wijzigen, gebruik dan Update.

Endpoint

POST https://api.nextname.nl/v2/glue/host
Content-type: application/json

Parameters

Parameter	Datatype	Verplicht	Omschrijving
host	String	Ja	De volledige hostname waarvoor je de glue record aanmaakt, bijvoorbeeld ns1.testdomeinnaam.nl. Wordt in het pad van het endpoint meegegeven, niet in de body.
addresses	Array	Ja	De IP-adressen die aan de host worden gekoppeld, elk als object met de parameters version en address
version	String	Ja	Het type IP-adres: v4 voor een IPv4-adres, v6 voor een IPv6-adres
address	String	Ja	Het IP-adres zelf, passend bij de opgegeven version • Gereserveerde adressen (bijvoorbeeld 127.0.0.1) worden geweigerd

Antwoord

HTTP status code: 201 Created

Wordt de opdracht geweigerd — bijvoorbeeld omdat een adres gereserveerd is — dan volgt een foutmelding. Bekijk voor de opbouw daarvan de pagina Foutmelding. Mislukte pogingen zijn terug te vinden via History.

Voorbeeld

Beschrijving:
Maak de glue record ns1.testdomeinnaam.nl aan met twee IPv4-adressen en één IPv6-adres.

Body:

{
  "addresses": [
    {
      "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"
    }
  ]
}

PHP
cURL

Opdracht in PHP:

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

$a_data = [
            "addresses" => [
                             ["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"]
                           ]
          ];

$json_data = json_encode($a_data);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $api_host . $api_url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $json_data);
curl_setopt($ch, CURLOPT_HTTPHEADER, array("Authorization: Bearer $api_key", "Content-Type: application/json"));
$output = curl_exec($ch);

if(curl_getinfo($ch, CURLINFO_HTTP_CODE) === 201) {
  echo "Glue record successfully created";
}

curl_close($ch);

Opdracht in cURL:

curl -X POST -H "Authorization: Bearer XXXXXXXX-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" \
-H "Content-Type: application/json" \
-d '{"addresses":[{"version":"v4","address":"185.84.140.164"},{"version":"v6","address":"2001:07b8:060c:0001:0004:0100:16e2:0001"}]}' \
https://api-test.nextname.nl/v2/glue/ns1.testdomeinnaam.nl

Antwoord:

HTTP/1.1 201 Created