WAPI - WEDOS DNS - WEDOS dokumentace & znalostní báze

Tento článek se věnuje příkazům WAPI určeným přímo 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 popisuje následující příkazy:

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 – úprava domény v DNS
dns-domain-delete – smazání domény z DNS
dns-domain-axfr-run – vyžádání přenosu AXFR z primárního serveru do našeho DNS
dns-domain-axfr-tsig – úprava 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 v 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 příkaz dns-domains-list pro výpis DNS domén uživatele.

Parametry

hledat – řetězec vyhledávaný v názvech domén – volitelné
status – filtr podle stavu (active, disabled) – volitelné
typ – filtr podle typu domény (primary, secondary) – volitelné
stránka – číslo stránky (default: 1) – volitelné
page_limit – počet položek na stránku (default: 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

Příkaz vrací seznam domén v této šabloně:

doména
- name – název domény
- status – stav domény v systému
- typ – typ (primary/secondary)

Šablony

JSON dotaz:

{
  "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 odpověď (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žek",
      "page": "číslo stránky",
      "page_limit": "položek na stránku"
    }
  }
}

dns-domain-info

Použijte příkaz dns-domain-info 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 je při více doménách vždy 1000. Případné chybové hodnoty se zobrazují v doména datech, jak ukazuje šablona.

Návratová data

Při úspěchu vrací příkaz detail domény ve WDNS v uzlu data/domain.

Šablony

JSON dotaz 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"
    }
  }
}

