Netim Direct
Updated on 9 October 2023

Create new host

Description

POST https://rest.netim.com/1.0/host/

Create a new host at the registry.

Headers

  • Authorization string
    The Autorization header must start with “Bearer ” followed by the session ID. Example:”Autorization: Bearer b0f13a3c01d9cce2a9a44cd729f81c26″
  • Content-type string
    Content type of the request Only “application/json” is accepted

Body

REQUIRED
  • host string (255)
    Hostname (example : “ns1.example.com”).
OPTIONAL
  • ipv4 array
    IPv4 Addresses.
  • ipv6 array
    IPv6 Addresses.

JSON example

{
        "host":"ns1.example.com",
        "ipv4":[
                "192.168.1.0",
         ],
        "ipv6":[
                "::1",
         ],
}
  • At least one IP must be provided (IPv4 or IPv6).
  • To function properly, the host must be declared in the DNS settings of the domain with all corresponding A records (for IPv4) and AAAA records (for IPv6)
  • The management of hosts is not supported by all extensions.

Common language  examples

<?php
 
	$ch = curl_init();
 
	$body = array(
		"host" => "ns1.example.com",
        "ipv4" => array("192.168.1.0"),
		"ipv6" => array("::1"),
	);
 
	curl_setopt($ch, CURLOPT_URL,"https://rest.netim.com/1.0/host/");
	curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
	curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'POST');
	curl_setopt($ch, CURLOPT_HTTPHEADER, ["Authorization: Bearer $sessionID", "Content-type: application/json"]);
	curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_ANY);
	curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($body));
 
	$result = json_decode(curl_exec ($ch), true);
	$status_code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
	curl_close ($ch);
import java.util.Base64;
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
 
public class Example {
 
	public static void main(String args[]) throws Exception {
		String sessionID = "12345678";
		String body = "{\"host\":\"ns1.example.com\",\"ipv4\":[\"192.168.1.0\", ],\"ipv6\":[\"::1\", ],}";
 
		HttpClient client = HttpClient.newHttpClient();
		HttpRequest request = HttpRequest.newBuilder()
			.uri(URI.create("https://rest.netim.com/1.0/host/"))
			.method("POST", HttpRequest.BodyPublishers.ofString(body))
			.header("Content-Type", "application/json")
			.header("Accept-Language", "EN")
			.header("Authorization", "Bearer " + sessionID)
			.build();
		HttpResponse response = client.send(request, HttpResponse.BodyHandlers.ofString());
 
		String result = response.body().toString();
    }
}
#!/usr/bin/python3
 
import json
import requests
 
url = 'https://rest.netim.com/1.0/host/'
 
sessionId = "1234567"
 
headers = {"Authorization": "Bearer " + sessionId, "Content-Type": "application/json"}
 
data = {
    "host": "ns1.example.com",
    "ipv4": ["192.168.1.0",],
    "ipv6": ["::1",],
}
 
response = requests.post(url, headers=headers, data=json.dumps(data))
curl -X POST https://rest.netim.com/1.0/host/ \
-H 'Authorization: Bearer b0f13a3c01d9cce2a9a44cd729f81c26=' \
-H 'Content-type: application/json' \
-d '{"host":"ns1.example.com","ipv4":["192.168.1.0", ],"ipv6":["::1", ],}'