1. Kennisbank
  2. API
  3. TLDS : pricing

TLDs : Pricing

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

Omschrijving

Haal prijsinformatie op van domeinextensies uit het account: huidige prijzen, prijswijzigingen en promoties

Endpoint


URL Parameters

Parameter Datatype Omschrijving
tld Array Zoekwaarde voor de domeinextensie
pricing_changes Boolean Zoekwaarde voor extensies met aankomende prijswijzigingen
pricing_promos Boolean Zoekwaarde voor extensies met aankomende en actieve promoties

Antwoord

Parameter Type Omschrijving
Array: data[] met object:
tld String Domeinnaam
pricing_standard Array De prijzen van de extensie. De elementen van de array bestaan uit objecten:

periode: De periode in maanden waarop prijzen betrekking hebben (integer)
currency: De munteenheid van de tarieven (string)
register: De prijs voor een registratie (float)
transfer: De prijs voor een verhuizing (float)
renew: De prijs voor een verlenging (float)
trade: De prijs voor een houderwijziging (float)
restore: De prijs voor een verlenging van een verwijderde domeinnaam (float)
update: De prijs voor wijziging aan de domeinnaam (float)
pricing_changes Array Aankomende prijswijzigingen van de extensie. De elementen van de array bestaan uit objecten:

date_from: Datum waarop de prijswijziging actief wordt (UTC tijdzone in RFC 3339 )
currency: De munteenheid van de nieuwe prijzen (string)
register: De nieuwe prijs voor een registratie (float)
transfer: nieuwe prijs voor een verhuizing (float)
renew: De nieuwe prijs voor een verlenging (float)
trade: De nieuwe prijs voor een houderwijziging (float)
restore: De nieuwe prijs voor een verlenging van een verwijderde domeinnaam (float)
update: De nieuwe prijs voor wijziging aan de domeinnaam (float)
promo Array Aankomende promoties voor de extensie. De elementen van de array bestaan uit objecten:

date_start: Datum waarop de prijswijziging actief wordt (UTC tijdzone in RFC 3339 )
date_end: Datum waarop de prijswijziging actief wordt (UTC tijdzone in RFC 3339 )
types: De type acties waarvoor de promotie actief is: register, transfer (array) currency: De munteenheid van de promotieprijs (float)
price: De promotieprijs (float)

Voorbeelden


Beschrijving:
Vraag de tarieven op voor de .NL, .BE, .EU en .NET extensies

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

{
  "data": [
    {
      "tld": "be",
      "pricing_standard": [
        {
	  "period": 12,
	  "currency": "EUR",
	  "register": 7,
	  "transfer": 7,
	  "renew": 7,
	  "trade": 7,
	  "restore": 12,
	  "update": 0
	}
      ]
    },
    {
      "tld": "eu",
      "pricing_standard": [
        {
	  "period": 12,
	  "currency": "EUR",
	  "register": 8.50,
	  "transfer": 8.50,
	  "renew": 8.50,
	  "trade": 0,
	  "restore": 12,
	  "update": 0
	}
      ],
      "pricing_promos": [
        {
	  "name": "2024-EU",
	  "period": 12,
	  "types": [
	    "register"
	  ],
	  "date_start": "2024-01-04T00:00:00+01:00",
	  "date_end": "2024-12-31T00:00:00+01:00",
	  "currency": "EUR",
	  "price": 2
	}
      ]
    },
    {
      "tld": "nl",
      "pricing_standard": [
        {
	  "period": 12,
	  "currency": "EUR",
	  "register": 5.27,
	  "transfer": 0,
	  "renew": 5.27,
	  "trade": 0,
	  "restore": 15,
	  "update": 0
	}
      ]
    },
    {
      "tld": "net",
      "pricing_standard": [
        {
	  "period": 12,
	  "currency": "USD",
	  "register": 12.9,
	  "transfer": 12.9,
	  "renew": 12.9,
	  "trade": 0,
	  "restore": 95,
	  "update": 0
	}
      ],
      "pricing_changes": [
	{
	  "date_from": "2024-03-01T00:00:00Z",
	  "period": 12,
	  "currency": "USD",
	  "register": 14.79,
	  "renew": 14.79,
	  "transfer": 14.79,
	  "trade": 0,
          "restore": 95,
	  "update": 0
	}
      ]
    }
  ],
  "pagination": {
    "current_page": 1,
    "per_page": 50,
    "total_pages": 1,
    "total_results": 4
  }
}

Beschrijving:
Vraag alle extensies op met aankomende prijswijzigingen

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

{
  "data": [
    {
      "tld": "net",
      "pricing_standard": [
        {
	  "period": 12,
	  "currency": "USD",
	  "register": 12.9,
	  "transfer": 12.9,
	  "renew": 12.9,
	  "trade": 0,
	  "restore": 95,
	  "update": 0
	}
      ],
      "pricing_changes": [
	{
	  "date_from": "2024-03-01T00:00:00Z",
	  "period": 12,
	  "currency": "USD",
	  "register": 14.79,
	  "renew": 14.79,
	  "transfer": 14.79,
	  "trade": 0,
          "restore": 95,
	  "update": 0
	}
      ]
    }
  ],
  "pagination": {
    "current_page": 1,
    "per_page": 50,
    "total_pages": 1,
    "total_results": 1
  }
}

Beschrijving:
Vraag alle extensies op waarvoor een promotie actief is of binnenkort start

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

{
  "data": [
    {
      "tld": "eu",
      "pricing_standard": [
        {
	  "period": 12,
	  "currency": "EUR",
	  "register": 8.50,
	  "transfer": 8.50,
	  "renew": 8.50,
	  "trade": 0,
	  "restore": 12,
	  "update": 0
	}
      ],
      "pricing_promos": [
        {
	  "name": "2024-EU",
	  "period": 12,
	  "types": [
	    "register"
	  ],
	  "date_start": "2024-01-04T00:00:00+01:00",
	  "date_end": "2024-12-31T00:00:00+01:00",
	  "currency": "EUR",
	  "price": 2
	}
      ]
    }
  ],
  "pagination": {
    "current_page": 1,
    "per_page": 50,
    "total_pages": 1,
    "total_results": 1
  }
}

API Documentatie

Versie V2.2b, 05-07-2024