Domains : tags

Aangemaakt: 20-12-2023

Omschrijving

Wijzig de tags van een domeinnaam. Je kunt tags bij een domeinnaam opgeven als eigen referentie

Endpoint

PUT https://api.nextname.nl/v2/domains/domain/tags

Parameters

Parameter	Datatype	Verplicht	Omschrijving
tags	array	Ja	array met tags, elke tag heeft de volgende vereisten: • Lengte min: 1 karakter • Lengte max: 20 karakters • Toegestane karakters: Letters, cijfers en - • Regexp: ^[a-zA-Z0-9\-]{1,20}$

Antwoord

HTTP status code: 204 No Content

Voorbeeld

Beschrijving:

Wijzig de tags van een domeinnaam

PHP
cURL

Opdracht in PHP:

<?php
$env      = "live"; // live or test
$api_key  = "XXXXXXXX-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
$api_url  = "/v2/domains/testdomeinnaam.nl/tags";
$api_host = $env === "live" ? "https://api.nextname.nl" : "https://api-test.nextname.nl";

$a_data = ["tags" => ["customerno-12345","server-x"];

$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_CUSTOMREQUEST, "PUT");
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) === 204) {
  echo "Tags successfully updated";
}

curl_close($ch);

Opdracht in cURL:

curl -X PUT -H "Content-Type: application/json" -H "Authorization: Bearer XXXXXXXX-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" \
-d '{"tags":["customer-12345","server-x"]}' \
https://api-test.nextname.nl/v2/domains/testdomeinnaam.nl/tags

Antwoord:

HTTP/1.1 204 No Content