WAPI - WEDOS DNS - Dokumentácia a znalostná báza WEDOS

Tento článok sa venuje príkazom WAPI konkrétne 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 poskytuje informácie o nasledujúcich požiadavkách:

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 – aktualizácia domény v DNS
dns-domain-delete – zmazanie domény z DNS
dns-domain-axfr-run – vyžiadanie AXFR prenosu z primárneho servera do nášho DNS
dns-domain-axfr-tsig – aktualizácia 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 DNS
dns-rows-list – získanie zoznamu záznamov domény
dns-row-detail – získanie 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 dns-domains-list požiadavka na výpis DNS domén používateľa.

Parametre

search – reťazec, ktorý sa má hľadať medzi názvami domén – voliteľné
status – filtrovanie podľa stavu (active, disabled) – voliteľné
typ – filtrovanie podľa typu domény (primary, secondary) – voliteľné
stránka – číslo stránky (predvolené: 1) – voliteľné
page_limit – počet položiek na stránku (predvolené: 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 vracia zoznam domén používajúcich túto šablónu:

doména
- name – názov domény
- status – stav domény v systéme
- typ – 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": "počet položek celkem",
      "page": "číslo stránky",
      "page_limit": "počet položek na stránku"
    }
  }
}

dns-domain-info

Použite dns-domain-info požiadavka na zistenie základných informácií o jednej či viacerých doménach v systéme WEDOS DNS (WDNS).

Parametre

name – názov domény, pre viac domén 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= otvorenie domény zlyhalo
3223= chyba autorizácie
3305= doména je uzamknutá pre úpravy
3306= doména je zmazaná

Návratová hodnota pre viac domén je vždy 1000. Prípadné chybové hodnoty sa zobrazujú v doména dáta, 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 dns-domain-add požiadavka na pridanie novej domény do DNS.

Parametre

name – názov domény, alebo viac názvov oddelených čiarkou (povinné)
typ – typ záznamu domény (primary/secondary) – voliteľné (predvolené: primary)
axfr_enabled – je odchádzajúci axfr povolený? (0/1) – iba primárne domény, voliteľné (predvolené: 0)
axfr_ips – zoznam povolených ip adries pre axfr (iba pre primárny záznam, 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 TSIG zapnutý? (0/1) – iba sekundárne domény, voliteľné
primary_tsig_name – identifikátor TSIG – iba sekundárne domény, povinné pri zapnutom TSIG
primary_tsig_alg – algoritmus TSIG – iba sekundárne domény, povinné pri zapnutom TSIG
primary_tsig_key – kľúč TSIG – iba sekundárne domény, povinné pri zapnutom TSIG
template_id – ID domény typu šablóna – iba primárna doména, 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 typu
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 sa nenašla
2324 = primárnu doménu sa nedá vytvoriť zo šablóny
2325 = nedefinovaná šablóna
2330 = Neplatná požiadavka – WDNS doména – primárny TSIG – neplatná konfigurácia
2331 = Neplatná požiadavka – WDNS doména – primárny TSIG – neplatný formát názvu
2332 = Neplatná požiadavka – WDNS doména – primárny TSIG – neplatný formát algoritmu
2333 = Neplatná požiadavka – WDNS doména – primárny 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 – primárna 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"
    }
  }
}

JSON požiadavka – sekundárna 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"
    }
  }
}

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 dns-domain-update požiadavka na úpravu domény v DNS.

Parametre

name – názov domény, alebo viac názvov oddelených čiarkou (povinné)
axfr_enabled – je odchádzajúci axfr povolený? (0/1) – iba primárne domény, voliteľné (predvolené: 0)
axfr_ips – zoznam povolených ip adries pre axfr (iba pre primárny záznam, 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 TSIG zapnutý? (0/1) – iba sekundárne domény, voliteľné
primary_tsig_name – identifikátor TSIG – iba sekundárne domény, povinné pri zapnutom TSIG
primary_tsig_alg – algoritmus TSIG – iba sekundárne domény, povinné pri zapnutom TSIG
primary_tsig_key – kľúč TSIG – iba sekundárne domény, 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 – primárny TSIG – neplatná konfigurácia
2331 = Neplatná požiadavka – WDNS doména – primárny TSIG – neplatný formát názvu
2332 = Neplatná požiadavka – WDNS doména – primárny TSIG – neplatný formát algoritmu
2333 = Neplatná požiadavka – WDNS doména – primárny 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 dns-domain-delete požiadavka 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 čiarkou (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 sa nedá 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

Tento dns-domain-axfr-run požiadavka 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 sekundárnych doménach, 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ý, prípadne nepodporovaný názov domény
2319= je možné len pri sekundárnom type 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

next_run – čas, kedy prebehne ďalšia aktualizácia

Š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

Tento dns-domain-axfr-tsig požiadavka slúži na vytvorenie/aktualizáciu, zmazanie alebo zobrazenie informácií o AXFR TSIG kľúči pre jednu či viac domén.

TSIG (Transaction Signature) je autentizačný mechanizmus pre DNS prenosy (AXFR/IXFR), ktorý zaisť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ť konfigurácii.

Ak primárny server nepoužíva TSIG, túto voľbu nezapínajte, prenos AXFR by zlyhal.

Parametre

name – názov domény, alebo viac názvov oddelených čiarkou (povinné)
axfr_tsig_action – akcia AFXR TSIG – povinné
- vytvoriť – zapnutie alebo aktualizácia AXFR TSIG
- zrušiť – vypnutie AXFR TSIG
- info – zobrazenie informácií o AXFR TSIG

Návratové hodnoty

1000 = ok
2201= nepodporovaná TLD
2202= neplatný, prípadne nepodporovaný názov domény
2319= je možné len pri sekundárnom type domény
2334 = AXFR TSIG nebol 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 (viacero 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 dns-domain-copy príkaz 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 skopírovať) – povinné
name_new – názov novo vytvorenej domény – povinné

Návratové hodnoty

1000 = ok
2201= nepodporovaná TLD
2202= neplatný, prípadne nepodporovaný názov existujúcej domény
2320= neplatný, prípadne 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 dns-domain-commit požiadavka po vykonaní akýchkoľvek zmien domény alebo jej DNS záznamov. Potvrdíte tým zmeny a vyžiadate ich rozoslanie na DNS servery.

Ak nevykonáte dns-domain-commit príkaz, systém ho vykoná 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 dns-rows-list požiadavka 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 pomocou dns-row-detail požiadavka.

Parametre

doména – 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 sekundárnom type domény
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 – poznámka

Š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

Tento dns-row-detail požiadavka vracia podrobné informácie o konkrétnom DNS zázname domény.

Kompletný zoznam záznamov domény získate pomocou dns-rows-list požiadavka.

Parametre

name – názov domény – povinné
row_id – ID záznamu – povinné, získané 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 sekundárnom type domény
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 pre doménu 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 – poznámka

Šablóny

JSON požiadavka:

{
  "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"
    }
  }
}

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

