Create dns record
curl --request POST \
--url https://dns-service.liara.ir/api/v1/zones/{zone}/dns-records \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "<string>",
"type": "<string>",
"ttl": 123,
"contents": [
{}
]
}
'import requests
url = "https://dns-service.liara.ir/api/v1/zones/{zone}/dns-records"
payload = {
"name": "<string>",
"type": "<string>",
"ttl": 123,
"contents": [{}]
}
headers = {
"Authorization": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({name: '<string>', type: '<string>', ttl: 123, contents: [{}]})
};
fetch('https://dns-service.liara.ir/api/v1/zones/{zone}/dns-records', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://dns-service.liara.ir/api/v1/zones/{zone}/dns-records",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'name' => '<string>',
'type' => '<string>',
'ttl' => 123,
'contents' => [
[
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: <api-key>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://dns-service.liara.ir/api/v1/zones/{zone}/dns-records"
payload := strings.NewReader("{\n \"name\": \"<string>\",\n \"type\": \"<string>\",\n \"ttl\": 123,\n \"contents\": [\n {}\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://dns-service.liara.ir/api/v1/zones/{zone}/dns-records")
.header("Authorization", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"<string>\",\n \"type\": \"<string>\",\n \"ttl\": 123,\n \"contents\": [\n {}\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://dns-service.liara.ir/api/v1/zones/{zone}/dns-records")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"name\": \"<string>\",\n \"type\": \"<string>\",\n \"ttl\": 123,\n \"contents\": [\n {}\n ]\n}"
response = http.request(request)
puts response.read_body{
"status": "<string>",
"data": {
"id": "<string>",
"name": "<string>",
"type": "<string>",
"ttl": 123,
"contents": [
{}
]
}
}This response has no body data.This response has no body data.This response has no body data.This response has no body data.Dns Record
Create dns record
Creates a new dns record, returns the dns record on creation
POST
/
api
/
v1
/
zones
/
{zone}
/
dns-records
Create dns record
curl --request POST \
--url https://dns-service.liara.ir/api/v1/zones/{zone}/dns-records \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "<string>",
"type": "<string>",
"ttl": 123,
"contents": [
{}
]
}
'import requests
url = "https://dns-service.liara.ir/api/v1/zones/{zone}/dns-records"
payload = {
"name": "<string>",
"type": "<string>",
"ttl": 123,
"contents": [{}]
}
headers = {
"Authorization": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({name: '<string>', type: '<string>', ttl: 123, contents: [{}]})
};
fetch('https://dns-service.liara.ir/api/v1/zones/{zone}/dns-records', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://dns-service.liara.ir/api/v1/zones/{zone}/dns-records",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'name' => '<string>',
'type' => '<string>',
'ttl' => 123,
'contents' => [
[
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: <api-key>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://dns-service.liara.ir/api/v1/zones/{zone}/dns-records"
payload := strings.NewReader("{\n \"name\": \"<string>\",\n \"type\": \"<string>\",\n \"ttl\": 123,\n \"contents\": [\n {}\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://dns-service.liara.ir/api/v1/zones/{zone}/dns-records")
.header("Authorization", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"<string>\",\n \"type\": \"<string>\",\n \"ttl\": 123,\n \"contents\": [\n {}\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://dns-service.liara.ir/api/v1/zones/{zone}/dns-records")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"name\": \"<string>\",\n \"type\": \"<string>\",\n \"ttl\": 123,\n \"contents\": [\n {}\n ]\n}"
response = http.request(request)
puts response.read_body{
"status": "<string>",
"data": {
"id": "<string>",
"name": "<string>",
"type": "<string>",
"ttl": 123,
"contents": [
{}
]
}
}This response has no body data.This response has no body data.This response has no body data.This response has no body data.Authorizations
Path Parameters
The name of the zone to create dns record
Body
application/json
The name of dns record, "@" for zone name(root level), "*" for wild card and any valid value with RFC 1123
The type of dns record, valid values: [A, AAAA, TXT, CNAME, ALIAS, MX, SRV, SPF, PTR]
The ttl of dns record, is not required, valid values: [120, 180, 300, 600, 900, 1800, 3600, 7200, 18000, 43200, 86400, 172800, 432000]
Array of content of dns record, change base on type of dns record
⌘I
