TLDs : list
Omschrijving
Haal lijst op met alle TLDs
Endpoint
GET https://api.nextname.nl/v2/tlds/info
URL parameters
Bekijk voor meer informatie over de mogelijke zoekwaarden en de pagina: Zoekopdrachten
| Parameter | Datatype | Omschrijving |
|---|---|---|
| tld | Array | Zoekwaarde voor de TLD van de domeinnaam |
| category | String | Zoekwaarde voor de category van de TLD ccTLD = country code TLD (nl, be, de etc), gTLD = generieke TLD (.com, .net, .org etc) |
| continent | Array | Zoekwaarde voor het continent van de TLD Mogelijke waarden: EU = Europa, OC = Oceanië, NA = Noord Amerika, AS = Azië, AN = Antarctica, AF = Afrika, SA = Zuid Amerika |
| country_code | Array | Zoekwaarde voor land van de TLD, 2-Letterige landcode volgens ISO_3166-1 |
| syntax_length_min | Integer | Zoekwaarde voor land van de minimale toegestande lengte van de SLDs voor de TLD |
| syntax_length_max | Integer | Zoekwaarde voor land van de maximale toegestande lengte van de SLDs voor de TLD |
| syntax_idn_supported | Boolean | Zoekwaarde voor IDN ondersteuning van de TLD |
| registry_name | String | Zoekwaarde voor de registry van de TLD |
| registry_backend_operator_name | String | Zoekwaarde voor de registry_backend_operator_name van de TLD |
| registrant_organization_allowed | Boolean | Zoekwaarde voor of een organisatie als registrant is toegestaan |
| registrant_organization_required | Boolean | Zoekwaarde voor of een organisatie als registrant verplicht is |
| contacts_admin_min | Integer | Zoekwaarde voor minimale aantal admin contacts |
| contacts_admin_max | Integer | Zoekwaarde voor maximale aantal admin contacts |
| contacts_admin_organization_allowed | Boolean | Zoekwaarde voor of een bedijf is toegestaan als admin contact |
| contacts_admin_organization_required | Boolean | Zoekwaarde voor of een bedijf verplicht is als admin contact |
| contacts_tech_min | Integer | Zoekwaarde voor minimale aantal technisch contacts |
| contacts_tech_max | Integer | Zoekwaarde voor maximale aantal technisch contacts |
| contacts_tech_organization_allowed | Boolean | Zoekwaarde voor of een bedijf is toegestaan als technisch contact |
| contacts_tech_organization_required | Boolean | Zoekwaarde voor of een bedijf verplicht is als technisch contact |
| contacts_billing_min | Integer | Zoekwaarde voor minimale aantal billing contacts |
| contacts_billing_max | Integer | Zoekwaarde voor maximale aantal billing contacts |
| contacts_billing_organization_allowed | Boolean | Zoekwaarde voor of een bedijf is toegestaan als billing contact |
| contacts_billing_organization_required | Boolean | Zoekwaarde voor of een bedijf verplicht is als billing contact |
| nameservers_min | Integer | Zoekwaarde voor minimale aantal nameservers |
| nameservers_max | Integer | Zoekwaarde voor maximale aantal nameservers |
| nameservers_pre_delegation_check_required | Boolean | Zoekwaarde voor of pregeconfigureerdee nameservers vereist zijn |
| nameservers_hosts_ipv4_min | Integer | Zoekwaarde voor minimale aantal ipv4 nameservers |
| nameservers_hosts_ipv4_max | Integer | Zoekwaarde voor maximale aantal ipv4 nameservers |
| nameservers_hosts_ipv6_min | Integer | Zoekwaarde voor minimale aantal ipv6 nameservers |
| nameservers_hosts_ipv6_max | Integer | Zoekwaarde voor maximale aantal ipv6 nameservers |
| dnssec_supported | Boolean | Zoekwaarde voor of DNSSEC wordt ondersteund |
| dnssec_max_records | Integer | Zoekwaarde voor het maximale aantal DNSSEC records |
| dnssec_allowed_algorithms | Array | Zoekwaarde voor de beschikbare DNSSEC algoritmes |
| periods_create_months | Array | Zoekwaarde voor de beschikbare registratietermijnen |
| periods_renew_months | Array | Zoekwaarde voor de beschikbare verlengtermijnen |
| expiration_grace_days | Integer | Zoekwaarde voor de grace days na het verlopen van een domeinnaam |
| expiration_redemption_days | Integer | Zoekwaarde voor de redemption days (quaraintaine) na het verlopen van een domeinnaam |
| periods_auto_renew_renew_months | Array | Zoekwaarde voor de beschikbare auto-verlengtermijnen |
| auth_code_required_for_trade | Boolean | Zoekwaarde voor of de authcode verplicht is voor een houderwijziging |
| auth_code_retrievable | Boolean | Zoekwaarde voor of de authcode direct opvraagbaar is via het panel/API |
| auth_code_resettable | Boolean | Zoekwaarde voor of de authcode gereset kan worden |
| auth_code_custom_value_allowed | Boolean | Zoekwaarde voor of een zelfgekozen waarde mogelijk is voor de authcode |
| auth_code_sent_to_registrant_email | Boolean | Zoekwaarde voor of de registry de authcode direct naar de registrant verstuurt |
| auth_code_registrant_self_service | Boolean | Zoekwaarde voor of de registry een omgeving heeft waar de registrant zelf zijn authcode kan opvragen |
| auth_code_expires_after_seconds | Integer | Zoekwaarde voor wanneer de authcode verloopt |
| auth_code_format_length_min | Integer | Zoekwaarde voor minimale lengte authcode |
| auth_code_format_length_max | Integer | Zoekwaarde voor maximale lengte authcode |
| transfer_renewal_behavior | Array | Zoekwaarde voor verlenging na een verhuizing, mogelijke waarden: keep_experation = De verloopdatum wijzigt niet na de verhuizing (gratis verhuizing), reset_term = de verloopdatum wordt na de verhuizing gereset, extend_one_year = de domeinnaam wordt met 1 jaar verlengd na de verhuizing, extend_one_year_in_grace_period = de domeinnaam wordt met 1 jaar verlengd na de verhuizing tenzij de domeinnaam uit de auto renew grace periode komt |
| available actions_register | Boolean | Zoekwaarde voor of de TLD registraties ondersteunt |
| available actions_renew | Boolean | Zoekwaarde voor of de TLD verlengingen ondersteunt |
| available actions_transfer | Boolean | Zoekwaarde voor of de TLD verhuizingen ondersteunt |
| available actions_trade | Boolean | Zoekwaarde voor of de TLD houder wijzigingen ondersteunt |
| available actions_delete | Boolean | Zoekwaarde voor of de TLD handmatige opheffingen ondersteunt |
| available actions_restore | Boolean | Zoekwaarde voor of de TLD verlenging uit quarantaine ondersteunt |
| available actions_auto_renew | Boolean | Zoekwaarde voor of de TLD automatisch verlengen ondersteunt |
| available actions_update_contacts | Boolean | Zoekwaarde voor of de TLD updates van de contacten ondersteunt |
| available_actions_update_namservers | Boolean | Zoekwaarde voor of de TLD updates van de nameservers ondersteunt |
| features_premium_domains | Boolean | Zoekwaarde voor of TLD premium domains ondersteunt |
| features_transfer_lock | Boolean | Zoekwaarde voor of TLD transfer locks ondersteunt |
| services_trustee_available | Boolean | Zoekwaarde voor of er een trustee contact beschikbaar is |
| services_registry_lock | Boolean | Zoekwaarde voor of er een registry lock beschikbaar is |
| date_last_updated | Datetime | Zoekwaarde voor datum laatste wijziging aan de TLD informatie, formaat: YYYY-MM-DDThh:mm:ssZ in UTC tijdzone in RFC 3339 |
Antwoord
HTTP status code: 200 Ok
| Parameter | Type | Omschrijving |
|---|---|---|
| Object: meta | ||
| total_results | Integer | Totaal aangevonden TLD's |
| Array: data[] met object: | ||
| domain_name | String | Domeinnaam |
| 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_renew | Boolean | Automatisch verlengen van de domeinnaam |
| auto_renew_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) |
| 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, NULL als de nameservers van NextName worden gebruikt |
| 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 |
| 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 domeinnamen op
Opdracht in PHP:
<?php
$env = "live"; // live or test
$api_key = "XXXXXXXX-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
$api_url = "/v2/domains";
$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
Antwoord:
HTTP/1.1 200 OK Content-Type: application/json;charset=utf-8
{
"data": [
{
"domain_name": "somedomainname.nl",
"sld": "somedomainname",
"tld": "nl",
"status": [
"registered"
],
"date_expiry": "2024-10-14T00:00:00+02:00",
"auto_renewal": true,
"auto_renewal_period": 12,
"date_renewal": "2024-10-14T00:00:00+02:00",
"date_deleted": null,
"auth_code": "rmu7J4G3PQ4Y",
"auth_code_date_expiry": null,
"idn_language": null,
"date_created": "2018-10-14T15:12:20+02:00",
"transfer_lock": null,
"registrant_handle": "CONTACTHANDLE-1",
"contacts": [
{
"type": "admin",
"handle": "CONTACTHANDLE-1"
},
{
"type": "tech",
"handle": "CONTACTHANDLE-2"
}
],
"premium_domain": false,
"custom_price_domain": false,
"dns_hosted": true,
"dns_hosted_template": null,
"dnssec": "signed",
"tags": ["customers"],
"services": []
},
{
"domain_name": "someotherdomainname.blog",
"sld": "someotherdomainname",
"tld": "blog",
"status": [
"registered"
],
"date_expiry": "2024-12-28T00:00:00+02:00",
"auto_renewal": true,
"auto_renewal_period": 12,
"date_renewal": "2024-12-28T00:00:00+02:00",
"date_deleted": null,
"auth_code": "%eyZMz%EB@2cpAOe",
"auth_code_date_expiry": null,
"idn_language": null,
"date_created": "2019-12-28T15:12:20+02:00",
"transfer_lock": true,
"registrant_handle": "CONTACTHANDLE-1",
"contacts": [
{
"type": "admin",
"handle": "CONTACTHANDLE-1"
},
{
"type": "tech",
"handle": "CONTACTHANDLE-2"
}
{
"type": "billing",
"handle": "CONTACTHANDLE-3"
}
],
"premium_domain": true,
"premium_price" {
"currency": "USD",
"price": 123.45
},
"custom_price_domain": false,
"dns_hosted": false,
"nsgroup": "myhostingDNS",
"dnssec": "signed",
"tags": [],
"services": []
},
{
"domain_name": "quarantainedomain.be",
"sld": "quarantainedomain",
"tld": "be,
"status": [
"quarantine"
],
"date_expiry": "2024-06-13T00:00:00+01:00",
"auto_renewal": true,
"auto_renewal_period": 12,
"date_renewal": "2024-06-13T00:00:00+01:00",
"date_deleted": "2024-06-12T23:55:55+01:00",
"auth_code": null,
"auth_code_date_expiry": null,
"idn_language": null,
"date_created": "2020-06-13T09:28:45+02:00",
"transfer_lock": true,
"registrant_handle": "CONTACTHANDLE-1",
"contacts": [
{
"type": "tech",
"handle": "CONTACTHANDLE-2"
}
],
"premium_domain": false,
"custom_price_domain": false,
"dns_hosted": false,
"nsgroup": "myhostingDNS",
"dnssec": "signed",
"tags": [],
"services": []
},
],
pagination": {
"page": 1,
"per_page": 50,
"total_pages": 1,
"total_results": 3
}
}
Beschrijving:
Haal een lijst met domeinnamen op die in quarantaine zijn
Opdracht in PHP:
<?php
$env = "live"; // live or test
$api_key = "XXXXXXXX-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
$api_url = "/v2/domains?status=quarantine";
$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?status=quarantine"
Antwoord:
HTTP/1.1 200 OK Content-Type: application/json;charset=utf-8
{
"data": [
{
"domain_name": "quarantainedomain.be",
"sld": "quarantainedomain",
"tld": "be,
"status": [
"quarantine"
],
"date_expiry": "2024-06-13T00:00:00+01:00",
"auto_renew": true,
"auto_renew_period": 12,
"date_renewal": "2024-06-13T00:00:00+01:00",
"date_deleted": "2024-06-12T23:55:55+01:00",
"auth_code": null,
"auth_code_date_expiry": null,
"idn_language": null,
"date_created": "2020-06-13T09:28:45+02:00",
"transfer_lock": true,
"registrant_handle": "CONTACTHANDLE-1",
"contacts": [
{
"type": "tech",
"handle": "CONTACTHANDLE-2"
}
],
"premium_domain": false,
"custom_price_domain": false,
"dns_hosted": false,
"nsgroup": "myhostingDNS",
"dnssec": "signed",
"tags": [],
"services": []
}
],
pagination": {
"page": 1,
"per_page": 50,
"total_pages": 1,
"total_results": 1
}
}
Beschrijving:
Haal alle premium domeinnamen op, gesorteerd op verlengdatum
Opdracht in PHP:
<?php
$env = "live"; // live or test
$api_key = "XXXXXXXX-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
$api_url = "/v2/domains?premium_domain=true&sort=date_renewal";
$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?premium_domain=true&sort=date_renewal"
Antwoord:
HTTP/1.1 200 OK Content-Type: application/json;charset=utf-8
{
"data": [
{
"domain_name": "someotherdomainname.blog",
"sld": "someotherdomainname",
"tld": "blog",
"status": [
"registered"
],
"date_expiry": "2024-12-28T00:00:00+02:00",
"auto_renew": true,
"auto_renew_period": 12,
"date_renewal": "2024-12-28T00:00:00+02:00",
"date_deleted": null,
"auth_code": "%eyZMz%EB@2cpAOe",
"auth_code_date_expiry": null,
"idn_language": null,
"date_created": "2019-12-28T15:12:20+02:00",
"transfer_lock": true,
"registrant_handle": "CONTACTHANDLE-1",
"contacts": [
{
"type": "admin",
"handle": "CONTACTHANDLE-1"
},
{
"type": "tech",
"handle": "CONTACTHANDLE-2"
}
{
"type": "billing",
"handle": "CONTACTHANDLE-3"
}
],
"premium_domain": true,
"premium_price" {
"currency": "USD",
"price": 123.45
},
"custom_price_domain": false,
"dns_hosted": false,
"nsgroup": "myhostingDNS",
"dnssec": "signed",
"tags": [],
"services": []
}
],
pagination": {
"page": 1,
"per_page": 50,
"total_pages": 1,
"total_results": 1
}
}