Create new 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", ], }
-
200OK
The request is processed and the result is returned in the body. -
4XX
- 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.
<?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", ],}'
Need an API Client?
Speed up your integration by using our API client for SOAP