Domains : auth_code

  • Aangemaakt : 01-11-2023
  • Laatste update: -

Omschrijving

Genereer een (nieuwe) auth code voor een domeinnaam of laat een auth code door de registry versturen naar de registrant, de actie is afhankelijk van de registry.

Endpoint


Parameters

geen

Antwoord

Het antwoord is afhankelijk van de uitgevoerde actie:

Indien de auth code is gegenereerd:
Parameter Type Omschrijving
auth_code String Auth-code van de domeinnaam
auth_code_date_expiry Datetime Verloopdatum in UTC tijdzone in RFC 3339 van de auth_code, alleen opgenomen als de auth_code verloopt
Indien de auth code door de registry naar de registrant is verzonden:

Voorbeelden


Beschrijving:
Genereer een auth code voor een .EU domeinnaam

Opdracht in PHP:
<?php
$env      = "live"; // live or test
$api_key  = "XXXXXXXX-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
$api_url  = "/v2/domains/testdomeinnaam.eu/auth_code";
$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_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, "");
curl_setopt($ch, CURLOPT_HTTPHEADER, array("Authorization: Bearer $api_key"));
$output = curl_exec($ch);

if(curl_getinfo($ch, CURLINFO_HTTP_CODE) === 201) {
  $data = json_decode($output);
  echo "Contact successfully created: " . $data->auth_code ."<br>";
  echo "Will expiry on: " . $data->auth_code_date_expiry;
}

curl_close($ch);
Opdracht in cURL:
curl -X POST -H "Authorization: Bearer XXXXXXXX-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" \
https://api-test.mijndomeinreseller.nl/v2/domains/testdomeinnaam.eu/auth_code
Antwoord:
HTTP/1.1 201 Created
Content-Type: application/json;charset=utf-8   
{
  "auth_code": "15U4-4MR4-QP48-457Y",
  "auth_code_date_expiry": "2023-08-27T13:00:00Z",
}

Beschrijving:
Verstuur de auth code van een .BE domeinnaam naar de registrant

Opdracht in PHP:
<?php
$env      = "live"; // live or test
$api_key  = "XXXXXXXX-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
$api_url  = "/v2/domains/testdomeinnaam.be/auth_code";
$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_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, "");
curl_setopt($ch, CURLOPT_HTTPHEADER, array("Authorization: Bearer $api_key"));
$output = curl_exec($ch);

if(curl_getinfo($ch, CURLINFO_HTTP_CODE) === 204) {
  echo "The auth code has been successfully sent to the registrant";
}

curl_close($ch);
Opdracht in cURL:
curl -X POST -H "Authorization: Bearer XXXXXXXX-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" \
https://api-test.mijndomeinreseller.nl/v2/domains/testdomeinnaam.be/auth_code
Antwoord:
HTTP/1.1 204 No Content

Beschrijving:
Reset een auth code voor een .COM domeinnaam

Opdracht in PHP:
<?php
$env      = "live"; // live or test
$api_key  = "XXXXXXXX-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
$api_url  = "/v2/domains/testdomeinnaam.com/auth_code";
$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_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, "");
curl_setopt($ch, CURLOPT_HTTPHEADER, array("Authorization: Bearer $api_key"));
$output = curl_exec($ch);

if(curl_getinfo($ch, CURLINFO_HTTP_CODE) === 201) {
  $data = json_decode($output);
  echo "Contact successfully created: " . $data->auth_code;
}

curl_close($ch);

Opdracht in cURL:
curl -X POST -H "Authorization: Bearer XXXXXXXX-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" \
https://api-test.mijndomeinreseller.nl/v2/domains/testdomeinnaam.com/auth_code
Antwoord:
HTTP/1.1 201 Created
Content-Type: application/json;charset=utf-8   
{
  "auth_code": "23)9W*(zHLBCEwg4",
}