Netim Direct
Updated on 11 February 2025

Create DS records

1 Description
2 Common language examples

Description

POST https://rest.netim.com/3.0/domain/{domain}/ds-record/

Add DS records to a domain if it does not use NETIM’s DNS servers.

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

  • data array
    An array of dsData or keyData.

JSON example

{
    "data": [
        {
            "key": 27911,
            "type": 2,
            "algo": 8,
            "digest": "b0b3f3739cf5eb01598df7bb211a3d65096c13a6b7eff712df6ed23aa66856a9"
        },
        {
            "key": 53225,
            "type": 2,
            "algo": 8,
            "digest": "50989f9b53dae54f79f2f2a6f739933a3c4df003f10e62641fe1f3eec4b7f0f7"
        }
    ]
}
{
    "data": [
        {
            "flags": 257,
            "protocol": 3,
            "algo": 8,
            "pubKey": "AwEAAbC1gM5040jSh0/WRvdM1hgOFCBHmVix{...}"
        },
        {
            "flags": 257,
            "protocol": 3,
            "algo": 8,
            "pubKey": "AwEAAZgAbjFqpTVtXZ+35PAt7bXmpX3a7DU2F{...}"
        }
    ]
}

Common language  examples

$domain = 'example.com';
$body = [
    'data' => [
        [
            'flags' => 257,
            'protocol' => 3,
            'algo' => 8,
            'pubKey' => 'AwEAAbC1gM5040jSh0/WRvdM1hgOFCBHmVix{...}',
        ],
        [
            'flags' => 257,
            'protocol' => 3,
            'algo' => 8,
            'pubKey' => 'AwEAAZgAbjFqpTVtXZ+35PAt7bXmpX3a7DU2F{...}',
        ]
    ]
];

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://rest.netim.com/3.0/domain/$domain/ds-record/");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'POST');
curl_setopt($ch, CURLOPT_HTTPHEADER, array(
    'Authorization: Bearer ' . $sessionID,
    'Content-Type: application/json'
));
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_ANY);

$result = json_decode(curl_exec($ch), true);
$status_code = curl_getinfo($ch, CURLINFO_HTTP_CODE);

curl_close($ch);
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 = "123456";
        String domain = "example.com";

        String body = "{\"data\":[{\"key\":27911,\"type\":2,\"algo\":8,\"digest\":\"b0b3f3739cf5eb01598df7bb211a3d65096c13a6b7eff712df6ed23aa66856a9\"},{\"key\":53225,\"type\":2,\"algo\":8,\"digest\":\"50989f9b53dae54f79f2f2a6f739933a3c4df003f10e62641fe1f3eec4b7f0f7\"}]}";

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

sessionId = "123465"

data = {
    "data": [
        {
            "key": 27911,
            "type": 2,
            "algo": 8,
            "digest": "b0b3f3739cf5eb01598df7bb211a3d65096c13a6b7eff712df6ed23aa66856a9",
        },
        {
            "key": 53225,
            "type": 2,
            "algo": 8,
            "digest": "50989f9b53dae54f79f2f2a6f739933a3c4df003f10e62641fe1f3eec4b7f0f7",
        },
    ]
}

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/example.fr/ds-record/ \
-H 'Autorization: Bearer b0f13a3c01d9cce2a9a44cd729f81c26=' \
-H 'content-type: application/json' \
-d '{"data":[{"key":27911,"type":2,"algo":8,"digest":"b0b3f3739cf5eb01598df7bb211a3d65096c13a6b7eff712df6ed23aa66856a9"},{"key":53225,"type":2,"algo":8,"digest":"50989f9b53dae54f79f2f2a6f739933a3c4df003f10e62641fe1f3eec4b7f0f7"}]}'