1. Kennisbank
  2. API
  3. NS groups : list

NS groups : List

  • Aangemaakt : 18-04-2023
  • Laatste update: -

Omschrijving

Haal lijst op met nameserver groups uit het account

Endpoint


URL parameters

Bekijk voor meer informatie over de mogelijke zoekwaarden en de pagina: Zoekopdrachten

Parameter Datatype Omschrijving
name String Zoekwaarde voor naam van de nameserver group
ns1 String Zoekwaarde voor nameserver 1
ns2 String Zoekwaarde voor nameserver 2
ns3 String Zoekwaarde voor nameserver 3
ns4 String Zoekwaarde voor nameserver 4
ns5 String Zoekwaarde voor nameserver 5
ns6 String Zoekwaarde voor nameserver 6
ns7 String Zoekwaarde voor nameserver 7
connections Integer Zoekwaarde voor aantal connecties van de nameserver group
date_created Datetime Zoekwaarde voor aanmaakdatum nameserver group, formaat: YYYY-MM-DDThh:mm:ssZ in UTC tijdzone in RFC 3339
date_last_updated Datetime Zoekwaarde voor datum laatste wijziging nameserver group, formaat: YYYY-MM-DDThh:mm:ssZ in UTC tijdzone in RFC 3339
auto_delete Boolean Zoekwaarde voor het automatisch opruimen van de nameserver group wanneer er geen connecties (meer) zijn
sort String Velden waarop gesorteerd wordt. Zie ook de pagina: Zoekopdrachten sorteren
page Integer Het paginanummer van de te tonen pagina, standaard waarde: 1. Zie ook de pagina: Paginering
per_page Integer Het aantal te tonen zoekresultaten per pagina, standaard waarde: 50. Zie ook de pagina: Paginering

Antwoord

Parameter Type Omschrijving
Array: data[] met object:
name String Naam van de nameserver group
ns1 String Nameserver 2
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 String 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
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 lijst nameserver groups op

Opdracht in PHP: 
<?php
$env      = "live"; // live or test
$api_key  = "XXXXXXXX-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
$api_url  = "/v2/nsgroups";
$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
Antwoord: 
HTTP/1.1 200 OK
Content-Type: application/json;charset=utf-8            

{
  "data": [
    {
      "name": "namservergroup1",
      "ns1": "ns1.domeinnaam.nl",
      "ns2": "ns2.domeinnaam.nl",
      "ns3": "ns3.domeinnaam.nl",
      "ns4": NULL,
      "ns5": NULL,
      "ns6": NULL,
      "ns7": NULL,
      "connections": 2,
      "date_created": "2020-05-26T08:44:53Z",
      "date_last_updated": "2021-03-13T12:48:12Z",
      "auto_delete": true,
    },
    {
      "name": "namservergroup2",
      "ns1": "ns1.domeinnaam.com",
      "ns2": "ns2.domeinnaam.com",
      "ns3": "ns3.domeinnaam.com",
      "ns4": NULL,
      "ns5": NULL,
      "ns6": NULL,
      "ns7": NULL,
      "connections": 24,
      "date_created": "2020-05-24T012:38:12Z",
      "date_last_updated": "2021-02-28T16:23:08Z",
      "auto_delete": false,
    },
  ],
  pagination": {
    "page": 1,
    "per_page": 50,
    "total_pages": 1,
    "total_results": 2
  }
}

Beschrijving:
Haal lijst met nameserver groups op waarbij het aantal connecties met domeinnamen groter is dan 5, aflopend gesorteerd op het aantal connecties

Opdracht in PHP: 
<?php
$env      = "live"; // live or test
$api_key  = "XXXXXXXX-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
$api_url  = "/v2/nsgroups?connections=>5&sort=-connections";
$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?connections=>5&sort=-connections"
Antwoord: 
HTTP/1.1 200 OK
Content-Type: application/json;charset=utf-8            

{
  "data": [
    {
      "name": "namservergroup2",
      "ns1": "ns1.domeinnaam.com",
      "ns2": "ns2.domeinnaam.com",
      "ns3": "ns3.domeinnaam.com",
      "ns4": NULL,
      "ns5": NULL,
      "ns6": NULL,
      "ns7": NULL,
      "connections": 24,
      "date_created": "2020-05-24T012:38:12Z",
      "date_last_updated": "2021-02-28T16:23:08Z",
      "auto_delete": false,
    },
  ],
  pagination": {
    "page": 1,
    "per_page": 50,
    "total_pages": 1,
    "total_results": 1
  }
}

Beschrijving:
Haal lijst met nameserver groups op waarbij namervers 1 "domeinnaam.nl", oplopend gesorteerd op "ns1", daarna afgelopend op ns2

Opdracht in PHP: 
<?php
$env      = "live"; // live or test
$api_key  = "XXXXXXXX-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
$api_url  = "/v2/nsgroups?ns1=%domeinnaam.nl&sort=ns1,-ns2";
$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?ns1=%domeinnaam.nl&sort=ns1,-ns2"
Antwoord: 
HTTP/1.1 200 OK
Content-Type: application/json;charset=utf-8            

{
  "data": [
    {
      "name": "namservergroup1",
      "ns1": "ns1.domeinnaam.nl",
      "ns2": "ns2.domeinnaam.nl",
      "ns3": "ns3.domeinnaam.nl",
      "ns4": NULL,
      "ns5": NULL,
      "ns6": NULL,
      "ns7": NULL,
      "connections": 2,
      "date_created": "2020-05-26T08:44:53Z",
      "date_last_updated": "2021-03-13T12:48:12Z",
      "auto_delete": true,
    }
  ],
  pagination": {
    "page": 1,
    "per_page": 50,
    "total_pages": 1,
    "total_results": 1
  }
}

API Documentatie

Versie V2.3b, 16-07-2025