Contacts : Validate

Aangemaakt: 01-03-2023
Laatste update: 01-12-2023

Omschrijving

Sommige extensies vereisten een contactvalidatie. Hiervoor wordt een e-mail naar het contact verzonden. Dit gebeurt automatisch wanneer dit nodig is, bijvoorbeeld bij de registratie van een domeinnaam.

Via deze functie kun je handmatig vooraf een contactvalidatie starten.

Endpoint

POST https://api.nextname.nl/v2/contacts/handle/validate
Content-type: application/json

Parameters

Parameter	Datatype	Verplicht	Omschrijving
registries	Array	Ja	De registries waarvoor je een contactvalidatie wilt starten De volgende registries kunnen geselecteerd worden: IISSE, voor .SE IISNU, voor .NU Nominet, voor .CO.UK, ORG.UK, ME.UK en .UK DkHostmaster voor .DK General voor gTLD's

Antwoord

HTTP status code: 202 Accepted

Voorbeeld

Beschrijving:

Validatie aanvragen voor contact ABCD-0001 voor .SE (ISSE) en .UK (Nominet) domeinnamen

PHP
cURL

Opdracht in PHP:

<?php
$env      = "live"; // live or test
$api_key  = "XXXXXXXX-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
$api_url  = "/v2/contacts/ABCD-0001/validate";
$api_host = $env === "live" ? "https://api.nextname.nl" : "https://api-test.nextname.nl";

$a_data = [
            "registries" => ["IISSE","Nominet"]
	  ];

$json_data = json_encode($a_data);

$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, $json_data );
curl_setopt($ch, CURLOPT_HTTPHEADER, array("Authorization: Bearer $api_key","Content-Type: application/json"));
$output = curl_exec($ch);

if(curl_getinfo($ch, CURLINFO_HTTP_CODE) === 202) {
  echo "Contact validation successfully started";
}

curl_close($ch);

Opdracht in cURL:

curl -X POST -H "Content-Type: application/json" -H "Authorization: Bearer XXXXXXXX-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" \
-d '{"registries":["IISSE","Nominet"]}' \
https://api-test.nextname.nl/v2/contacts/ABCD-0001/validate

Antwoord:

HTTP/1.1 202 Accepted