Netim Direct
Updated on 11 December 2024

Create dns zone

1 Description
2 Common language examples

Description

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

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 / TLSA).

  • value string (150)
    Value of the new DNS record.

OPTIONAL

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

JSON example

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

Common language examples

$ch = curl_init();

$domain = "example.com";
$body = array(
    "subdomain" => "www",
    "type" => "A",
    "value" => "127.0.0.1",
    "options" => array(
        "service" => null,
        "protocol" => null,
        "ttl" => 365,
        "ttlUnit" => "S",
        "priority" => null,
        "weight" => null,
        "port" => null,
    ),
);

curl_setopt($ch, CURLOPT_URL, "https://rest.netim.com/3.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\":\"192.168.0.1\",\"options\":{\"service\":null,\"protocol\":null,\"ttl\":365,\"ttlUnit\":\"S\",\"priority\":null,\"weight\":null,\"port\":null}}";

        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder().uri(URI.create("https://rest.netim.com/3.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

sessionId = "1234567"

domain = "example.com"
data = {
    "subdomain": "www",
    "type": "A",
    "value": "192.168.0.1",
    "options": {
        "service": "",
        "protocol": "",
        "ttl": 365,
        "ttlUnit": "S",
        "priority": "",
        "weight": "",
        "port": "",
    },
}

headers = {"Authorization": "Bearer " + sessionId, "Content-Type": "application/json"}

response = requests.post(
    "https://rest.netim.com/3.0/domain/" + domain + "/zone/",
    headers=headers,
    data=json.dumps(data),
)
curl -X POST https://rest.netim.com/3.0/domain/example.com/zone/ \
-H 'Authorization: Bearer abcdef123465798' \
-H 'Content-type: application/json' \
-d '{"subdomain":"www","type":"A","value":"127.0.0.1","options":{"service":null,"protocol":null,"ttl":365,"ttlUnit":"S","priority":null,"weight":null,"port":null}}'