Ten artykuł opisuje polecenia WAPI przeznaczone specjalnie dla usługi WEDOS DNS. Informacje o konfiguracji WAPI i rozwiązywaniu typowych problemów znajdziesz w artykule WAPI – podręcznik.
Ten artykuł zawiera informacje o następujących żądaniach:
- dns-domains-list – lista domen DNS na koncie użytkownika
- dns-domain-info – informacje o domenie
- dns-domain-add – dodanie domeny do DNS
- dns-domain-update – aktualizacja domeny w DNS
- dns-domain-delete – usunięcie domeny z DNS
- dns-domain-axfr-run – żądanie transferu AXFR z serwera nadrzędnego do naszego DNS
- dns-domain-axfr-tsig – aktualizacja lub sprawdzenie ustawień AXFR TSIG
- dns-domain-copy – dodanie domeny do DNS przez skopiowanie innej domeny
- dns-domain-commit – zapisanie zmian w DNS
- dns-rows-list – pobranie listy rekordów domeny
- dns-row-detail – pobranie szczegółów rekordu
- dns-row-add – dodanie rekordu
- dns-row-update – edycja rekordu
- dns-row-delete – usunięcie rekordu
dns-domains-list
Użyj żądania dns-domains-list , aby wyświetlić listę domen DNS użytkownika.
Parametry
- search – ciąg znaków wyszukiwany w nazwach domen – opcjonalny
- status – filtr według statusu (active, disabled) – opcjonalny
- type – filtr według typu domeny (primary, secondary) – opcjonalny
- page – numer strony (domyślnie: 1) – opcjonalny
- page_limit – liczba pozycji na stronę (domyślnie: 50) – opcjonalny
- orderby – sortowanie pozycji według created_date lub domain, uzupełnione o asc/desc – opcjonalne, zobacz szablon
Wartości zwrotne
- 1000 – OK
Dane odpowiedzi
Żądanie zwraca listę domen według tego szablonu:
- domain
- name – nazwa domeny
- status – status domeny w systemie
- type – typ (primary/secondary)
Szablony
Żądanie JSON:
{
"request": {
"user": "your@login.tld",
"auth": "authentication string",
"command": "dns-domains-list",
"clTRID": "your ID",
"data": {
"search": "search term in domain name",
"status": "active|disabled",
"type": "primary|secondary",
"page": "page number",
"page_limit": "number of entries per page",
"orderby":"domain|created_date asc|desc"
}
}
}
Odpowiedź JSON (OK):
{
"response": {
"code": 1000,
"result": "OK",
"timestamp": "UTF timestamp",
"clTRID": "your ID",
"svTRID": "server ID",
"command": "dns-domains-list",
"data": {
"domain": [
{
"name": "domain1 name in DNS",
"type": "type (primary|secondary)",
"status": "active|disabled"
}
],
"total": "łączna liczba pozycji",
"page": "numer strony",
"page_limit": "liczba pozycji na stronę"
}
}
}
dns-domain-info
Użyj żądania dns-domain-info , aby uzyskać podstawowe informacje o jednej lub kilku domenach w systemie WEDOS DNS (WDNS).
Parametry
- name – nazwa domeny, dla wielu domen użyj ciągu rozdzielonego przecinkami (zobacz szablon) – wymagane
Wartości zwrotne
- 1000= OK
- 2201 = nieobsługiwana TLD
- 2202 = nieprawidłowa nazwa domeny
- 3222 = nie udało się otworzyć domeny
- 3223 = błąd autoryzacji
- 3305 = domena jest zablokowana do edycji
- 3306 = domena została usunięta
Przy wielu domenach wartość zwrotna zawsze wynosi 1000. Ewentualne wartości błędów są podawane w danych domain , zgodnie z szablonem.
Dane zwrotne
Po pomyślnym wykonaniu żądanie zwraca szczegóły domeny w WDNS w węźle data/domain.
Szablony
Żądanie JSON z 2 domenami:
{
"request": {
"user": "your@login.tld",
"auth": "authentication string",
"command": "dns-domain-info",
"clTRID": "your ID",
"data": {
"name": "domain.name1, domain.name2"
}
}
}
Odpowiedź JSON (domain.name1 OK, domain.name2 błąd):
{
"response": {
"code": 1000,
"result": "OK",
"timestamp": "UTF timestamp",
"clTRID": "your ID",
"svTRID": "server ID",
"command": "dns-domain-info",
"data": {
"domain": [{
"name": "domain.name1",
"status": "",
"type": "",
"tlock": "",
"autocommit": "",
"axfr_enabled": "outgoing axfr enabled? (0/1)",
"axfr_ips": "allowed axfr IPs list",
"changed": "",
"changed_date": "",
"commit_date": "",
"reload_pending": "",
"reload_pending_date": "",
"reload_date": "",
"disabled_date": "",
"enabled_date": "",
"add_date": "",
"rname": "",
"serial": "",
"refresh": "",
"retry": "",
"expire": "",
"minimum": "",
"rr_cnt6": "",
"ns_out": "",
"ns1": ""
},
{
"name": "domain.name2",
"code": 3222,
"result": "Domain open failed"
}]
}
}
}
dns-domain-add
Użyj żądania dns-domain-add , aby dodać nową domenę do DNS.
Parametry
- name – nazwa domeny lub kilka nazw rozdzielonych przecinkami (wymagane)
- type – typ wpisu domeny (primary/secondary) – opcjonalny (domyślnie: primary)
- axfr_enabled – czy wychodzący axfr jest włączony? (0/1) – tylko domeny primary, opcjonalne (domyślnie: 0)
- axfr_ips – lista dozwolonych adresów ip dla axfr (tylko dla wpisu primary, kilka adresów podaj jako listę rozdzieloną spacjami; wymagane, jeśli axfr_enabled=1)
- primary_ip – adresy ip nadrzędnego serwera dns (wymagane, jeśli type=secondary)
- primary_tsig_enabled – czy TSIG jest włączony? (0/1) – tylko domeny secondary, opcjonalne
- primary_tsig_name – identyfikator TSIG – tylko domeny secondary, wymagany przy włączonym TSIG
- primary_tsig_alg – algorytm TSIG – tylko domeny secondary, wymagany przy włączonym TSIG
- primary_tsig_key – klucz TSIG – tylko domeny secondary, wymagany przy włączonym TSIG
- template_id – ID domeny typu szablon – tylko domena primary, opcjonalne
Wartości zwrotne
- 1000 = ok
- 2007 = przekroczono maksymalny rozmiar żądania
- 2100 = brak wymaganego parametru
- 2101 = nieprawidłowe parametry wejściowe
- 2201 = nieobsługiwana TLD
- 2202 = nieprawidłowa nazwa domeny
- 2301 = nieprawidłowy format type
- 2302 = brak parametru primary_ip
- 2303 = nieprawidłowy format primary_ip
- 2304 = nieprawidłowy format axfr_enabled
- 2305 = brak wymaganego parametru axfr_ips
- 2306 = nieprawidłowy format axfr_ips
- 2308 = nieprawidłowy format ns
- 2322 = osiągnięto limit domen w DNS na użytkownika
- 2323 = nie znaleziono szablonu
- 2324 = nie można utworzyć domeny primary z szablonu
- 2325 = niezdefiniowany szablon
- 2330 = Nieprawidłowe żądanie – domena WDNS – primary TSIG – nieprawidłowa konfiguracja
- 2331 = Nieprawidłowe żądanie – domena WDNS – primary TSIG – nieprawidłowy format nazwy
- 2332 = Nieprawidłowe żądanie – domena WDNS – primary TSIG – nieprawidłowy format algorytmu
- 2333 = Nieprawidłowe żądanie – domena WDNS – primary TSIG – nieprawidłowy format klucza
- 2340 = przekroczono maks. liczbę domen w jednej operacji
- 3302 = nie udało się dodać domeny do DNS
- 3303 = domena już istnieje w DNS
Dane zwrotne
Żądanie nie zwraca żadnych danych.
Szablony
Żądanie JSON – domena primary:
{
"request": {
"user": "your@login.tld",
"auth": "authentication string",
"command": "dns-domain-add",
"clTRID": "your ID",
"data": {
"name": "domain1.tld, domain2.tld",
"axfr_enabled": "0 or 1",
"axfr_ips": "allowed AXFR address(es)",
"template_id": "ID of domain records template"
}
}
}
Żądanie JSON – domena secondary:
{
"request": {
"user": "your@login.tld",
"auth": "authentication string",
"command": "dns-domain-add",
"clTRID": "your ID",
"data": {
"name": "domain1.tld, domain2.tld",
"type": "secondary",
"primary_ip": "primary IP address",
"primary_tsig_enabled": "0 or 1",
"primary_tsig_name": "tsig_identifier",
"primary_tsig_alg": "hmac-sha1, hmac-sha224, hmac-sha256, hmac-sha384, hmac-sha512 or hmac-md5",
"primary_tsig_key": "TSIG_key_value"
}
}
}
Odpowiedź JSON (OK):
{
"response": {
"code": 1000,
"result": "OK",
"timestamp": "UTF timestamp",
"clTRID": "your ID",
"svTRID": "server ID",
"command": "dns-domain-add"
}
}
Odpowiedź JSON dla wielu domen:
{
"response":{
"code":1000,
"result":"OK",
"timestamp": "UTF timestamp",
"clTRID": "your ID",
"svTRID": "server ID",
"command":"dns-domain-add",
"data": [
{
"code":1000,
"result":"OK",
"name":"domain1.tld",
"domain_id":"service ID"
},
{
"code":1000,
"result":"OK",
"name":"domain2.tld",
"domain_id":"service ID"
}
]
}
}
dns-domain-update
Użyj żądania dns-domain-update , aby edytować domenę w DNS.
Parametry
- name – nazwa domeny lub kilka nazw rozdzielonych przecinkami (wymagane)
- axfr_enabled – czy wychodzący axfr jest włączony? (0/1) – tylko domeny primary, opcjonalne (domyślnie: 0)
- axfr_ips – lista dozwolonych adresów ip dla axfr (tylko dla wpisu primary, wymagane, jeśli axfr_enabled=1)
- ip – adres ip dla wychodzącego axfr
- primary_ip – adresy ip nadrzędnego serwera dns (wymagane, jeśli type=secondary)
- primary_tsig_enabled – czy TSIG jest włączony? (0/1) – tylko domeny secondary, opcjonalne
- primary_tsig_name – identyfikator TSIG – tylko domeny secondary, wymagany przy włączonym TSIG
- primary_tsig_alg – algorytm TSIG – tylko domeny secondary, wymagany przy włączonym TSIG
- primary_tsig_key – klucz TSIG – tylko domeny secondary, wymagany przy włączonym TSIG
Wartości zwrotne
- 1000 = ok
- 2007 = przekroczono maksymalny rozmiar żądania
- 2100 = brak wymaganego parametru
- 2101 = nieprawidłowe parametry wejściowe
- 2201 = nieobsługiwana TLD
- 2202 = nieprawidłowa nazwa domeny
- 2302 = brak parametru primary_ip
- 2303 = nieprawidłowy format primary_ip
- 2304 = nieprawidłowy format axfr_enabled
- 2305 = brak wymaganego parametru axfr_ips
- 2306 = nieprawidłowy format axfr_ips
- 2308 = nieprawidłowy format ns
- 2322 = osiągnięto limit domen w DNS na użytkownika
- 2330 = Nieprawidłowe żądanie – domena WDNS – primary TSIG – nieprawidłowa konfiguracja
- 2331 = Nieprawidłowe żądanie – domena WDNS – primary TSIG – nieprawidłowy format nazwy
- 2332 = Nieprawidłowe żądanie – domena WDNS – primary TSIG – nieprawidłowy format algorytmu
- 2333 = Nieprawidłowe żądanie – domena WDNS – primary TSIG – nieprawidłowy format klucza
- 2340 = przekroczono maks. liczbę domen w jednej operacji
- 3302 = nie udało się dodać domeny do DNS
- 3303 = domena już istnieje w DNS
Dane zwrotne
Żądanie nie zwraca żadnych danych.
Szablony
Żądanie JSON:
{
"request": {
"user": "your@login.tld",
"auth": "authentication string",
"command": "dns-domain-update",
"clTRID": "your ID",
"data": {
"name": "domain1.tld, domain2.tld",
"axfr_enabled": "0 or 1",
"axfr_ips": "allowed AXFR IP address(es)",
"primary_ip": "primary IP adderess",
"primary_tsig_enabled": "0 or 1",
"primary_tsig_name": "tsig_identifier",
"primary_tsig_alg": "hmac-sha1, hmac-sha224, hmac-sha256, hmac-sha384, hmac-sha512 or hmac-md5",
"primary_tsig_key": "TSIG_key_value"
}
}
}
Odpowiedź JSON (OK):
{
"response": {
"code": 1000,
"result": "OK",
"timestamp": "UTF timestamp",
"clTRID": "your ID",
"svTRID": "server ID",
"command": "dns-domain-update"
}
}
Odpowiedź JSON dla wielu domen (OK):
{
"response":{
"code":1000,
"result":"OK",
"timestamp": "UTF timestamp",
"clTRID": "your ID",
"svTRID": "server ID",
"command":"dns-domain-update",
"data": [
{
"code":1000,
"result":"OK",
"name":"domain1.tld",
},
{
"code":1000,
"result":"OK",
"name":"domain2.tld",
}
]
}
}
dns-domain-delete
Użyj żądania dns-domain-delete , aby usunąć domenę z DNS wraz ze wszystkimi jej rekordami.
Parametry
- name – nazwa domeny lub kilka nazw rozdzielonych przecinkami (wymagane)
Wartości zwrotne
- 1000 = ok
- 2007 = przekroczono maksymalny rozmiar żądania
- 2340 = przekroczono maks. liczbę domen w jednej operacji
- 3222 = nie udało się otworzyć domeny
- 3223 = brak uprawnień
- 3301 = rekordu nie można usunąć
- 3305 = domena jest zablokowana do edycji
- 3306 = domena została usunięta
Dane zwrotne
Żądanie nie zwraca żadnych danych.
Szablony
Żądanie JSON:
{
"request": {
"user": "your@login.tld",
"auth": "authentication string",
"command": "dns-domain-delete",
"clTRID": "your ID",
"data": {
"name": "domain1.tld, domain2.tld"
}
}
}
Odpowiedź JSON (OK):
{
"response": {
"code": 1000,
"result": "OK",
"timestamp": "UTF timestamp",
"clTRID": "your ID",
"svTRID": "server ID",,
"command": "dns-domain-delete"
}
}
Odpowiedź JSON dla wielu domen (OK):
{
"response":{
"code":1000,
"result":"OK",
"timestamp": "UTF timestamp",
"clTRID": "your ID",
"svTRID": "server ID",
"command":"dns-domain-delete",
"data": [
{
"code":1000,
"result":"OK",
"name":"domain1.tld",
},
{
"code":1000,
"result":"OK",
"name":"domain2.tld",
}
]
}
}
dns-domain-axfr-run
Żądanie dns-domain-axfr-run aktualizuje rekordy DNS z nadrzędnego serwera autorytatywnego przez AXFR w możliwie najkrótszym czasie (w ciągu kilku minut). Służy do domen secondary, w których zawartość strefy pobieramy do naszego systemu z innego serwera.
Bez tego żądania AXFR korzysta z wartości REFRESH i RETRY w rekordzie SOA.
Parametry
- name – nazwa domeny – wymagana
Wartości zwrotne
- 1000 = ok
- 2201 = nieobsługiwana TLD
- 2202 = nieprawidłowa lub nieobsługiwana nazwa domeny
- 2319 = możliwe tylko dla domeny typu secondary
- 3222 = nie udało się otworzyć domeny
- 3223 = brak uprawnień
- 3305 = domena jest zablokowana do edycji
- 3306 = domena została usunięta
Dane zwrotne
- next_run – czas kolejnej aktualizacji
Szablony
Żądanie JSON:
{
"request": {
"user": "your@login.tld",
"auth": "authentication string",
"command": "dns-domain-axfr-run",
"clTRID": "your ID",
"data": {
"name": "domain name"
}
}
}
Odpowiedź JSON (OK):
{
"response": {
"code": 1000,
"result": "OK",
"timestamp": "UTF timestamp",
"clTRID": "your ID",
"svTRID": "server ID",
"command": "dns-domain-axfr-run",
"data": {
"next_run": "date and time of next update"
}
}
}
dns-domain-axfr-tsig
Żądanie dns-domain-axfr-tsig służy do utworzenia/aktualizacji, usunięcia lub wyświetlenia informacji o kluczu AXFR TSIG dla jednej lub kilku domen.
TSIG (Transaction Signature) to mechanizm uwierzytelniania transferów DNS (AXFR/IXFR), który zapewnia weryfikację tożsamości między serwerem primary a secondary. Weryfikacja ta będzie wymagana przy wszystkich transferach na serwery DNS secondary i musi dokładnie odpowiadać ich konfiguracji.
Jeśli serwer primary nie używa TSIG, nie włączaj tej opcji – transfer AXFR zakończy się niepowodzeniem.
Parametry
- name – nazwa domeny lub kilka nazw rozdzielonych przecinkami (wymagane)
- axfr_tsig_action – akcja AFXR TSIG – wymagana
- create – włączenie lub aktualizacja AXFR TSIG
- cancel – wyłączenie AXFR TSIG
- info – wyświetlenie informacji o AXFR TSIG
Wartości zwrotne
- 1000 = ok
- 2201 = nieobsługiwana TLD
- 2202 = nieprawidłowa lub nieobsługiwana nazwa domeny
- 2319 = możliwe tylko dla domeny typu secondary
- 2334 = AXFR TSIG nie jest ustawiony
- 2335 = nie utworzono AXFR TSIG
- 2336 = nie wyłączono AXFR TSIG
- 2337 = nieprawidłowe polecenie AXFR TSIG
- 2340 = przekroczono maks. liczbę domen w jednej operacji
- 3222 = nie udało się otworzyć domeny
- 3223 = brak uprawnień
- 3305 = domena jest zablokowana do edycji
- 3306 = domena została usunięta
Dane zwrotne
- name = nazwa domeny
- axfr_tsig_action – nazwa akcji AFXR TSIG
- axfr_tsig_name – nazwa klucza AXFR TSIG
- axfr_tsig_alg – algorytm klucza AXFR TSIG
- axfr_tsig_key – wartość klucza AXFR TSIG
Szablony
Żądanie JSON:
{
"request":{
"user": "your@login.tld",
"auth": "authentication string",
"command":"dns-domain-axfr-tsig",
"clTRID": "your ID",
"data":{
"name":"domain1.tld, domain2.tld",
"axfr_tsig_action":"create, cancel, or info"
}
}
}
Odpowiedź JSON dla polecenia create (różne stany domen):
{
"response":{
"code": 1000,
"result": "OK",
"timestamp": "UTF timestamp",
"clTRID": "your ID",
"svTRID": "server ID",
"command":"dns-domain-axfr-tsig",
"data": [
{
"name":"domain1.tld",
"code":1000,
"result":"OK",
"axfr_tsig_action":"create",
"axfr_tsig_name":"keyname",
"axfr_tsig_alg":"hmac-sha256",
"axfr_tsig_key":"lbOYAMGHc6eSo3R2h6rWrHcsp3iSBp/0D0S7kjRqxLI="
},
{
"name":"domain-swapi-00003y.cz",
"code":3222,
"result":"Domain open failed",
"axfr_tsig_action":"create"
}
]
}
}
dns-domain-copy
Użyj żądania dns-domain-copy , aby dodać domenę do DNS przez skopiowanie ustawień i rekordów innej istniejącej domeny.
Parametry
- name – nazwa domeny źródłowej (tej, którą chcesz skopiować) – wymagana
- name_new – nazwa nowo tworzonej domeny – wymagana
Wartości zwrotne
- 1000 = ok
- 2201 = nieobsługiwana TLD
- 2202 = nieprawidłowa lub nieobsługiwana nazwa istniejącej domeny
- 2320 = nieprawidłowa lub nieobsługiwana nazwa nowej domeny
- 2321 = nieobsługiwana TLD nazwy nowej domeny
- 2322 = osiągnięto limit liczby domen w DNS na użytkownika
- 3222 = nie udało się otworzyć domeny
- 3223 = brak uprawnień
- 3305 = domena jest zablokowana do edycji
- 3306 = domena została usunięta
- 3311 = kopiowanie nie powiodło się
- 3312 = nowa domena już istnieje w DNS
Dane zwrotne
Żądanie nie zwraca żadnych danych.
Szablony
Żądanie JSON:
{
"request": {
"user": "your@login.tld",
"auth": "authentication string",
"command": "dns-domain-copy",
"clTRID": "your ID",
"data": {
"name": "original domain name",
"name_new": "new domain name"
}
}
}
Odpowiedź JSON (OK):
{
"response": {
"code": 1000,
"result": "OK",
"timestamp": "UTF timestamp",
"clTRID": "your ID",
"svTRID": "server ID",
"command": "dns-domain-copy"
}
}
dns-domain-commit
Użyj żądania dns-domain-commit po każdej zmianie domeny lub jej rekordów DNS. Potwierdzasz w ten sposób zmiany i żądasz ich rozesłania na serwery DNS.
Jeśli nie wykonasz polecenia dns-domain-commit , system wykona je automatycznie 5 minut po ostatniej zmianie.
Parametry
- name – nazwa domeny – wymagana
Wartości zwrotne
- 1000 = ok
- 2201 = nieobsługiwana TLD
- 2202 = nieprawidłowa lub nieobsługiwana nazwa domeny
- 3222 = nie udało się otworzyć domeny
- 3223 = brak uprawnień
- 3305 = domena jest zablokowana do edycji
- 3306 = domena została usunięta
Dane zwrotne
Żądanie nie zwraca żadnych danych.
Szablony
Żądanie JSON:
{
"request": {
"user": "your@login.tld",
"auth": "authentication string",
"command": "dns-domain-commit",
"clTRID": "your ID",
"data": {
"name": "domain name"
}
}
}
Odpowiedź JSON (OK):
{
"response": {
"code": 1000,
"result": "OK",
"timestamp": "UTF timestamp",
"clTRID": "your ID",
"svTRID": "server ID",
"command": "dns-domain-commit"
}
}
dns-rows-list
Użyj żądania dns-rows-list , aby pobrać listę rekordów domeny w DNS wraz z podstawowymi informacjami.
Aby uzyskać szczegółowe informacje o konkretnym rekordzie, użyj żądania dns-row-detail .
Parametry
- domain – nazwa domeny – wymagana
Wartości zwrotne
- 1000 = ok
- 2201 = nieobsługiwana TLD
- 2202 = nieprawidłowa lub nieobsługiwana nazwa domeny
- 2318 = nie można wykonać dla domeny typu secondary
- 3222 = nie udało się otworzyć domeny
- 3223 = brak uprawnień
- 3305 = domena jest zablokowana do edycji
- 3306 = domena została usunięta
Dane odpowiedzi
- row – rekord
- ID – ID rekordu
- name – nazwa rekordu
- ttl – TTL rekordu
- rdtype – typ rekordu
- rdata – dane rekordu
- changed_date – data zmiany
- author_comment – komentarz
Szablony
Żądanie JSON:
{
"request": {
"user": "your@login.tld",
"auth": "authentication string",
"command": "dns-rows-list",
"clTRID": "your ID",
"data": {
"domain": "domain name"
}
}
}
Odpowiedź JSON (OK):
{
"response": {
"code": 1000,
"result": "OK",
"timestamp": "UTF timestamp",
"clTRID": "your ID",
"svTRID": "server ID",
"command": "dns-rows-list",
"data": {
"row1": {
"ID": "record ID",
"name": "record name (may be empty)",
"ttl": "TTL",
"rdtype": "record type",
"rdata": "record data",
"changed_date": "date and time of last update",
"author_comment": "comment"
}
}
}
}
dns-row-detail
Żądanie dns-row-detail zwraca szczegółowe informacje o konkretnym rekordzie DNS domeny.
Aby uzyskać pełną listę rekordów domeny, użyj żądania dns-rows-list .
Parametry
- name – nazwa domeny – wymagana
- row_id – ID rekordu – wymagane, uzyskane z dns-rows-list
Wartości zwrotne
- 1000 = ok
- 2201 = nieobsługiwana TLD
- 2202 = nieprawidłowa lub nieobsługiwana nazwa domeny
- 2318 = Tej operacji nie można wykonać dla domeny typu secondary
- 3222 = otwarcie domeny nie powiodło się
- 3223 = brak uprawnień
- 3305 = domena jest zablokowana do edycji
- 3306 = domena została usunięta
- 3309 = żądany rekord DNS domeny nie istnieje
Dane zwrotne
- row – rekord
- ID – ID rekordu
- name – nazwa rekordu
- ttl – TTL rekordu
- rdtype – typ rekordu
- rdata – dane rekordu
- changed_date – data zmiany
- author_comment – komentarz
Szablony
Żądanie JSON:
{
"request": {
"user": "your@login.tld",
"auth": "authentication string",
"command": "dns-row-detail",
"clTRID": "your ID",
"data": {
"name": "nazwa domeny",
"row_id": "ID rekordu"
}
}
}
Odpowiedź JSON (OK):
{
"response": {
"code": 1000,
"result": "OK",
"timestamp": "UTF timestamp",
"clTRID": "your ID",
"svTRID": "server ID",
"command": "dns-row-detail",
"data": {
"row1": {
"ID": "record ID",
"name": "record name (may be empty)",
"ttl": "TTL",
"rdtype": "record type",
"rdata": "record data",
"changed_date": "date and time of last update",
"author_comment": "comment"
}
}
}
}
dns-row-add
Żądanie dns-row-add dodaje do domeny nowy rekord DNS.
Domyślnie domena może mieć maksymalnie 50 rekordów DNS. Jeśli potrzebujesz więcej, skontaktuj się z pomocą techniczną ⧉. W zgłoszeniu podaj nazwę domeny, wymaganą liczbę rekordów i szczegółowe uzasadnienie.
Parametry
- domain – nazwa domeny – wymagana
- name – nazwa rekordu – wymagana, ale może być pusta
- ttl – wartość TTL – wymagana
- type – typ rekordu – wymagany
- rdata – dane rekordu – wymagane
- author_comment – komentarz autora – opcjonalny. Wysłanie pustego ciągu usuwa poprzedni komentarz.
Wartości zwrotne
- 1000 = ok
- 2100 = brak wymaganego parametru
- 2201 = nieobsługiwana TLD
- 2202 = nieprawidłowa lub nieobsługiwana nazwa domeny
- 2309 = nieprawidłowy typ rekordu
- 2310 = nie można dodać kolejnego rekordu do domeny
- 2311 = nieprawidłowa nazwa
- 2312 = nieprawidłowa nazwa dla tego typu rekordu
- 2313 = nieprawidłowy CNAME dla tej nazwy
- 2314 = nieprawidłowe dane rekordu
- 2315 = nieprawidłowa TLD
- 2316 = taki rekord już istnieje
- 2317 = nieprawidłowy TTL
- 2318 = operacji nie można wykonać dla domeny typu secondary
- 3222 = otwarcie domeny nie powiodło się
- 3223 = brak uprawnień
- 3305 = domena jest zablokowana do edycji
- 3306 = domena została usunięta
- 3307 = nie udało się dodać rekordu domeny
- 5001 = wewnętrzny błąd uwierzytelniania
Dane zwrotne
Żądanie nie zwraca żadnych danych.
Szablony
Żądanie JSON:
{
"request": {
"user": "your@login.tld",
"auth": "authentication string",
"command": "dns-row-add",
"clTRID": "your ID",
"data": {
"domain": "domain name",
"name": "record name (may be empty)",
"ttl": "TTL",
"type": "record type",
"rdata": "record data"
}
}
}
Żądanie JSON (OK):
{
"response": {
"code": 1000,
"result": "OK",
"timestamp": "UTF timestamp",
"clTRID": "your ID",
"svTRID": "server ID",
"command": "dns-row-add",
}
}
dns-row-update
Użyj żądania dns-row-update , aby zmienić rekord DNS.
Nie można zmienić nazwy ani typu rekordu. W takiej sytuacji usuń pierwotny rekord a następnie utwórz nowy.
Parametry
- domain – nazwa domeny – wymagana
- row_id – ID rekordu – wymagane, uzyskane z dns-rows-list
- ttl – wartość TTL – wymagana
- rdata – dane rekordu – wymagane
- author_comment – komentarz autora – opcjonalny. Wysłanie pustego ciągu usuwa poprzedni komentarz.
Wartości zwrotne
- 1000 = ok
- 2100 = brak wymaganego parametru
- 2201 = nieobsługiwana TLD
- 2202 = nieprawidłowa lub nieobsługiwana nazwa domeny
- 2309 = nieprawidłowy typ rekordu
- 2310 = nie można dodać kolejnego rekordu do domeny
- 2311 = nieprawidłowa nazwa
- 2312 = nieprawidłowa nazwa dla tego typu rekordu
- 2313 = nieprawidłowy CNAME dla tej nazwy
- 2314 = nieprawidłowe dane rekordu
- 2315 = nieprawidłowa TLD
- 2316 = taki rekord już istnieje
- 2317 = nieprawidłowy TTL
- 2318 = operacji nie można wykonać dla domeny typu secondary
- 3222 = otwarcie domeny nie powiodło się
- 3223 = brak uprawnień
- 3305 = domena jest zablokowana do edycji
- 3306 = domena została usunięta
- 3310 = nie udało się zaktualizować rekordu domeny
- 5001 = wewnętrzny błąd uwierzytelniania
Dane zwrotne
Żądanie nie zwraca żadnych danych.
Szablony
Polecenie JSON:
{
"request": {
"user": "your@login.tld",
"auth": "authentication string",
"command": "dns-row-update",
"clTRID": "your ID",
"data": {
"domain": "domain name",
"row_id": "row ID",
"ttl": "TTL",
"rdata": "record data"
}
}
}
Odpowiedź JSON (OK):
{
"response": {
"code": 1000,
"result": "OK",
"timestamp": "UTF timestamp",
"clTRID": "your ID",
"svTRID": "server ID",
"command": "dns-row-update"
}
}
dns-row-delete
Użyj żądania dns-row-delete , aby usunąć rekord DNS domeny.
Parametry
- domain – nazwa domeny – wymagana
- row_id – ID rekordu – wymagane, uzyskane z dns-rows-list
Wartości zwrotne
- 1000 = ok
- 2201 = nieobsługiwana TLD
- 2202 = nieprawidłowa lub nieobsługiwana nazwa domeny
- 2318 = nieprawidłowa operacja dla domeny typu secondary
- 3222 = otwarcie domeny nie powiodło się
- 3223 = brak uprawnień
- 3305 = domena jest zablokowana do edycji
- 3306 = domena została usunięta
- 3308 = usunięcie rekordu nie powiodło się
- 3309 = rekord o tym ID nie istnieje
Dane zwrotne
Żądanie nie zwraca żadnych danych.
Szablony
Żądanie JSON:
{
"request": {
"user": "your@login.tld",
"auth": "authentication string",
"command": "dns-row-delete",
"clTRID": "your ID",
"data": {
"domain": "domain name",
"row_id": "record ID"
}
}
}
Żądanie JSON (OK):
{
"response": {
"code": 1000,
"result": "OK",
"timestamp": "UTF timestamp",
"clTRID": "your ID",
"svTRID": "server ID",
"command": "dns-row-delete",
}
}