Create dns zone

Description

POST https://rest.netim.com/1.0/domain/{domain}/zone/

Create a DNS record into the domain zonefile.

URL Parameters

  • {domain}
    Domain name.

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


  • subdomain
    string
    (255)
    Sub domain.
  • type
    string
    Type of DNS record (A / AAAA / MX / CNAME / TXT / NS / SRV).
  • value
    string
    (150)
    Value of the new DNS record.

OPTIONAL


  • options
    object
    (StructZoneParam)
    Custom settings of the new record as StructOptionsZone object.

JSON example

{
	"subdomain":"www",
	"type":"A",
	"value":"127.0.0.1",
	"options":{
		"service":null,
		"protocol":null,
		"ttl":365,
		"priority":null,
		"weight":null,
		"port":null,
	},
}

Common language examples

<?php
 
	$ch = curl_init();
 
	$body = array(
		"subdomain" => "www",
		"type" => "A",
		"value" => "127.0.0.1",
		"options" => array(
			"service" => null,
			"protocol" => null,
			"ttl" => 365,
			"priority" => null,
			"weight" => null,
			"port" => null,
		),
	);
 
	curl_setopt($ch, CURLOPT_URL,"https://api.netim.com/rest/1.0/domain/$domain/zone/");
	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 domain = "example.com";
 
		String body = "{"subdomain":"www","type":"A","value":"127.0.0.1","options":{"service":null,"protocol":null,"ttl":365,"priority":null,"weight":null,"port":null,},}";
 
		HttpClient client = HttpClient.newHttpClient();
		HttpRequest request = HttpRequest.newBuilder()
			.uri(URI.create("https://api.netim.com/rest/1.0/domain/" + domain + "/zone/"))
			.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
 
domain = 'example.com'
 
url = 'https://api.netim.com/rest/1.0/domain/' + domain + '/zone/'
 
sessionId = "1234567"
 
data = {
	"subdomain":"www",
	"type":"A",
	"value":"127.0.0.1",
	"options":{
		"service":None,
		"protocol":None,
		"ttl":365,
		"priority":None,
		"weight":None,
		"port":None,
	},
}
 
headers = {"Authorization": "Bearer " + sessionId, "Content-Type": "application/json"}
 
 
response = requests.post(url, headers=headers, data=json.dumps(data))
curl -X POST https://api.netim.com/rest/1.0/domain/example.com/zone/ 
-H 'Authorization: Bearer b0f13a3c01d9cce2a9a44cd729f81c26=' 
-H 'Content-type: application/json' 
-d '{"subdomain":"www","type":"A","value":"127.0.0.1","options":{"service":null,"protocol":null,"ttl":365,"priority":null,"weight":null,"port":null,},}'

Need an API Client?
Speed up your integration by using our API client for SOAP