Netim Direct
Updated on 25 February 2025

Check DNS zone

1 Description
2 Common language examples

Description

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

Investigates the state of the domain name from the top to the bottom of the DNS tree.

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

  • nameservers array (0-5)
    Nameserver list

JSON example

{
    "nameservers": [
        {
            "name": "ns1.netim.net",
            "IPv4": "198.50.216.33"
        },
        {
            "name": "ns1.netim.net"
        }
    ]
}
  • 200OK

    The request is processed and the result is returned in the body.

    Body

    arrayapplication/json


    An array containing the check informations.


    • result bool
      Check result
    • data array
      Check data

    data

    arrayAn array of structures, each with the following keys :

    • module string
      Test module
    • level string
      Severity
    • message string
      Error message

  • 4XX

    Learn more about the possible error codes

 

  • The minimal number of nameservers must match the requirements of the extension.
  • A DNS test may be performed prior the registration. See structdomaintldinfo.HasZonecheck

Common language  examples

$ch = curl_init();

$body = array(
    'nameservers' => array(
        ['name' => 'ns1.netim.net', 'IPv4' => '198.50.216.33'],
        ['name' => 'ns2.netim.net'],
    ),
);

curl_setopt($ch, CURLOPT_URL, "https://rest.netim.com/3.0/domain/$domain/zone/check/");
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 = "netim.com";
        String body = "{\"nameservers\":[{\"name\":\"ns1.netim.net\",\"IPv4\":\"198.50.216.33\"},{\"name\":\"ns1.netim.net\"}]}";

        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://rest.netim.com/3.0/domain/" + domain + "/zone/check/"))
            .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 = 'netim.com'
url = 'https://rest.netim.com/3.0/domain/' + domain + '/zone/check/'
sessionId = "123456789"

data = {
    "nameservers": [
        {
            "name": "ns1.netim.net",
            "IPv4": "198.50.216.33"
        },
        {
            "name": "ns2.netim.net"
        }
    ]
}

headers = {"Authorization": "Bearer " + sessionId, "Content-Type": "application/json"}
response = requests.post(url, headers=headers, data=json.dumps(data))
curl -X POST https://rest.netim.com/3.0/domain/netim.com/zone/check/ \
-H 'Authorization: Bearer 123465789' \
-H 'content-type: application/json' \
-d '{"nameservers":[{"name":"ns1.netim.net","IPv4":"198.50.216.33"},{"name":"ns1.netim.net"}]}'