NSgroups : Create

Aangemaakt : 18-04-2023
Laatste update: 20-12-2023

Omschrijving

Maak een nieuwe nameserver group aan

Endpoint

POST https://api.nextname.nl/v2/nsgroups/name
Content-type: application/json

Parameters

Parameter	Datatype	Verplicht	Omschrijving
name	String	Nee	Unieke naam (identifier) voor de nameserver group • Lengte min: 5 karakter • Lengte max: 20 karakters • Toegestane karakters: Letters, cijfers en - • Regexp: ^[a-zA-Z0-9\-]{5,25}$
ns1	String	Ja	Nameserver 1 • Regexp: ^(?:[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\.)+(?:[a-z][a-z0-9-]{0,61}[a-z0-9])$
ns2	String	Ja	Nameserver 2 • Regexp: ^(?:[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\.)+(?:[a-z][a-z0-9-]{0,61}[a-z0-9])$
ns3	String	Nee	Nameserver 3 • Regexp: ^(?:[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\.)+(?:[a-z][a-z0-9-]{0,61}[a-z0-9])$
ns4	String	Nee	Nameserver 4 • Regexp: ^(?:[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\.)+(?:[a-z][a-z0-9-]{0,61}[a-z0-9])$
ns5	String	Nee	Nameserver 5 • Regexp: ^(?:[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\.)+(?:[a-z][a-z0-9-]{0,61}[a-z0-9])$
ns6	String	Nee	Nameserver 6 • Regexp: ^(?:[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\.)+(?:[a-z][a-z0-9-]{0,61}[a-z0-9])$
ns7	String	Nee	Nameserver 7 • Regexp: ^(?:[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\.)+(?:[a-z][a-z0-9-]{0,61}[a-z0-9])$
auto_delete	Boolean	Nee	Ruim de nameserver group automatisch op indien er geen connecties met domeinnamen meer zijn. Indien deze parameters niet wordt opgegeven dan wordt standaard true gebruikt.

Antwoord

HTTP status code: 201 Created

Voorbeeld

Beschrijving:
Nameserver group aanmaken

PHP
cURL

Opdracht in PHP:

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

$a_data = [
            "ns1" => "ns1.domeinnaam.nl",
	    "ns2" => "ns2.domeinnaam.nl",
	    "ns3" => "ns3.domeinnaam.nl"
	  ];

$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 "Nameserver group successfully created";
}

curl_close($ch);

Opdracht in cURL:

curl -X POST -H "Content-Type: application/json" -H "Authorization: Bearer XXXXXXXX-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" \
-d '{"ns1":"ns1.domeinnaam.nl","ns2":"ns2.domeinnaam.nl","ns3":"ns3.domeinnaam.nl"}' \
https://api-test.nextname.nl/v2/nsgroups/my-nsgroup

Antwoord:

HTTP/1.1 201 Created