Tento dns-row-add požiadavka pridá k doméne nový DNS záznam.

Parametre

doména – názov domény – povinné
name – názov záznamu – povinné, ale môže byť prázdne
ttl – hodnota TTL – povinné
typ – typ záznamu – povinné
rdata – dáta záznamu – povinné
author_comment – poznámka autora – voliteľné. Odoslanie prázdneho reťazca vymaže predchádzajúcu poznámku.

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 sa nedá 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é údaje záznamu
2315= neplatná TLD
2316= tento záznam už existuje
2317= neplatné TTL
2318= akciu nie je možné vykonať pri sekundárnom type domény
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 autentifiká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 dns-row-update požiadavka na zmenu DNS záznamu.

Názov a typ záznamu nemôžete zmeniť. V takej situácii zmažte pôvodný záznam a potom vytvorte novú.

Parametre

doména – názov domény – povinné
row_id – ID záznamu – povinné, získané z dns-rows-list
ttl – hodnota TTL – povinné
rdata – dáta záznamu – povinné
author_comment – poznámka autora – voliteľné. Odoslanie prázdneho reťazca vymaže predchádzajúcu poznámku.

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 sa nedá 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é údaje záznamu
2315= neplatná TLD
2316= tento záznam už existuje
2317= neplatné TTL
2318= akciu nie je možné vykonať pri sekundárnom type domény
3222= otvorenie domény zlyhalo
3223= prístup zamietnutý
3305= doména je uzamknutá pre úpravy
3306= doména je zmazaná
3310 = aktualizácia záznamu domény zlyhala
5001 = interná chyba autentifiká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 dns-row-delete požiadavka na zmazanie DNS záznamu domény.

Parametre

doména – názov domény – povinné
row_id – ID záznamu – povinné, získané z dns-rows-list

Návratové hodnoty

1000 = ok
2201= nepodporovaná TLD
2202= neplatný alebo nepodporovaný názov domény
2318= neplatná akcia pre sekundárny typ domény
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",
  }
}

Bolo to užitočné?

Ďakujeme za spätnú väzbu!

WAPI – WEDOS DNS

dns-domains-list

Parametre

Návratové hodnoty

Dáta odpovede

Šablóny

dns-domain-info

Parametre

Návratové hodnoty

Návratové dáta

Šablóny

dns-domain-add

Parametre

Návratové hodnoty

Návratové dáta

Šablóny

dns-domain-update

Parametre

Návratové hodnoty

Návratové dáta

Šablóny

dns-domain-delete

Parametre

Návratové hodnoty

Návratové dáta

Šablóny

dns-domain-axfr-run

Parametre

Návratové hodnoty

Návratové dáta

Šablóny

dns-domain-axfr-tsig

Parametre

Návratové hodnoty

Návratové dáta

Šablóny

dns-domain-copy

Parametre

Návratové hodnoty

Návratové dáta

Šablóny

dns-domain-commit

Parametre

Návratové hodnoty

Návratové dáta

Šablóny

dns-rows-list

Parametre

Návratové hodnoty

Dáta odpovede

Šablóny

dns-row-detail

Parametre

Návratové hodnoty

Návratové dáta

Šablóny

dns-row-add

Parametre

Návratové hodnoty

Návratové dáta

Šablóny

dns-row-update

Parametre

Návratové hodnoty

Návratové dáta

Šablóny

dns-row-delete

Parametre

Návratové hodnoty

Návratové dáta

Šablóny

Bolo to užitočné?

Obsah článku

Prehliadať kategórie