Tento článek se věnuje příkazům WAPI konkrétně pro službu WEDOS DNS. Informace o nastavení WAPI a řešení běžných problémů najdete v článku WAPI – Manuál.
Tento článek poskytuje informace o následujících požadavcích:
- dns-domains-list – seznam DNS domén v účtu uživatele
- dns-domain-info – informace o doméně
- dns-domain-add – přidání domény do DNS
- dns-domain-update – aktualizace domény v DNS
- dns-domain-delete – smazání domény z DNS
- dns-domain-axfr-run – vyžádání AXFR přenosu z primárního serveru do našeho DNS
- dns-domain-axfr-tsig – aktualizace nebo kontrola nastavení AXFR TSIG
- dns-domain-copy – přidání domény do DNS zkopírováním jiné domény
- dns-domain-commit – uložení změn DNS
- dns-rows-list – získání seznamu záznamů domény
- dns-row-detail – získání detailu záznamu
- dns-row-add – přidání záznamu
- dns-row-update – úprava záznamu
- dns-row-delete – smazání záznamu
dns-domains-list
Použijte dns-domains-list požadavek pro výpis DNS domén uživatele.
Parametry
- search – řetězec, který se má hledat mezi názvy domén – volitelné
- status – filtrování podle stavu (active, disabled) – volitelné
- typ – filtrování podle typu domény (primary, secondary) – volitelné
- stránka – číslo stránky (výchozí: 1) – volitelné
- page_limit – počet položek na stránku (výchozí: 50) – volitelné
- orderby – řazení položek podle created_date nebo domain, následované asc/desc – volitelné, viz šablona
Návratové hodnoty
- 1000 – OK
Data odpovědi
Požadavek vrací seznam domén používajících tuto šablonu:
- doména
- name – název domény
- status – stav domény v systému
- typ – typ (primary/secondary)
Šablony
Požadavek 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"
}
}
}
Odpověď 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": "počet položek celkem",
"page": "číslo stránky",
"page_limit": "počet položek na stránku"
}
}
}
dns-domain-info
Použijte dns-domain-info požadavek pro zjištění základních informací o jedné či více doménách v systému WEDOS DNS (WDNS).
Parametry
- name – název domény, pro více domén použijte řetězec oddělený čárkami (viz šablona) – povinné
Návratové hodnoty
- 1000= OK
- 2201= nepodporovaná TLD
- 2202= neplatný název domény
- 3222= otevření domény se nezdařilo
- 3223= chyba autorizace
- 3305= doména je uzamčena pro úpravy
- 3306= doména je smazána
Návratová hodnota pro více domén je vždy 1000. Případné chybové hodnoty se zobrazují v doména data, jak ukazuje šablona.
Návratová data
V případě úspěchu vrátí požadavek detail domény ve WDNS v uzlu data/domain.
Šablony
Požadavek JSON se 2 doménami:
{
"request": {
"user": "your@login.tld",
"auth": "authentication string",
"command": "dns-domain-info",
"clTRID": "your ID",
"data": {
"name": "domain.name1, domain.name2"
}
}
}
Odpověď JSON (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žijte dns-domain-add požadavek pro přidání nové domény do DNS.
Parametry
- name – název domény, nebo více názvů oddělených čárkou (povinné)
- typ – typ záznamu domény (primary/secondary) – volitelné (výchozí: primary)
- axfr_enabled – je odchozí axfr povolený? (0/1) – pouze primární domény, volitelné (výchozí: 0)
- axfr_ips – seznam povolených ip adres pro axfr (pouze pro primární záznam, více adres zadejte jako seznam oddělený mezerami; povinné, pokud axfr_enabled=1)
- primary_ip – ip adresy primárního dns serveru (povinné, pokud type=secondary)
- primary_tsig_enabled – je TSIG zapnutý? (0/1) – pouze sekundární domény, volitelné
- primary_tsig_name – identifikátor TSIG – pouze sekundární domény, povinné při zapnutém TSIG
- primary_tsig_alg – algoritmus TSIG – pouze sekundární domény, povinné při zapnutém TSIG
- primary_tsig_key – klíč TSIG – pouze sekundární domény, povinné při zapnutém TSIG
- template_id – ID domény typu šablona – pouze primární doména, volitelné
Návratové hodnoty
- 1000 = ok
- 2007 = překročena maximální velikost požadavku
- 2100 = chybí povinný parametr
- 2101= neplatné vstupní parametry
- 2201 = nepodporovaná TLD
- 2202 = neplatný název domény
- 2301 = chybný formát typu
- 2302 = chybí parametr primary_ip
- 2303 = chybný formát primary_ip
- 2304 = neplatný formát axfr_enabled
- 2305 = chybí povinný parametr axfr_ips
- 2306 = neplatný formát axfr_ips
- 2308 = neplatný formát ns
- 2322 = dosažen limit počtu domén v DNS na uživatele
- 2323 = šablona nenalezena
- 2324 = primární doménu nelze vytvořit přes šablonu
- 2325 = nedefinovaná šablona
- 2330 = Neplatný požadavek – WDNS doména – primární TSIG – neplatná konfigurace
- 2331 = Neplatný požadavek – WDNS doména – primární TSIG – neplatný formát názvu
- 2332 = Neplatný požadavek – WDNS doména – primární TSIG – neplatný formát algoritmu
- 2333 = Neplatný požadavek – WDNS doména – primární TSIG – neplatný formát klíče
- 2340 = překročen max. počet domén v jedné akci
- 3302 = přidání domény do DNS selhalo
- 3303 = doména již v DNS existuje
Návratová data
Požadavek nevrací žádná data.
Šablony
Požadavek JSON – primární doména:
{
"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"
}
}
}
Požadavek JSON – sekundární doména:
{
"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"
}
}
}
Odpověď JSON (OK):
{
"response": {
"code": 1000,
"result": "OK",
"timestamp": "UTF timestamp",
"clTRID": "your ID",
"svTRID": "server ID",
"command": "dns-domain-add"
}
}
Odpověď JSON pro více 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žijte dns-domain-update požadavek pro úpravu domény v DNS.
Parametry
- name – název domény, nebo více názvů oddělených čárkou (povinné)
- axfr_enabled – je odchozí axfr povolený? (0/1) – pouze primární domény, volitelné (výchozí: 0)
- axfr_ips – seznam povolených ip adres pro axfr (pouze pro primární záznam, povinné, pokud axfr_enabled=1)
- ip – ip adresa pro odchozí axfr
- primary_ip – ip adresy primárního dns serveru (povinné, pokud type=secondary)
- primary_tsig_enabled – je TSIG zapnutý? (0/1) – pouze sekundární domény, volitelné
- primary_tsig_name – identifikátor TSIG – pouze sekundární domény, povinné při zapnutém TSIG
- primary_tsig_alg – algoritmus TSIG – pouze sekundární domény, povinné při zapnutém TSIG
- primary_tsig_key – klíč TSIG – pouze sekundární domény, povinné při zapnutém TSIG
Návratové hodnoty
- 1000 = ok
- 2007= překročena maximální velikost požadavku
- 2100 = chybí povinný parametr
- 2101= neplatné vstupní parametry
- 2201 = nepodporovaná TLD
- 2202 = neplatný název domény
- 2302 = chybí parametr primary_ip
- 2303 = chybný formát primary_ip
- 2304 = neplatný formát axfr_enabled
- 2305 = chybí povinný parametr axfr_ips
- 2306 = neplatný formát axfr_ips
- 2308 = neplatný formát ns
- 2322 = dosažen limit počtu domén v DNS na uživatele
- 2330 = Neplatný požadavek – WDNS doména – primární TSIG – neplatná konfigurace
- 2331 = Neplatný požadavek – WDNS doména – primární TSIG – neplatný formát názvu
- 2332 = Neplatný požadavek – WDNS doména – primární TSIG – neplatný formát algoritmu
- 2333 = Neplatný požadavek – WDNS doména – primární TSIG – neplatný formát klíče
- 2340= překročen max. počet domén v jedné akci
- 3302 = přidání domény do DNS selhalo
- 3303 = doména již v DNS existuje
Návratová data
Požadavek nevrací žádná data.
Šablony
Požadavek 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"
}
}
}
Odpověď JSON (OK):
{
"response": {
"code": 1000,
"result": "OK",
"timestamp": "UTF timestamp",
"clTRID": "your ID",
"svTRID": "server ID",
"command": "dns-domain-update"
}
}
Odpověď JSON pro více 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žijte dns-domain-delete požadavek pro smazání domény z DNS včetně všech jejích záznamů.
Parametry
- name – název domény, nebo více názvů oddělených čárkou (povinné)
Návratové hodnoty
- 1000 = ok
- 2007= překročena maximální velikost požadavku
- 2340= překročen max. počet domén v jedné akci
- 3222= otevření domény selhalo
- 3223= přístup odepřen
- 3301= záznam nelze odstranit
- 3305= doména je uzamčena pro úpravy
- 3306= doména je smazána
Návratová data
Požadavek nevrací žádná data.
Šablony
Požadavek JSON:
{
"request": {
"user": "your@login.tld",
"auth": "authentication string",
"command": "dns-domain-delete",
"clTRID": "your ID",
"data": {
"name": "domain1.tld, domain2.tld"
}
}
}
Odpověď JSON (OK):
{
"response": {
"code": 1000,
"result": "OK",
"timestamp": "UTF timestamp",
"clTRID": "your ID",
"svTRID": "server ID",,
"command": "dns-domain-delete"
}
}
Odpověď JSON pro více 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
Tento dns-domain-axfr-run požadavek aktualizuje DNS záznamy z primárního autoritativního serveru přes AXFR co nejdříve (během několika minut). Používá se u sekundárních domén, kde obsah zóny stahujeme do našeho systému z jiného serveru.
Bez tohoto požadavku se AXFR řídí údaji REFRESH a RETRY v SOA záznamu.
Parametry
- name – název domény – povinné
Návratové hodnoty
- 1000 = ok
- 2201= nepodporovaná TLD
- 2202= neplatný nebo nepodporovaný název domény
- 2319= lze provést pouze u sekundárního typu domény
- 3222= otevření domény selhalo
- 3223= přístup odepřen
- 3305= doména je uzamčena pro úpravy
- 3306= doména je smazána
Návratová data
- next_run – čas, kdy proběhne další aktualizace
Šablony
Požadavek JSON:
{
"request": {
"user": "your@login.tld",
"auth": "authentication string",
"command": "dns-domain-axfr-run",
"clTRID": "your ID",
"data": {
"name": "domain name"
}
}
}
Odpověď 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
Tento dns-domain-axfr-tsig požadavek slouží k vytvoření/aktualizaci, smazání nebo zobrazení informací o AXFR TSIG klíči pro jednu či více domén.
TSIG (Transaction Signature) je autentizační mechanismus pro DNS přenosy (AXFR/IXFR), který zajišťuje ověření identity mezi primárním a sekundárním serverem. Toto ověření bude vyžadováno u všech přenosů na sekundární DNS servery a musí přesně odpovídat konfiguraci.
Pokud primární server nepoužívá TSIG, tuto volbu nezapínejte, přenos AXFR by selhal.
Parametry
- name – název domény, nebo více názvů oddělených čárkou (povinné)
- axfr_tsig_action – akce AFXR TSIG – povinné
- vytvořit – zapnutí nebo aktualizace AXFR TSIG
- zrušit – vypnutí AXFR TSIG
- info – zobrazení informací o AXFR TSIG
Návratové hodnoty
- 1000 = ok
- 2201= nepodporovaná TLD
- 2202= neplatný nebo nepodporovaný název domény
- 2319= lze provést pouze u sekundárního typu domény
- 2334 = AXFR TSIG nebyl nastaven
- 2335 = AXFR TSIG nebyl vytvořen
- 2336 = AXFR TSIG nebyl vypnut
- 2337 = neplatný příkaz AXFR TSIG
- 2340 = překročen max. počet domén v jedné akci
- 3222= otevření domény selhalo
- 3223= přístup odepřen
- 3305= doména je uzamčena pro úpravy
- 3306= doména je smazána
Návratová data
- name = název domény
- axfr_tsig_action – název akce AFXR TSIG
- axfr_tsig_name – název klíče AXFR TSIG
- axfr_tsig_alg – algoritmus klíče AXFR TSIG
- axfr_tsig_key – hodnota klíče AXFR TSIG
Šablony
Požadavek 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"
}
}
}
Odpověď JSON pro příkaz create (více stavů 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žijte dns-domain-copy příkaz pro přidání domény do DNS zkopírováním nastavení a záznamů z jiné existující domény.
Parametry
- name – název původní domény (té, kterou chcete zkopírovat) – povinné
- name_new – název nově vytvořené domény – povinné
Návratové hodnoty
- 1000 = ok
- 2201= nepodporovaná TLD
- 2202= neplatný nebo nepodporovaný název existující domény
- 2320= neplatný nebo nepodporovaný název nové domény
- 2321= nepodporovaná TLD nového názvu domény
- 2322= dosažen limit počtu domén v DNS na uživatele
- 3222= otevření domény selhalo
- 3223= přístup odepřen
- 3305= doména je uzamčena pro úpravy
- 3306= doména je smazána
- 3311= kopírování selhalo
- 3312= nová doména již v DNS existuje
Návratová data
Požadavek nevrací žádná data.
Šablony
Požadavek 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"
}
}
}
Odpověď JSON (OK):
{
"response": {
"code": 1000,
"result": "OK",
"timestamp": "UTF timestamp",
"clTRID": "your ID",
"svTRID": "server ID",
"command": "dns-domain-copy"
}
}
dns-domain-commit
Použijte dns-domain-commit požadavek po provedení jakýchkoli změn domény nebo jejích DNS záznamů. Potvrdíte tím změny a vyžádáte jejich rozeslání na DNS servery.
Pokud neprovedete dns-domain-commit příkaz, systém jej provede automaticky 5 minut po poslední změně.
Parametry
- name – název domény – povinné
Návratové hodnoty
- 1000 = ok
- 2201= nepodporovaná TLD
- 2202= neplatný nebo nepodporovaný název domény
- 3222= otevření domény selhalo
- 3223= přístup odepřen
- 3305= doména je uzamčena pro úpravy
- 3306= doména je smazána
Návratová data
Požadavek nevrací žádná data.
Šablony
Požadavek JSON:
{
"request": {
"user": "your@login.tld",
"auth": "authentication string",
"command": "dns-domain-commit",
"clTRID": "your ID",
"data": {
"name": "domain name"
}
}
}
Odpověď JSON (OK):
{
"response": {
"code": 1000,
"result": "OK",
"timestamp": "UTF timestamp",
"clTRID": "your ID",
"svTRID": "server ID",
"command": "dns-domain-commit"
}
}
dns-rows-list
Použijte dns-rows-list požadavek pro získání seznamu záznamů domény v DNS spolu se základními informacemi.
Podrobnější informace o konkrétním záznamu získáte pomocí dns-row-detail požadavek.
Parametry
- doména – název domény – povinné
Návratové hodnoty
- 1000 = ok
- 2201= nepodporovaná TLD
- 2202= neplatný nebo nepodporovaný název domény
- 2318= nelze provést u sekundárního typu domény
- 3222= otevření domény selhalo
- 3223= přístup odepřen
- 3305= doména je uzamčena pro úpravy
- 3306= doména je smazána
Data odpovědi
- row – záznam
- ID – ID záznamu
- name – název záznamu
- ttl – TTL záznamu
- rdtype – typ záznamu
- rdata – data záznamu
- changed_date – datum změny
- author_comment – poznámka
Šablony
Požadavek JSON:
{
"request": {
"user": "your@login.tld",
"auth": "authentication string",
"command": "dns-rows-list",
"clTRID": "your ID",
"data": {
"domain": "domain name"
}
}
}
Odpověď 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
Tento dns-row-detail požadavek vrací podrobné informace o konkrétním DNS záznamu domény.
Kompletní seznam záznamů domény získáte pomocí dns-rows-list požadavek.
Parametry
- name – název domény – povinné
- row_id – ID záznamu – povinné, získáno z dns-rows-list
Návratové hodnoty
- 1000 = ok
- 2201= nepodporovaná TLD
- 2202= neplatný nebo nepodporovaný název domény
- 2318= Tuto akci nelze u sekundárního typu domény provést
- 3222= otevření domény se nezdařilo
- 3223= přístup odepřen
- 3305= doména je uzamčena pro úpravy
- 3306= doména je smazána
- 3309= požadovaný DNS záznam pro doménu neexistuje
Návratová data
- row – záznam
- ID – ID záznamu
- name – název záznamu
- ttl – TTL záznamu
- rdtype – typ záznamu
- rdata – data záznamu
- changed_date – datum změny
- author_comment – poznámka
Šablony
Požadavek JSON:
{
"request": {
"user": "your@login.tld",
"auth": "authentication string",
"command": "dns-row-detail",
"clTRID": "your ID",
"data": {
"name": "název domény",
"row_id": "ID záznamu"
}
}
}
Odpověď 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
Tento dns-row-add požadavek přidá k doméně nový DNS záznam.
Parametry
- doména – název domény – povinné
- name – název záznamu – povinné, ale může být prázdné
- ttl – hodnota TTL – povinné
- typ – typ záznamu – povinné
- rdata – data záznamu – povinné
- author_comment – poznámka autora – volitelné. Odeslání prázdného řetězce vymaže předchozí poznámku.
Návratové hodnoty
- 1000 = ok
- 2100 = chybí povinný parametr
- 2201= nepodporovaná TLD
- 2202= neplatný nebo nepodporovaný název domény
- 2309= neplatný typ záznamu
- 2310= k doméně nelze přidat další záznam
- 2311= neplatný název
- 2312= neplatný název pro tento typ záznamu
- 2313= neplatný CNAME pro toto jméno
- 2314= neplatná data záznamu
- 2315= neplatná TLD
- 2316= tento záznam již existuje
- 2317= neplatné TTL
- 2318= akci nelze u sekundárního typu domény provést
- 3222= otevření domény se nezdařilo
- 3223= přístup odepřen
- 3305= doména je uzamčena pro úpravy
- 3306= doména je smazána
- 3307 = přidání záznamu domény selhalo
- 5001 = interní chyba autentizace
Návratová data
Požadavek nevrací žádná data.
Šablony
Požadavek 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"
}
}
}
Požadavek JSON (OK):
{
"response": {
"code": 1000,
"result": "OK",
"timestamp": "UTF timestamp",
"clTRID": "your ID",
"svTRID": "server ID",
"command": "dns-row-add",
}
}
dns-row-update
Použijte dns-row-update požadavek pro změnu DNS záznamu.
Název a typ záznamu nelze změnit. V takové situaci smazat původní záznam a poté vytvořit nový.
Parametry
- doména – název domény – povinné
- row_id – ID záznamu – povinné, získáno z dns-rows-list
- ttl – hodnota TTL – povinné
- rdata – data záznamu – povinné
- author_comment – poznámka autora – volitelné. Odeslání prázdného řetězce vymaže předchozí poznámku.
Návratové hodnoty
- 1000 = ok
- 2100 = chybí povinný parametr
- 2201= nepodporovaná TLD
- 2202= neplatný nebo nepodporovaný název domény
- 2309= neplatný typ záznamu
- 2310= k doméně nelze přidat další záznam
- 2311= neplatný název
- 2312= neplatný název pro tento typ záznamu
- 2313= neplatný CNAME pro toto jméno
- 2314= neplatná data záznamu
- 2315= neplatná TLD
- 2316= tento záznam již existuje
- 2317= neplatné TTL
- 2318= akci nelze u sekundárního typu domény provést
- 3222= otevření domény se nezdařilo
- 3223= přístup odepřen
- 3305= doména je uzamčena pro úpravy
- 3306= doména je smazána
- 3310 = aktualizace záznamu domény se nezdařila
- 5001 = interní chyba autentizace
Návratová data
Požadavek nevrací žádná data.
Šablony
JSON pří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"
}
}
}
Odpověď JSON (OK):
{
"response": {
"code": 1000,
"result": "OK",
"timestamp": "UTF timestamp",
"clTRID": "your ID",
"svTRID": "server ID",
"command": "dns-row-update"
}
}
dns-row-delete
Použijte dns-row-delete požadavek pro smazání DNS záznamu domény.
Parametry
- doména – název domény – povinné
- row_id – ID záznamu – povinné, získáno z dns-rows-list
Návratové hodnoty
- 1000 = ok
- 2201= nepodporovaná TLD
- 2202= neplatný nebo nepodporovaný název domény
- 2318= neplatná akce pro sekundární typ domény
- 3222= otevření domény se nezdařilo
- 3223= přístup odepřen
- 3305= doména je uzamčena pro úpravy
- 3306= doména je smazána
- 3308= smazání záznamu selhalo
- 3309= záznam s tímto ID neexistuje
Návratová data
Požadavek nevrací žádná data.
Šablony
Požadavek JSON:
{
"request": {
"user": "your@login.tld",
"auth": "authentication string",
"command": "dns-row-delete",
"clTRID": "your ID",
"data": {
"domain": "domain name",
"row_id": "record ID"
}
}
}
Požadavek JSON (OK):
{
"response": {
"code": 1000,
"result": "OK",
"timestamp": "UTF timestamp",
"clTRID": "your ID",
"svTRID": "server ID",
"command": "dns-row-delete",
}
}
Bylo to užitečné?
Děkujeme za zpětnou vazbu!