JSON odpověď (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 příkaz dns-domain-add pro přidání nové domény do DNS.

Parametry

name – název domény, nebo více názvů oddělených čárkami (povinné)
typ – typ záznamu domény (primary/secondary) – volitelné (default: primary)
axfr_enabled – je povolen odchozí axfr? (0/1) – pouze pro domény primary, volitelné (default: 0)
axfr_ips – seznam povolených IP adres pro axfr (pouze pro záznam primary, 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 povolen? (0/1) – pouze pro domény secondary, volitelné
primary_tsig_name – identifikátor TSIG – pouze pro domény secondary, povinné při zapnutém TSIG
primary_tsig_alg – algoritmus TSIG – pouze pro domény secondary, povinné při zapnutém TSIG
primary_tsig_key – klíč TSIG – pouze pro domény secondary, povinné při zapnutém TSIG
template_id – ID domény typu šablona – pouze pro doménu primary, volitelné

Návratové hodnoty

1000 = ok
2007 = překročena maximální velikost dotazu
2100 = chybí povinný parametr
2101 = neplatné vstupní parametry
2201 = nepodporovaná TLD
2202 = neplatný název domény
2301 = chybný formát type
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 = doménu primary nelze vytvořit pomocí šablony
2325 = nedefinovaná šablona
2330 = Neplatný požadavek – WDNS doména – primary TSIG – neplatná konfigurace
2331 = Neplatný požadavek – WDNS doména – primary TSIG – neplatný formát názvu
2332 = Neplatný požadavek – WDNS doména – primary TSIG – neplatný formát algoritmu
2333 = Neplatný požadavek – WDNS doména – primary 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 se nezdařilo
3303 = doména již v DNS existuje

Návratová data

Příkaz nevrací žádná data.

Šablony

JSON dotaz – 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 dotaz – 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 odpověď (OK):

{
  "response": {
    "code": 1000,
    "result": "OK",
    "timestamp": "UTF timestamp",
    "clTRID": "your ID",
    "svTRID": "server ID",
    "command": "dns-domain-add"
  }
}

JSON odpověď 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 příkaz dns-domain-update pro úpravu domény v DNS.

Parametry

name – název domény, nebo více názvů oddělených čárkami (povinné)
axfr_enabled – je povolen odchozí axfr? (0/1) – pouze pro domény primary, volitelné (default: 0)
axfr_ips – seznam povolených IP adres pro axfr (pouze pro záznam primary, 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 povolen? (0/1) – pouze pro domény secondary, volitelné
primary_tsig_name – identifikátor TSIG – pouze pro domény secondary, povinné při zapnutém TSIG
primary_tsig_alg – algoritmus TSIG – pouze pro domény secondary, povinné při zapnutém TSIG
primary_tsig_key – klíč TSIG – pouze pro domény secondary, povinné při zapnutém TSIG

Návratové hodnoty

1000 = ok
2007 = překročena maximální velikost dotazu
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 – primary TSIG – neplatná konfigurace
2331 = Neplatný požadavek – WDNS doména – primary TSIG – neplatný formát názvu
2332 = Neplatný požadavek – WDNS doména – primary TSIG – neplatný formát algoritmu
2333 = Neplatný požadavek – WDNS doména – primary 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 se nezdařilo
3303 = doména již v DNS existuje

Návratová data

Příkaz nevrací žádná data.

Šablony

JSON dotaz:

{
  "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 odpověď (OK):

{
  "response": {
    "code": 1000,
    "result": "OK",
    "timestamp": "UTF timestamp",
    "clTRID": "your ID",
    "svTRID": "server ID",
    "command": "dns-domain-update"
  }
}

JSON odpověď 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 příkaz dns-domain-delete 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 čárkami (povinné)

Návratové hodnoty

1000 = ok
2007 = překročena maximální velikost dotazu
2340 = překročen max. počet domén v jedné akci
3222 = otevření domény se nezdařilo
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

Příkaz nevrací žádná data.

Šablony

JSON dotaz:

{
  "request": {
    "user": "your@login.tld",
    "auth": "authentication string",
    "command": "dns-domain-delete",
    "clTRID": "your ID",
    "data": {
      "name": "domain1.tld, domain2.tld"
    }
  }
}

JSON odpověď (OK):

{
  "response": {
    "code": 1000,
    "result": "OK",
    "timestamp": "UTF timestamp",
    "clTRID": "your ID",
    "svTRID": "server ID",,
    "command": "dns-domain-delete"
  }
}

JSON odpověď 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

Příkaz dns-domain-axfr-run aktualizuje DNS záznamy z primárního autoritativního serveru přes AXFR co nejdříve (v řádu minut). Používá se u domén secondary, kdy obsah zóny stahujeme do našeho systému z jiného serveru.

Bez tohoto příkazu se AXFR řídí hodnotami 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 typu domény secondary
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

Návratová data

next_run – čas, kdy proběhne další aktualizace

Šablony

JSON dotaz:

{
  "request": {
    "user": "your@login.tld",
    "auth": "authentication string",
    "command": "dns-domain-axfr-run",
    "clTRID": "your ID",
    "data": {
      "name": "domain name"
    }
  }
}

JSON odpověď (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

Příkaz dns-domain-axfr-tsig slouží k vytvoření/úpravě, smazání nebo zobrazení informací o klíči AXFR TSIG pro jednu či více domén.

TSIG (Transaction Signature) je autentizační mechanismus pro přenosy DNS (AXFR/IXFR), který zajišťuje ověření identity mezi servery primary a secondary. Toto ověření bude vyžadováno u všech přenosů na servery secondary DNS a musí přesně odpovídat jejich konfiguraci.

Pokud primární server TSIG nepoužívá, tuto volbu nezapínejte, přenos AXFR by selhal.

Parametry

name – název domény, nebo více názvů oddělených čárkami (povinné)
axfr_tsig_action – akce AFXR TSIG – povinné
- vytvořit – zapnutí nebo úprava 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 typu domény secondary
2334 = AXFR TSIG není 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 se nezdařilo
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

JSON dotaz:

{
  "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 odpověď 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 příkaz dns-domain-copy 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ě vytvář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 názvu nové domény
2322 = dosažen limit počtu domén v DNS na uživatele
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
3311 = kopírování se nezdařilo
3312 = nová doména již v DNS existuje

Návratová data

Příkaz nevrací žádná data.

Šablony

JSON dotaz:

{
  "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 odpověď (OK):

{
  "response": {
    "code": 1000,
    "result": "OK",
    "timestamp": "UTF timestamp",
    "clTRID": "your ID",
    "svTRID": "server ID",
    "command": "dns-domain-copy"
  }
}

dns-domain-commit

Použijte příkaz dns-domain-commit po každé změně domény nebo jejích DNS záznamů. Tím změny potvrdíte a vyžádáte jejich rozeslání na DNS servery.

Pokud příkaz dns-domain-commit neprovedete, systém jej vykoná 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 se nezdařilo
3223 = přístup odepřen
3305 = doména je uzamčena pro úpravy
3306 = doména je smazána

Návratová data

Příkaz nevrací žádná data.

Šablony

JSON dotaz:

{
  "request": {
    "user": "your@login.tld",
    "auth": "authentication string",
    "command": "dns-domain-commit",
    "clTRID": "your ID",
    "data": {
      "name": "domain name"
    }
  }
}

JSON odpověď (OK):

{
  "response": {
    "code": 1000,
    "result": "OK",
    "timestamp": "UTF timestamp",
    "clTRID": "your ID",
    "svTRID": "server ID",
    "command": "dns-domain-commit"
  }
}

dns-rows-list

Použijte příkaz dns-rows-list pro získání seznamu záznamů domény v DNS včetně základních informací.

Podrobnější informace o konkrétním záznamu získáte příkazem dns-row-detail .

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 typu domény secondary
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

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 – komentář

Šablony

JSON dotaz:

{
  "request": {
    "user": "your@login.tld",
    "auth": "authentication string",
    "command": "dns-rows-list",
    "clTRID": "your ID",
    "data": {
      "domain": "domain name"
    }
  }
}

JSON odpověď (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

Příkaz dns-row-detail vrací podrobné informace o konkrétním DNS záznamu domény.

Úplný seznam záznamů domény získáte příkazem dns-rows-list .

Parametry

name – název 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ý nebo nepodporovaný název domény
2318 = Tuto akci nelze provést u typu domény secondary
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 domény 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 – komentář

Šablony

JSON dotaz:

{
  "request": {
    "user": "your@login.tld",
    "auth": "authentication string",
    "command": "dns-row-detail",
    "clTRID": "your ID",
    "data": {
      "name": "doménové jméno",
      "row_id": "ID záznamu"
    }
  }
}

JSON odpověď (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

Příkaz dns-row-add přidá doméně nový DNS záznam.

Ve výchozím nastavení může mít doména až 50 DNS záznamů. Potřebujete-li více, kontaktujte podporu ⧉. V žádosti uveďte název domény, požadovaný počet záznamů a podrobné zdůvodnění.

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 – komentář autora – volitelné. Odeslání prázdného řetězce smaže předchozí komentář.

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 tento název
2314 = neplatná data záznamu
2315 = neplatná TLD
2316 = tento záznam již existuje
2317 = neplatné TTL
2318 = akci nelze provést u typu domény secondary
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 se nezdařilo
5001 = interní chyba autentizace

Návratová data

Příkaz nevrací žádná data.

Šablony

JSON dotaz:

{
  "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 dotaz (OK):

{
  "response": {
    "code": 1000,
    "result": "OK",
    "timestamp": "UTF timestamp",
    "clTRID": "your ID",
    "svTRID": "server ID",
    "command": "dns-row-add",
  }
}

dns-row-update

Použijte příkaz dns-row-update pro změnu DNS záznamu.

Název a typ záznamu změnit nelze. V takovém případě smažte původní záznam a poté vytvořte nový.

Parametry

doména – název domény – povinné
row_id – ID záznamu – povinné, získané z dns-rows-list
ttl – hodnota TTL – povinné
rdata – data záznamu – povinné
author_comment – komentář autora – volitelné. Odeslání prázdného řetězce smaže předchozí komentář.

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 tento název
2314 = neplatná data záznamu
2315 = neplatná TLD
2316 = tento záznam již existuje
2317 = neplatné TTL
2318 = akci nelze provést u typu domény secondary
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 = úprava záznamu domény se nezdařila
5001 = interní chyba autentizace

Návratová data

Příkaz 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"
    }
  }
}

JSON odpověď (OK):

{
  "response": {
    "code": 1000,
    "result": "OK",
    "timestamp": "UTF timestamp",
    "clTRID": "your ID",
    "svTRID": "server ID",
    "command": "dns-row-update"
  }
}

dns-row-delete

Použijte příkaz dns-row-delete pro smazání DNS záznamu domény.

Parametry

doména – název 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ý nebo nepodporovaný název domény
2318 = neplatná akce pro typ domény secondary
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 se nezdařilo
3309 = záznam s tímto ID neexistuje

Návratová data

Příkaz nevrací žádná data.

Šablony

JSON dotaz:

{
  "request": {
    "user": "your@login.tld",
    "auth": "authentication string",
    "command": "dns-row-delete",
    "clTRID": "your ID",
    "data": {
      "domain": "domain name",
      "row_id": "record ID"
    }
  }
}

JSON dotaz (OK):

{
  "response": {
    "code": 1000,
    "result": "OK",
    "timestamp": "UTF timestamp",
    "clTRID": "your ID",
    "svTRID": "server ID",
    "command": "dns-row-delete",
  }
}

WAPI – WEDOS DNS

dns-domains-list

Parametry

Návratové hodnoty

Data odpovědi

Šablony

dns-domain-info

Parametry

Návratové hodnoty

Návratová data

Šablony

dns-domain-add

Parametry

Návratové hodnoty

Návratová data

Šablony

dns-domain-update

Parametry

Návratové hodnoty

Návratová data

Šablony

dns-domain-delete

Parametry

Návratové hodnoty

Návratová data

Šablony

dns-domain-axfr-run

Parametry

Návratové hodnoty

Návratová data

Šablony

dns-domain-axfr-tsig

Parametry

Návratové hodnoty

Návratová data

Šablony

dns-domain-copy

Parametry

Návratové hodnoty

Návratová data

Šablony

dns-domain-commit

Parametry

Návratové hodnoty

Návratová data

Šablony

dns-rows-list

Parametry

Návratové hodnoty

Data odpovědi

Šablony

dns-row-detail

Parametry

Návratové hodnoty

Návratová data

Šablony

dns-row-add

Parametry

Návratové hodnoty

Návratová data

Šablony

dns-row-update

Parametry

Návratové hodnoty

Návratová data

Šablony

dns-row-delete

Parametry

Návratové hodnoty

Návratová data

Šablony

Související návody

WAPI – WEDOS Protection (WGP)

WAPI – příručka

WAPI – Členové WEDOS Global

Nenašli jste, co hledáte?