Domains : DNS templates : records

Aangemaakt : 05-07-2024
Laatste update: -

Omschrijving

Haal lijst op met alle DNS records van een DNS template

Endpoint

GET https://api.nextname.nl/v2/dnstemplates/dnstemplate/records

URL parameters

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

Parameter	Datatype	Omschrijving
record_id	String	Zoekwaarde van de unieke ID van het record
name	String	Zoekwaarde van de naam van het record (subdomein)
type	Array	Zoekwaarde voor het type record, mogelijke waarden: A, CNAME, , TXT, MX, SRV, AAAA, NS, CAA, TLSA, URLFWD (URL Forward), URLFWD301* (URL Forward 301), URLCLO (URL Cloaking)*, URLFWD, URLFWD301 en URLCLO zijn geen officiële DNS records. Stel je deze records in dan wordt er een A en AAAA record toegevoegd voor de betreffende hostnaam die naar onze server verwijst die de forwards op webserver-niveau afhandelt.
content	String	Zoekwaarde voor de inhoud van het DNS record
priority	Integer	Zoekwaarde voor priority
weight	Integer	Zoekwaarde voor weight
port	Integer	Zoekwaarde voor port
date_created	Datetime	Datum en tijdstip waarop het record werd aangemaakt UTC tijdzone in RFC 3339 Beschikbaar voor records aangemaakt na 01-01-2024 00:00:00
date_last_updated	Datetime	Datum en tijdstip waarop het record voor het laatst werd gewijzigd UTC tijdzone in RFC 3339 Beschikbaar voor records gewijzigd na 01-01-2024 00:00:00

Antwoord

HTTP status code: 200 Ok

Parameter	Type	Omschrijving
Array: data[] met objecten:
record_id	Integer	Unieke ID van het DNS record (string, 16 karakters)
name	String	De (host)naam van het record zonder de domeinnaam
type	String	Type van het DNS record, mogelijke waarden: A, CNAME, , TXT, MX, SRV, AAAA, NS, CAA, TLSA, URLFWD (URL Forward), URLFWD301 (URL Forward 301), URLCLO (URL Cloaking)
content	String	De inhoud/waarde van het DNS record
priority	Integer	De prioriry van het DNS record, alleen zichtbaar bij MX of SRV records
weight	Integer	De weight van het DNS record, alleen zichtbaar bij SRV records
port	Integer	De port van het DNS record, alleen zichtbaar bij SRV records
date_created	Datetime	Datum en tijdstip waarop het record werd aangemaakt UTC tijdzone in RFC 3339 Beschikbaar voor records aangemaakt na 01-01-2024 00:00:00
date_last_updated	Datetime	Datum en tijdstip waarop het record voor het laatste werd gewijzigd UTC tijdzone in RFC 3339 Beschikbaar voor records aangemaakt na 01-01-2024 00:00:00
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 met DNS records van een DNS template

PHP
cURL

Opdracht in PHP:

<?php
$env      = "live"; // live or test
$api_key  = "XXXXXXXX-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
$api_url  = "/v2/domains/testdomeinnaam.nl/dns/templates/parked-domains/records";
$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/dns/templates/parked-domains/records

Antwoord:

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

{
  "data": [
    {
      "record_id": "a038dfdceec363ed",
      "name": "www",
      "type": "A",
      "content": "123.123.123.123",
      "date_created": "2023-10-26T18:38:20Z",
      "date_last_updated": null
    },    
    {
      "record_id": "35acff33afefb5bc",
      "name": "@",
      "type": "A",
      "content": "123.123.123.123",
      "date_created": "2023-10-28T18:38:20Z",
      "date_last_updated": null
    },    
    {
      "record_id": "ff66879aaff3ed35",
      "name": "@",
      "type": "AAAA",
      "content": "2001:1AF8:4700:A104:11::0000",
      "date_created": "2023-10-26T18:38:21Z",
      "date_last_updated": null
    },  
    {
      "record_id": "dc498ecfe0d33eef",
      "name": "@",
      "type": "MX",
      "priorty": 10,
      "content": "mail.somemailserver.com",
      "date_created": "2023-10-28T14:22:30Z",
      "date_last_updated": "2023-11-01T12:59:02Z",
    },   
  ],
  pagination": {
    "page": 1,
    "per_page": 50,
    "total_pages": 1,
    "total_results": 4
  }
}

Beschrijving:
Haal een lijst op met alle MX records van een DNS template

PHP
cURL

Opdracht in PHP:

<?php
$env      = "live"; // live or test
$api_key  = "XXXXXXXX-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
$api_url  = "/v2/domains/testdomeinnaam.nl/dns/templates/parked-domains/records?type=MX";
$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/domains/testdomeinnaam.nl/dnszone/records?type=MX"

Antwoord:

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

{
  "data": [  
    {
      "record_id": "dc498ecfe0d33eef",
      "name": "@",
      "type": "MX",
      "priorty": 10,
      "content": "mail.somemailserver.com",
      "date_created": "2023-10-28T14:22:30Z",
      "date_last_updated": "2023-11-01T12:59:02Z",
    }   
  ],
  pagination": {
    "page": 1,
    "per_page": 50,
    "total_pages": 1,
    "total_results": 1
  }
}

Beschrijving:
Haal een lijst met DNS records op gesorteerd op creatiedatum

PHP
cURL

Opdracht in PHP:

<?php
$env      = "live"; // live or test
$api_key  = "XXXXXXXX-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
$api_url  = "/v2/domains/testdomeinnaam.nl/dnszone/records?sort=date_created";
$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/domains/testdomeinnaam.nl/dnszone/records?sort=date_created"

Antwoord:

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

{
  "data": [
    {
      "record_id": "dc498ecfe0d33eef",
      "name": "@",
      "type": "MX",
      "priorty": 10,
      "content": "mail.somemailserver.com",
      "date_created": "2023-10-28T14:22:30Z",
      "date_last_updated": "2023-11-01T12:59:02Z",
    }, 
    {
      "record_id": "ff66879aaff3ed35",
      "name": "@",
      "type": "AAAA",
      "content": "2001:1AF8:4700:A104:11::0000",
      "date_created": "2023-10-26T18:38:21Z",
      "date_last_updated": null
    },  
    {
      "record_id": "35acff33afefb5bc",
      "name": "@",
      "type": "A",
      "content": "123.123.123.123",
      "date_created": "2023-10-28T18:38:20Z",
      "date_last_updated": null
    },      
    {
      "record_id": "a038dfdceec363ed",
      "name": "www",
      "type": "A",
      "content": "123.123.123.123",
      "date_created": "2023-10-26T18:38:20Z",
      "date_last_updated": null
    },
  ],
  pagination": {
    "page": 1,
    "per_page": 50,
    "total_pages": 1,
    "total_results": 4
  }
}

Domains : DNS templates : records

Omschrijving

Endpoint

URL parameters

Antwoord

Voorbeelden

API Documentatie