Domains : Details

Aangemaakt : 01-11-2023
Laatste update: 20-12-2023

Omschrijving

Haal alle informatie op van een domeinnaam uit het account

Endpoint

GET https://api.nextname.nl/v2/domains/domain

Parameters

Bij dit commando worden geen extra parameters opgegeven

Antwoord

HTTP status code: 200 Ok

Parameter	Type	Omschrijving
domain_name	String	Domeinnaam
sld	String	SLD van de domeinnaam (second level domain)
tld	String	TLD van de domeinnaam (top level domain)
status	Array	Status van de domeinnaam: Bekijk voor meer informatie over de mogelijke domein statussen de pagina: Domein statussen
date_expiry	String	Datum en tijdstip waarop de domeinnaam verloopt in RFC 3339 formaat
auto_renewal	Boolean	Automatisch verlengen van de domeinnaam
auto_renewal_period	Integer	De periode in maanden waarmee de domeinnaam verlengd zal worden
date_renewal	Datetime	Datum en tijdstip waarop de domeinnaam wordt verlengd in RFC 3339 formaat
auth_code	String	Auth-code van de domeinnaam
auth_code_date_expiry	Datetime	Verloopdatum van de auth_code, NULL als de auth_code niet verloopt
date_created	Datetime	Datum en tijdstip waarop de domeinnaam aan het account werd toegevoegd UTC tijdzone in RFC 3339
date_deleted	Datetime	Datum en tijdstip waarop de domeinnaam aan het opgeheven, alleen bij status 'quarantaine' UTC tijdzone in RFC 3339
transfer_lock	Boolean	Of de domeinnaam is voorzien van een transfer lock, een domeinnaam voorzien van een transfer lock kan niet verhuisd worden. NULL als de extensie geen transfer locks ondersteunt.
registant_handle	String	Contact handle van de registrant
contacts	Object	Object met de contacten van de domeinnaam bestaande uit: type: Het type van het contact: admin, tech of billing handle: De handle van het contact
premium_domain	Boolean	Of de domeinnaam een premium domeinnaam is
premium_price	Object	Object met de informatie over de premium prijs: currency: De munteenheid van de prijs (string) price: De prijs van de domeinnaam (float)
custom_price_domain	Boolean	Of de domeinnaam een afwijkende prijs heeft t.o.v. de normale prijs
custom_price	Object	Object met de informatie over de afwijkende prijs: currency: De munteenheid van de prijs (string) price: De prijs van de domeinnaam (float)
dns_hosted	Boolean	Of de domeinnaam gebruik maakt van de nameservers van NextName of zelf gespecificeerde nameservers
dns_hosted_template	String	Naam van de DNS-template, alleen zichtbaar als dns_hosted=true, NULL wanneer er geen DNS-template is gekoppeld
nsgroup	String	De naam van de nameserver group die is opgegeven, alleen zichtbaar als dns_hosted = true
dnssec	String	Of de domeinnaam is ondertekend met DNSSEC: signed: Als de domeinnaam is voorzien van DNSSEC unsigned: Als de domeinnaam niet is voorzien van DNSSEC
dnssec_keys	Array	Array met objecten met de DNSSEC keys: flags: integer: 256 voor ZSK of 257 voor KSK protocol: integer: altijd 3 algorithm: integer: het nummer van het gebruikte algoritme public_key: string: de public key Alleen zichtbaar wanneer dnssec = "signed" en dns_hosted = false
services	Array	Extra diensten die actief zijn voor de domeinnaam. Mogelijke waarden: trustee: Trustee contact voor de domeinnaam idprotect: ID protect

Voorbeeld

Beschrijving:
Haal de details van een domeinnaam op

PHP
cURL

Opdracht in PHP:

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

Antwoord:

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

