Tento článok sa venuje príkazom WAPI určeným špecificky pre službu WEDOS DNS. Informácie o nastavení WAPI a riešení bežných problémov nájdete v článku WAPI – Manuál.
Tento článok popisuje nasledujúce požiadavky:
- dns-domains-list – zoznam DNS domén v účte používateľa
- dns-domain-info – informácie o doméne
- dns-domain-add – pridanie domény do DNS
- dns-domain-update – úprava domény v DNS
- dns-domain-delete – zmazanie domény z DNS
- dns-domain-axfr-run – vyžiadanie prenosu AXFR z primárneho servera do nášho DNS
- dns-domain-axfr-tsig – úprava alebo kontrola nastavenia AXFR TSIG
- dns-domain-copy – pridanie domény do DNS skopírovaním inej domény
- dns-domain-commit – uloženie zmien v DNS
- dns-rows-list – načítanie zoznamu záznamov domény
- dns-row-detail – načítanie detailu záznamu
- dns-row-add – pridanie záznamu
- dns-row-update – úprava záznamu
- dns-row-delete – zmazanie záznamu
dns-domains-list
Použite požiadavku dns-domains-list na zobrazenie zoznamu DNS domén používateľa.
Parametre
- search – reťazec vyhľadávaný medzi názvami domén – voliteľné
- status – filtrovanie podľa stavu (active, disabled) – voliteľné
- type – filtrovanie podľa typu domény (primary, secondary) – voliteľné
- page – číslo stránky (default: 1) – voliteľné
- page_limit – počet položiek na stránku (default: 50) – voliteľné
- orderby – zoradenie položiek podľa created_date alebo domain, nasledované asc/desc – voliteľné, pozri šablónu
Návratové hodnoty
- 1000 – OK
Dáta odpovede
Požiadavka vráti zoznam domén podľa tejto šablóny:
- domain
- name – názov domény
- status – stav domény v systéme
- type – typ (primary/secondary)
Šablóny
JSON požiadavka:
{
"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"
}
}
}
JSON odpoveď (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": "celkový počet položiek",
"page": "číslo stránky",
"page_limit": "počet položiek na stránku"
}
}
}
dns-domain-info
Použite požiadavku dns-domain-info na zistenie základných informácií o jednej alebo viacerých doménach v systéme WEDOS DNS (WDNS).
Parametre
- name – názov domény, pri viacerých doménach použite reťazec oddelený čiarkami (pozri šablónu) – povinné
Návratové hodnoty
- 1000= OK
- 2201 = nepodporovaná TLD
- 2202 = neplatný názov domény
- 3222 = doménu sa nepodarilo otvoriť
- 3223 = chyba autorizácie
- 3305 = doména je uzamknutá pre úpravy
- 3306 = doména je zmazaná
Návratová hodnota je pri viacerých doménach vždy 1000. Prípadné chybové hodnoty sa zobrazujú v domain dátach, ako je uvedené v šablóne.
Návratové dáta
Pri úspechu požiadavka vráti detail domény vo WDNS v uzle data/domain.
Šablóny
JSON požiadavka s 2 doménami:
{
"request": {
"user": "your@login.tld",
"auth": "authentication string",
"command": "dns-domain-info",
"clTRID": "your ID",
"data": {
"name": "domain.name1, domain.name2"
}
}
}
JSON odpoveď (domain.name1 OK, domain.name2 chyba):
{
"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
Použite požiadavku dns-domain-add na pridanie novej domény do DNS.
Parametre
- name – názov domény alebo viac názvov oddelených čiarkami (povinné)
- type – typ záznamu domény (primary/secondary) – voliteľné (default: primary)
- axfr_enabled – je povolený odchádzajúci axfr? (0/1) – iba pre domény primary, voliteľné (default: 0)
- axfr_ips – zoznam povolených ip adries pre axfr (iba pre záznam primary, viac adries zadajte ako zoznam oddelený medzerami; povinné, ak axfr_enabled=1)
- primary_ip – ip adresy primárneho dns servera (povinné, ak type=secondary)
- primary_tsig_enabled – je povolený TSIG? (0/1) – iba pre domény secondary, voliteľné
- primary_tsig_name – identifikátor TSIG – iba pre domény secondary, povinné pri zapnutom TSIG
- primary_tsig_alg – algoritmus TSIG – iba pre domény secondary, povinné pri zapnutom TSIG
- primary_tsig_key – kľúč TSIG – iba pre domény secondary, povinné pri zapnutom TSIG
- template_id – ID domény typu šablóna – iba pre doménu primary, voliteľné
Návratové hodnoty
- 1000 = ok
- 2007 = prekročená maximálna veľkosť požiadavky
- 2100 = chýba povinný parameter
- 2101 = neplatné vstupné parametre
- 2201 = nepodporovaná TLD
- 2202 = neplatný názov domény
- 2301 = nesprávny formát type
- 2302 = chýba parameter primary_ip
- 2303 = nesprávny formát primary_ip
- 2304 = neplatný formát axfr_enabled
- 2305 = chýba povinný parameter axfr_ips
- 2306 = neplatný formát axfr_ips
- 2308 = neplatný formát ns
- 2322 = dosiahnutý limit domén v DNS na používateľa
- 2323 = šablóna nenájdená
- 2324 = doménu primary nie je možné vytvoriť cez šablónu
- 2325 = nedefinovaná šablóna
- 2330 = Neplatná požiadavka – WDNS doména – primary TSIG – neplatná konfigurácia
- 2331 = Neplatná požiadavka – WDNS doména – primary TSIG – neplatný formát názvu
- 2332 = Neplatná požiadavka – WDNS doména – primary TSIG – neplatný formát algoritmu
- 2333 = Neplatná požiadavka – WDNS doména – primary TSIG – neplatný formát kľúča
- 2340 = prekročený max. počet domén v jednej akcii
- 3302 = pridanie domény do DNS zlyhalo
- 3303 = doména už v DNS existuje
Návratové dáta
Požiadavka nevracia žiadne dáta.
Šablóny
JSON požiadavka – doména 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"
}
}
}
JSON požiadavka – doména 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"
}
}
}
JSON odpoveď (OK):
{
"response": {
"code": 1000,
"result": "OK",
"timestamp": "UTF timestamp",
"clTRID": "your ID",
"svTRID": "server ID",
"command": "dns-domain-add"
}
}
JSON odpoveď pre viac domén:
{
"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
Použite požiadavku dns-domain-update na úpravu domény v DNS.
Parametre
- name – názov domény alebo viac názvov oddelených čiarkami (povinné)
- axfr_enabled – je povolený odchádzajúci axfr? (0/1) – iba pre domény primary, voliteľné (default: 0)
- axfr_ips – zoznam povolených ip adries pre axfr (iba pre záznam primary, povinné, ak axfr_enabled=1)
- ip – ip adresa pre odchádzajúci axfr
- primary_ip – ip adresy primárneho dns servera (povinné, ak type=secondary)
- primary_tsig_enabled – je povolený TSIG? (0/1) – iba pre domény secondary, voliteľné
- primary_tsig_name – identifikátor TSIG – iba pre domény secondary, povinné pri zapnutom TSIG
- primary_tsig_alg – algoritmus TSIG – iba pre domény secondary, povinné pri zapnutom TSIG
- primary_tsig_key – kľúč TSIG – iba pre domény secondary, povinné pri zapnutom TSIG
Návratové hodnoty
- 1000 = ok
- 2007 = prekročená maximálna veľkosť požiadavky
- 2100 = chýba povinný parameter
- 2101 = neplatné vstupné parametre
- 2201 = nepodporovaná TLD
- 2202 = neplatný názov domény
- 2302 = chýba parameter primary_ip
- 2303 = nesprávny formát primary_ip
- 2304 = neplatný formát axfr_enabled
- 2305 = chýba povinný parameter axfr_ips
- 2306 = neplatný formát axfr_ips
- 2308 = neplatný formát ns
- 2322 = dosiahnutý limit domén v DNS na používateľa
- 2330 = Neplatná požiadavka – WDNS doména – primary TSIG – neplatná konfigurácia
- 2331 = Neplatná požiadavka – WDNS doména – primary TSIG – neplatný formát názvu
- 2332 = Neplatná požiadavka – WDNS doména – primary TSIG – neplatný formát algoritmu
- 2333 = Neplatná požiadavka – WDNS doména – primary TSIG – neplatný formát kľúča
- 2340 = prekročený max. počet domén v jednej akcii
- 3302 = pridanie domény do DNS zlyhalo
- 3303 = doména už v DNS existuje
Návratové dáta
Požiadavka nevracia žiadne dáta.
Šablóny
JSON požiadavka:
{
"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"
}
}
}
JSON odpoveď (OK):
{
"response": {
"code": 1000,
"result": "OK",
"timestamp": "UTF timestamp",
"clTRID": "your ID",
"svTRID": "server ID",
"command": "dns-domain-update"
}
}
JSON odpoveď pre viac domén (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
Použite požiadavku dns-domain-delete na zmazanie domény z DNS vrátane všetkých jej záznamov.
Parametre
- name – názov domény alebo viac názvov oddelených čiarkami (povinné)
Návratové hodnoty
- 1000 = ok
- 2007 = prekročená maximálna veľkosť požiadavky
- 2340 = prekročený max. počet domén v jednej akcii
- 3222 = otvorenie domény zlyhalo
- 3223 = prístup zamietnutý
- 3301 = záznam nie je možné odstrániť
- 3305 = doména je uzamknutá pre úpravy
- 3306 = doména je zmazaná
Návratové dáta
Požiadavka nevracia žiadne dáta.
Šablóny
JSON požiadavka:
{
"request": {
"user": "your@login.tld",
"auth": "authentication string",
"command": "dns-domain-delete",
"clTRID": "your ID",
"data": {
"name": "domain1.tld, domain2.tld"
}
}
}
JSON odpoveď (OK):
{
"response": {
"code": 1000,
"result": "OK",
"timestamp": "UTF timestamp",
"clTRID": "your ID",
"svTRID": "server ID",,
"command": "dns-domain-delete"
}
}
JSON odpoveď pre viac domén (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
Požiadavka dns-domain-axfr-run aktualizuje DNS záznamy z primárneho autoritatívneho servera cez AXFR čo najskôr (v priebehu niekoľkých minút). Používa sa pri doménach secondary, kde obsah zóny sťahujeme do nášho systému z iného servera.
Bez tejto požiadavky sa AXFR riadi hodnotami REFRESH a RETRY v zázname SOA.
Parametre
- name – názov domény – povinné
Návratové hodnoty
- 1000 = ok
- 2201 = nepodporovaná TLD
- 2202 = neplatný alebo nepodporovaný názov domény
- 2319 = je možné vykonať len pre typ domény secondary
- 3222 = otvorenie domény zlyhalo
- 3223 = prístup zamietnutý
- 3305 = doména je uzamknutá pre úpravy
- 3306 = doména je zmazaná
Návratové dáta
- next_run – čas nasledujúcej aktualizácie
Šablóny
JSON požiadavka:
{
"request": {
"user": "your@login.tld",
"auth": "authentication string",
"command": "dns-domain-axfr-run",
"clTRID": "your ID",
"data": {
"name": "domain name"
}
}
}
JSON odpoveď (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
Požiadavka dns-domain-axfr-tsig slúži na vytvorenie/úpravu, zmazanie alebo zobrazenie informácií o kľúči AXFR TSIG pre jednu alebo viac domén.
TSIG (Transaction Signature) je autentizačný mechanizmus pre DNS prenosy (AXFR/IXFR), ktorý zabezpečuje overenie identity medzi primárnym a sekundárnym serverom. Toto overenie bude vyžadované pri všetkých prenosoch na sekundárne DNS servery a musí presne zodpovedať jeho konfigurácii.
Ak primárny server TSIG nepoužíva, túto voľbu nezapínajte, prenos AXFR by zlyhal.
Parametre
- name – názov domény alebo viac názvov oddelených čiarkami (povinné)
- axfr_tsig_action – akcia AFXR TSIG – povinné
- create – zapnutie alebo úprava AXFR TSIG
- cancel – vypnutie AXFR TSIG
- info – zobrazenie informácií o AXFR TSIG
Návratové hodnoty
- 1000 = ok
- 2201 = nepodporovaná TLD
- 2202 = neplatný alebo nepodporovaný názov domény
- 2319 = je možné vykonať len pre typ domény secondary
- 2334 = AXFR TSIG nie je nastavený
- 2335 = AXFR TSIG nebol vytvorený
- 2336 = AXFR TSIG nebol vypnutý
- 2337 = neplatný príkaz AXFR TSIG
- 2340 = prekročený max. počet domén v jednej akcii
- 3222 = otvorenie domény zlyhalo
- 3223 = prístup zamietnutý
- 3305 = doména je uzamknutá pre úpravy
- 3306 = doména je zmazaná
Návratové dáta
- name = názov domény
- axfr_tsig_action – názov akcie AFXR TSIG
- axfr_tsig_name – názov kľúča AXFR TSIG
- axfr_tsig_alg – algoritmus kľúča AXFR TSIG
- axfr_tsig_key – hodnota kľúča AXFR TSIG
Šablóny
JSON požiadavka:
{
"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"
}
}
}
JSON odpoveď pre príkaz create (viac stavov domén):
{
"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
Použite požiadavku dns-domain-copy na pridanie domény do DNS skopírovaním nastavení a záznamov z inej existujúcej domény.
Parametre
- name – názov pôvodnej domény (tej, ktorú chcete kopírovať) – povinné
- name_new – názov novo vytvorenej domény – povinné
Návratové hodnoty
- 1000 = ok
- 2201 = nepodporovaná TLD
- 2202 = neplatný alebo nepodporovaný názov existujúcej domény
- 2320 = neplatný alebo nepodporovaný názov novej domény
- 2321 = nepodporovaná TLD názvu novej domény
- 2322 = dosiahnutý limit počtu domén v DNS na používateľa
- 3222 = otvorenie domény zlyhalo
- 3223 = prístup zamietnutý
- 3305 = doména je uzamknutá pre úpravy
- 3306 = doména je zmazaná
- 3311 = kopírovanie zlyhalo
- 3312 = nová doména už v DNS existuje
Návratové dáta
Požiadavka nevracia žiadne dáta.
Šablóny
JSON požiadavka:
{
"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"
}
}
}
JSON odpoveď (OK):
{
"response": {
"code": 1000,
"result": "OK",
"timestamp": "UTF timestamp",
"clTRID": "your ID",
"svTRID": "server ID",
"command": "dns-domain-copy"
}
}
dns-domain-commit
Použite požiadavku dns-domain-commit po každej zmene domény alebo jej DNS záznamov. Zmeny tým potvrdíte a vyžiadate ich rozoslanie na DNS servery.
Ak príkaz dns-domain-commit nevykonáte, systém ho spustí automaticky 5 minút po poslednej zmene.
Parametre
- name – názov domény – povinné
Návratové hodnoty
- 1000 = ok
- 2201 = nepodporovaná TLD
- 2202 = neplatný alebo nepodporovaný názov domény
- 3222 = otvorenie domény zlyhalo
- 3223 = prístup zamietnutý
- 3305 = doména je uzamknutá pre úpravy
- 3306 = doména je zmazaná
Návratové dáta
Požiadavka nevracia žiadne dáta.
Šablóny
JSON požiadavka:
{
"request": {
"user": "your@login.tld",
"auth": "authentication string",
"command": "dns-domain-commit",
"clTRID": "your ID",
"data": {
"name": "domain name"
}
}
}
JSON odpoveď (OK):
{
"response": {
"code": 1000,
"result": "OK",
"timestamp": "UTF timestamp",
"clTRID": "your ID",
"svTRID": "server ID",
"command": "dns-domain-commit"
}
}
dns-rows-list
Použite požiadavku dns-rows-list na získanie zoznamu záznamov domény v DNS spolu so základnými informáciami.
Podrobnejšie informácie o konkrétnom zázname získate požiadavkou dns-row-detail .
Parametre
- domain – názov domény – povinné
Návratové hodnoty
- 1000 = ok
- 2201 = nepodporovaná TLD
- 2202 = neplatný alebo nepodporovaný názov domény
- 2318 = nie je možné vykonať pri type domény secondary
- 3222 = otvorenie domény zlyhalo
- 3223 = prístup zamietnutý
- 3305 = doména je uzamknutá pre úpravy
- 3306 = doména je zmazaná
Dáta odpovede
- row – záznam
- ID – ID záznamu
- name – názov záznamu
- ttl – TTL záznamu
- rdtype – typ záznamu
- rdata – dáta záznamu
- changed_date – dátum zmeny
- author_comment – komentár
Šablóny
JSON požiadavka:
{
"request": {
"user": "your@login.tld",
"auth": "authentication string",
"command": "dns-rows-list",
"clTRID": "your ID",
"data": {
"domain": "domain name"
}
}
}
JSON odpoveď (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
Požiadavka dns-row-detail vracia podrobné informácie o konkrétnom DNS zázname domény.
Kompletný zoznam záznamov domény získate požiadavkou dns-rows-list .
Parametre
- name – názov domény – povinné
- row_id – ID záznamu – povinné, získate z dns-rows-list
Návratové hodnoty
- 1000 = ok
- 2201 = nepodporovaná TLD
- 2202 = neplatný alebo nepodporovaný názov domény
- 2318 = Túto akciu nie je možné vykonať pri type domény secondary
- 3222 = otvorenie domény zlyhalo
- 3223 = prístup zamietnutý
- 3305 = doména je uzamknutá pre úpravy
- 3306 = doména je zmazaná
- 3309 = požadovaný DNS záznam domény neexistuje
Návratové dáta
- row – záznam
- ID – ID záznamu
- name – názov záznamu
- ttl – TTL záznamu
- rdtype – typ záznamu
- rdata – dáta záznamu
- changed_date – dátum zmeny
- author_comment – komentár
Šablóny
JSON požiadavka:
{
"request": {
"user": "your@login.tld",
"auth": "authentication string",
"command": "dns-row-detail",
"clTRID": "your ID",
"data": {
"name": "názov domény",
"row_id": "ID záznamu"
}
}
}
JSON odpoveď (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
Požiadavka dns-row-add pridá doméne nový DNS záznam.
Doména môže mať štandardne najviac 50 DNS záznamov. Ak potrebujete viac, kontaktujte podporu ⧉. V žiadosti uveďte názov domény, požadovaný počet záznamov a podrobné odôvodnenie.
Parametre
- domain – názov domény – povinné
- name – názov záznamu – povinné, môže však byť prázdne
- ttl – hodnota TTL – povinné
- type – typ záznamu – povinné
- rdata – dáta záznamu – povinné
- author_comment – komentár autora – voliteľné. Odoslaním prázdneho reťazca sa predchádzajúci komentár zmaže.
Návratové hodnoty
- 1000 = ok
- 2100 = chýba povinný parameter
- 2201 = nepodporovaná TLD
- 2202 = neplatný alebo nepodporovaný názov domény
- 2309 = neplatný typ záznamu
- 2310 = k doméne nie je možné pridať ďalší záznam
- 2311 = neplatný názov
- 2312 = neplatný názov pre tento typ záznamu
- 2313 = neplatný CNAME pre tento názov
- 2314 = neplatné dáta záznamu
- 2315 = neplatná TLD
- 2316 = tento záznam už existuje
- 2317 = neplatná TTL
- 2318 = akciu nie je možné vykonať pri type domény secondary
- 3222 = otvorenie domény zlyhalo
- 3223 = prístup zamietnutý
- 3305 = doména je uzamknutá pre úpravy
- 3306 = doména je zmazaná
- 3307 = pridanie záznamu domény zlyhalo
- 5001 = interná chyba autentizácie
Návratové dáta
Požiadavka nevracia žiadne dáta.
Šablóny
JSON požiadavka:
{
"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"
}
}
}
JSON požiadavka (OK):
{
"response": {
"code": 1000,
"result": "OK",
"timestamp": "UTF timestamp",
"clTRID": "your ID",
"svTRID": "server ID",
"command": "dns-row-add",
}
}
dns-row-update
Použite požiadavku dns-row-update na zmenu DNS záznamu.
Názov a typ záznamu nie je možné zmeniť. V takom prípade zmažte pôvodný záznam a potom vytvorte nový.
Parametre
- domain – názov domény – povinné
- row_id – ID záznamu – povinné, získate z dns-rows-list
- ttl – hodnota TTL – povinné
- rdata – dáta záznamu – povinné
- author_comment – komentár autora – voliteľné. Odoslaním prázdneho reťazca sa predchádzajúci komentár zmaže.
Návratové hodnoty
- 1000 = ok
- 2100 = chýba povinný parameter
- 2201 = nepodporovaná TLD
- 2202 = neplatný alebo nepodporovaný názov domény
- 2309 = neplatný typ záznamu
- 2310 = k doméne nie je možné pridať ďalší záznam
- 2311 = neplatný názov
- 2312 = neplatný názov pre tento typ záznamu
- 2313 = neplatný CNAME pre tento názov
- 2314 = neplatné dáta záznamu
- 2315 = neplatná TLD
- 2316 = tento záznam už existuje
- 2317 = neplatná TTL
- 2318 = akciu nie je možné vykonať pri type domény secondary
- 3222 = otvorenie domény zlyhalo
- 3223 = prístup zamietnutý
- 3305 = doména je uzamknutá pre úpravy
- 3306 = doména je zmazaná
- 3310 = úprava záznamu domény zlyhala
- 5001 = interná chyba autentizácie
Návratové dáta
Požiadavka nevracia žiadne dáta.
Šablóny
JSON príkaz:
{
"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"
}
}
}
JSON odpoveď (OK):
{
"response": {
"code": 1000,
"result": "OK",
"timestamp": "UTF timestamp",
"clTRID": "your ID",
"svTRID": "server ID",
"command": "dns-row-update"
}
}
dns-row-delete
Použite požiadavku dns-row-delete na zmazanie DNS záznamu domény.
Parametre
- domain – názov domény – povinné
- row_id – ID záznamu – povinné, získate z dns-rows-list
Návratové hodnoty
- 1000 = ok
- 2201 = nepodporovaná TLD
- 2202 = neplatný alebo nepodporovaný názov domény
- 2318 = neplatná akcia pre typ domény secondary
- 3222 = otvorenie domény zlyhalo
- 3223 = prístup zamietnutý
- 3305 = doména je uzamknutá pre úpravy
- 3306 = doména je zmazaná
- 3308 = zmazanie záznamu zlyhalo
- 3309 = záznam s týmto ID neexistuje
Návratové dáta
Požiadavka nevracia žiadne dáta.
Šablóny
JSON požiadavka:
{
"request": {
"user": "your@login.tld",
"auth": "authentication string",
"command": "dns-row-delete",
"clTRID": "your ID",
"data": {
"domain": "domain name",
"row_id": "record ID"
}
}
}
JSON požiadavka (OK):
{
"response": {
"code": 1000,
"result": "OK",
"timestamp": "UTF timestamp",
"clTRID": "your ID",
"svTRID": "server ID",
"command": "dns-row-delete",
}
}