1. Kennisbank
  2. API
  3. Domains : DNS zone : records

Domains : DNS zone : records

  • Aangemaakt : 05-07-2024
  • Laatste update: -

Omschrijving

Haal lijst op met alle DNS records van een domeinnaam die de nameservers van MijnDomeinReseller gebruikt

Endpoint


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)
fqdn String Zoekwaarde van de fully qualified domain name
type Array Zoekwaarde voor het type record, mogelijke waarden:

A, CNAME, , TXT, MX, SRV, AAAA, NS, CAA, TLSA, URLF (URL Forward)*, URLF301 (URL Forward 301)*, URLC (URL Cloaking)*,

* URLFWD, URLFWD301 en URLCLO zijn geen officiële DNS records. Stel je deze records in dan worden 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

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
fqdn String De fully quantified domain name
type String Type van het DNS record, mogelijke waarden:

A, CNAME, , TXT, MX, SRV, AAAA, NS, CAA, TLSA, URLF (URL Forward), URLF301 (URL Forward 301), URLC (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 op van een domeinnaam

Opdracht in PHP: 
<?php
$env      = "live"; // live or test
$api_key  = "XXXXXXXX-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
$api_url  = "/v2/domains/testdomeinnaam.nl/dnszone/records";
$api_host = $env === "live" ? "https://api.mijndomeinreseller.nl" : "https://api-test.mijndomeinreseller.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.mijndomeinreseller.nl/v2/domains/testdomeinnaam.nl/dnszone/records
Antwoord: 
HTTP/1.1 200 OK
Content-Type: application/json;charset=utf-8            

{
  "data": [
    {
      "record_id": "a038dfdceec363ed",
      "name": "www",
      "fqdn": "www.testdomeinnaam.nl",
      "type": "A",
      "content": "123.123.123.123",
      "date_created": "2023-10-26T18:38:20Z",
      "date_last_updated": null
    },    
    {
      "record_id": "35acff33afefb5bc",
      "name": "@",
      "fqdn": "testdomeinnaam.nl",
      "type": "A",
      "content": "123.123.123.123",
      "date_created": "2023-10-28T18:38:20Z",
      "date_last_updated": null
    },    
    {
      "record_id": "ff66879aaff3ed35",
      "name": "@",
      "fqdn": "testdomeinnaam.nl",
      "type": "AAAA",
      "content": "2001:1AF8:4700:A104:11::0000",
      "date_created": "2023-10-26T18:38:21Z",
      "date_last_updated": null
    },  
    {
      "record_id": "dc498ecfe0d33eef",
      "name": "@",
      "fqdn": "testdomeinnaam.nl",
      "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 domeinnaam

Opdracht in PHP: 
<?php
$env      = "live"; // live or test
$api_key  = "XXXXXXXX-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
$api_url  = "/v2/domains/testdomeinnaam.nl/dnszone/records?type=MX";
$api_host = $env === "live" ? "https://api.mijndomeinreseller.nl" : "https://api-test.mijndomeinreseller.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.mijndomeinreseller.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": "@",
      "fqdn": "testdomeinnaam.nl",
      "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 creatie-datum

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.mijndomeinreseller.nl" : "https://api-test.mijndomeinreseller.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.mijndomeinreseller.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": "@",
      "fqdn": "testdomeinnaam.nl",
      "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": "@",
      "fqdn": "testdomeinnaam.nl",
      "type": "AAAA",
      "content": "2001:1AF8:4700:A104:11::0000",
      "date_created": "2023-10-26T18:38:21Z",
      "date_last_updated": null
    },  
    {
      "record_id": "35acff33afefb5bc",
      "name": "@",
      "fqdn": "testdomeinnaam.nl",
      "type": "A",
      "content": "123.123.123.123",
      "date_created": "2023-10-28T18:38:20Z",
      "date_last_updated": null
    },      
    {
      "record_id": "a038dfdceec363ed",
      "name": "www",
      "fqdn": "www.testdomeinnaam.nl",
      "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
  }
}

API Documentatie

Versie V2.2b, 05-07-2024