{
  "domain_name": "testdomeinnaam.be",
  "sld": "testdomeinnaam",
  "tld": "be",
  "status": [
    "registered"
  ],
  "date_expiry": "2025-02-11T00:00:00+01:00",
  "auto_renewal": true,
  "auto_renewal_period": 12,
  "date_renewal": "2025-02-11T00:00:00+01:00",
  "date_deleted": null,
  "auth_code": null,
  "auth_code_date_expiry": null,
  "idn_language": null,
  "date_created": "2022-02-11T13:38:12+01:00",
  "transfer_lock": null,
  "registrant_handle": "CONTACT-HANDLE-1",
  "contacts": [
    {
      "type": "tech",
      "handle": "CONTACT-HANDLE-2"
    }
  ],
  "dns_hosted": false,
  "nsgroup": "myNS-Hosting",
  "dnssec": "signed",
  "dnssec_keys": [
    {
      "flags": 257,
      "protocol": 3,
      "algorithm": 8,
      "public_key": "AwEAAcRh4kHAQzj3mVEhQXs8XNiLu\/D4R+jx6y1ZQuEqSYEebgnypt1m KZwtCrdmcHSULs0BqoIeKZOszfhx22NiQOC7r\/rdpW7K0GHfhkabdvSz K+el6u5JHPw9FMVtRidexo4qSLVrhRiF3xRKwyagw3eOZc+NJYdbbFnC 7WTaa1Ncl5attAVqA9+Yt6thzmY0ifUSketjtob61MZ9OLdF6au1jfxE BlqXlnr2NBL5gJaSxH5fer0xXE8x+Q0\/DIF1L3HHmxrnVpCi55wTPAeP N2Ngor5nS4eR9jW3LhttyJehw8Ld63Lx+0QpAgy+QacplvkgHJZhZlKV bB6ReCY8ASHZbpISZtiUzBByu2nHRowysp7HGkiMs1bAJKH0NpaXiAMq WcwjjFAh6tXwWWO74VgazrB7Z0BxT1dfbYNnP9QeCjDe5FvJptdxm8nC 2rGV9+zrWVPhUWL345RtTptWWXN6gGgpB\/U2QxGWri1tU1XkB2TwyfdE fxayEVt+vAldtZFvmxrci1tssuzzawef6Y7CL1ziZZrXdLhO4maiLWQo Tqk6q6QHVbdSA38CBk0opsBjjYJHxVo2KCCuJDTHygIJMYpk+W92xhpY oVBtLJ74B+LDoxmPgutFN97MVP\/WRPFHZK3ZI4IGFYQHbA9H3QqBbuaW RVvkaovpnPXBtRVJ"
    },
    {
      "flags": 257,
      "protocol": 3,
      "algorithm": 8,  
      "public_key": "AwEAAci1QujH\/FAwbbwdjfMAZfLkdhjdiJ04JuBAntOAQW0o3KwgeF1K PXpXi5fy0Xsf7Xn2NQhwmBiOmcdnW2im\/JGGKA5svwuhushgXf7n79cC \/iqPqm66IlUrQuMGR66pio6sPFs2u4\/n8W39Shhr8KtiZlCZvOAzaIdv eXEE\/Gmt8okaKB+uF6xyku+h0pXA3Ac\/IaEMepwtvuv9NgQ\/lAEVW8r6 \/rQazMHuDlrzzTZlo7bgC56UD3o9gFhjVLmYC6edcTvrilbu89x+7bmN fOYaVprd9c8ef2RPclOxpZd4naRQ5np2ClfDYZnZTZGGnruJih93duX4 1gGtgf6u6z7h0cKgTSd3pGDLFnxcOgoGYJKoVJ4fSICNrGZRcuISYnoD TnvDpF5WM02mTEmsERX\/JYONKLGLz4ElhlJEDUqzt+mylWcXVnM1jvzi \/mVEtEfXw9m\/Q6XDEYshkbxxLGQo3HtJRE3v2B05B5FOheWE8a8trB67 jPI8NmD9WMyNLdZTJTW20m3S9Vo4p2Xwgg8IUrKyBN9L7mIhSgqz7t7K 36vvCmiJU1FEqFFarT86rEMqv7aDhuNEoc\/JxrIelgxrZtMPsuXaxWEg K3tPxF6ukOkh8knz2n5zVtFGGI1YahsXzHY7kNPhxTDcOOv0bEOol6lE g8rjSrv1SKJh9gX9"
    }
  ],
  "premium_domain": false,
  "custom_price_domain": false,
  "tags": ["customerdomain"],
  "services": []
}