NSgroups : Details

Aangemaakt : 18-04-2023
Laatste update: -

Omschrijving

Haal informatie op van een specifieke nameserver group

Endpoint

GET https://api.nextname.nl/v2/nsgroups/name

URL parameters

Bij dit commando worden geen extra parameters opgegeven

Antwoord

HTTP status code: 200 Ok

Parameter	Type	Omschrijving
name	String	Naam van de nameserver group
ns1	String	Nameserver 1
ns2	String	Nameserver 2
ns3	String	Nameserver 3
ns4	String	Nameserver 4
ns5	String	Nameserver 5
ns6	String	Nameserver 6
ns7	String	Nameserver 7
connections	Integer	Aantal connecties met domeinnamen
date_created	Datetime	Datum en tijdstip waarop de nameserver group werd aangemaakt in UTC tijdzone in RFC 3339
date_last_updated	Datetime	Datum en tijdstip waarop de nameserver group voor het laatst werd gewijzigd in UTC tijdzone in RFC 3339
auto_delete	Boolean	Of de nameserver group automatisch wordt opgeruimd indien er geen connecties (meer) zijn

Voorbeeld

Beschrijving:
Haal informatie van een nameserver group op

PHP
cURL

Opdracht in PHP:

<?php
$env      = "live"; // live or test
$api_key  = "XXXXXXXX-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
$api_url  = "/v2/nsgroups/mynameservers";
$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/nsgroups/mynameservers

Antwoord:

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

{
  "name": "mynameservers",
  "ns1": "ns1.domeinnaam.nl",
  "ns2": "ns2.domeinnaam.nl",
  "ns3": "ns3.domeinnaam.nl",
  "ns4": NULL,
  "ns5": NULL,
  "ns6": NULL,
  "ns7": NULL,
  "connections": 12,
  "date_created": "2020-05-26T08:44:53Z",
  "date_last_updated": "2021-03-13T12:48:12Z",
  "auto_delete": true,
}