REST API – DNS

GET /domains

Vracia zoznam domén prihláseného používateľa s podporou vyhľadávania, filtrovania, zoraďovania a stránkovania.

Parametre:

• search – voliteľný, reťazec – vyhľadávanie v názve domény (podporuje IDN)
• status – voliteľný, reťazec – filter podľa stavu domény (napr. active, disabled, deleted)
• type – voliteľný, reťazec – filter podľa typu domény (primary, secondary)
• page – voliteľný, celé číslo – číslo stránky, predvolene 1
• page_limit – voliteľný, celé číslo – počet záznamov na stránku, predvolene 50
• orderby – voliteľný, reťazec – zoradenie v tvare column [ASC|DESC]; podporované stĺpce sú domain a created_date; predvolené je domain ASC. Neplatný stĺpec sa ticho ignoruje a použije sa predvolené zoradenie.

Návratové kódy:

• 1000 – OK
• 5001 – interná chyba prihlásenia

Dáta odpovede:

• domain – pole domén; každá položka obsahuje name, status, type
• total – celkový počet domén zodpovedajúcich filtru
• page – aktuálna stránka
• page_limit – počet záznamov na stránku

Príklad:

curl -X GET -H 'Authorization: Bearer <TOKEN>' \
  'https://api.wedos.com/v2/dns/domains?search=domain1&status=active&page=1&page_limit=50'

{
  "code": 1000,
  "msg": "OK",
  "request_id": "f3a9c1e2-7b44-4e21-9c2a-1d6e8a5f3b70",
  "data": {
    "domain": [
      {"name": "domain1.cz", "status": "active", "type": "primary"},
      {"name": "domain1.com", "status": "active", "type": "secondary"}
    ],
    "total": 2,
    "page": 1,
    "page_limit": 50
  }
}

GET /domains/{domain}

Vracia podrobné informácie o doméne.

Parametre:

• domain – povinný, reťazec (path) – názov domény

Návratové kódy:

• 1000 – OK
• 2100 – chýba povinný parameter
• 2101 – neplatný vstupný parameter
• 2201 – nepodporovaná TLD
• 2202 – neplatný názov domény
• 3222 – nepodarilo sa otvoriť doménu (napr. neexistuje)
• 3223 – chyba autorizácie (doména patrí inému používateľovi)
• 3305 – doména je uzamknutá
• 3306 – doména je zmazaná
• 5001 – interná chyba prihlásenia

Dáta odpovede:

• domain – objekt s podrobnosťami domény: name, status, type, tlock, autocommit, axfr_enabled, axfr_ips, 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_cnt, ns_out, ns

Príklad:

curl -X GET -H 'Authorization: Bearer <TOKEN>' \
  'https://api.wedos.com/v2/dns/domains/domain1.tld'

{
  "code": 1000,
  "msg": "OK",
  "request_id": "f3a9c1e2-7b44-4e21-9c2a-1d6e8a5f3b71",
  "data": {
    "domain": {
      "name": "domain1.tld",
      "status": "active",
      "type": "primary",
      "tlock": 0,
      "autocommit": 1,
      "axfr_enabled": 0,
      "axfr_ips": "",
      "changed": 0,
      "changed_date": null,
      "commit_date": "2026-09-30 12:00:00",
      "reload_pending": 0,
      "reload_pending_date": null,
      "reload_date": "2026-09-30 12:01:00",
      "disabled_date": null,
      "enabled_date": null,
      "add_date": "2026-01-15 09:30:00",
      "rname": "wedos.com",
      "serial": 2026093001,
      "refresh": 10800,
      "retry": 3600,
      "expire": 604800,
      "minimum": 3600,
      "rr_cnt": 12,
      "ns_out": 1,
      "ns": ["ns.wedos.cz", "ns.wedos.net", "ns.wedos.eu"]
    }
  }
}

GET /domains/{domain}/axfr-tsig

Vracia informácie o AXFR TSIG kľúči domény (slúži na autentizáciu DNS prenosov AXFR/IXFR). Ak nie je pre doménu TSIG nastavený, vráti endpoint chybu 2334.

Parametre:

• domain – povinný, reťazec (path) – názov domény

Návratové kódy:

• 1000 – OK
• 2334 – AXFR TSIG nie je pre doménu nastavený
• 2337 – neplatný AXFR TSIG príkaz
• 2340 – prekročený maximálny počet domén v jednej hromadnej akcii
• ďalšie chybové kódy súvisiace s otvorením domény – pozri GET /domains/{domain} (napr. 3222, 3223, 3305, 3306)

Dáta odpovede:

• name – názov domény
• axfr_tsig_action – vykonaná akcia, vždy info
• axfr_tsig_name – názov TSIG kľúča
• axfr_tsig_alg – algoritmus TSIG kľúča
• axfr_tsig_key – hodnota TSIG kľúča (base64)

Príklad:

curl -X GET -H 'Authorization: Bearer <TOKEN>' \
  'https://api.wedos.com/v2/dns/domains/domain1.tld/axfr-tsig'

{
  "code": 1000,
  "msg": "OK",
  "request_id": "f3a9c1e2-7b44-4e21-9c2a-1d6e8a5f3b72",
  "data": {
    "name": "example.cz",
    "axfr_tsig_action": "info",
    "axfr_tsig_name": "domain1.tld.",
    "axfr_tsig_alg": "hmac-sha256",
    "axfr_tsig_key": "asdfghJKL1234567890."
  }
}

GET /domains/{domain}/rows

Vracia zoznam DNS záznamov domény. Túto operáciu nemožno vykonať pre sekundárne domény (ich záznamy spravuje primárny server).

Parametre:

• domain – povinný, reťazec (path) – názov domény

Návratové kódy:

• 1000 – OK
• 2100 – chýba povinný parameter
• 2101 – neplatný vstupný parameter
• 2201 – nepodporovaná TLD
• 2202 – neplatný názov domény
• 2318 – operáciu nemožno vykonať na sekundárnej doméne
• 3222 – nepodarilo sa otvoriť doménu
• 3223 – chyba autorizácie
• 3305 – doména je uzamknutá
• 3306 – doména je zmazaná
• 5001 – interná chyba prihlásenia

Dáta odpovede:

• row – pole DNS záznamov, každý s kľúčmi ID, name, ttl, rdtype, rdata, changed_date, author_comment

Príklad:

curl -X GET -H 'Authorization: Bearer <TOKEN>' \
  'https://api.wedos.com/v2/dns/domains/domain1.tld/rows'

{
  "code": 1000,
  "msg": "OK",
  "request_id": "1d6e8a5f3b73",
  "data": {
    "row": [
      {
        "ID": 123,
        "name": "www",
        "ttl": 1800,
        "rdtype": "A",
        "rdata": "46.28.105.2",
        "changed_date": "2026-09-30 12:00:00",
        "author_comment": "production server"
      },
      {
        "ID": 124,
        "name": "",
        "ttl": 3600,
        "rdtype": "MX",
        "rdata": "10 mail.wedos.com.",
        "changed_date": "2026-09-30 12:00:00",
        "author_comment": ""
      }
    ]
  }
}

GET /domains/{domain}/rows/{row_id}

Vracia detail jedného DNS záznamu domény.

Parametre:

• domain – povinný, reťazec (path) – názov domény
• row_id – povinný, celé číslo (path) – ID DNS záznamu

Návratové kódy:

• 1000 – OK
• 2100 – chýba povinný parameter
• 2101 – neplatný vstupný parameter
• 2201 – nepodporovaná TLD
• 2202 – neplatný názov domény
• 2318 – operáciu nemožno vykonať na sekundárnej doméne
• 3222 – nepodarilo sa otvoriť doménu
• 3223 – chyba autorizácie
• 3305 – doména je uzamknutá
• 3306 – doména je zmazaná
• 3309 – záznam s týmto ID neexistuje
• 5001 – interná chyba prihlásenia

Dáta odpovede:

• row – objekt s podrobnosťami záznamu: ID, name, ttl, rdtype, rdata, changed_date, author_comment

Príklad:

curl -X GET -H 'Authorization: Bearer <TOKEN>' \
  'https://api.wedos.com/v2/dns/domains/domain1.tld/rows/123'

{
  "code": 1000,
  "msg": "OK",
  "request_id": "f3a9c1e2",
  "data": {
    "row": {
      "ID": 123,
      "name": "www",
      "ttl": 1800,
      "rdtype": "A",
      "rdata": "46.28.105.2",
      "changed_date": "2026-09-30 12:00:00",
      "author_comment": "production server"
    }
  }
}

POST /domains/add

Vytvorí novú doménu vo WDNS, buď ako primárnu doménu (DNS záznamy spravuje WEDOS), alebo ako sekundárnu doménu (záznamy sa prenášajú cez AXFR z externého primárneho servera).

Parametre:

• name – povinný, reťazec – názov domény
• type – voliteľný, reťazec – primary alebo secondary, predvolene primary
• axfr_enabled – voliteľný, boolean (0/1) – povolený odchádzajúci AXFR, predvolene 0
• axfr_ips – voliteľný, reťazec alebo pole reťazcov – IP adresy povolené pre odchádzajúci AXFR (reťazec adries oddelených medzerami, alebo JSON pole adries); povinný, ak axfr_enabled=1
• primary_ip – voliteľný (povinný pre type=secondary), reťazec – IPv4 adresa primárneho servera, z ktorého sa záznamy prenášajú
• primary_tsig_enabled – voliteľný, boolean – vyžaduje TSIG autentizáciu prichádzajúceho AXFR (iba pre type=secondary)
• primary_tsig_name – voliteľný (povinný, ak primary_tsig_enabled=1), reťazec – názov TSIG kľúča
• primary_tsig_alg – voliteľný (povinný, ak primary_tsig_enabled=1), reťazec – algoritmus TSIG kľúča; podporované hodnoty: hmac-md5, hmac-sha1, hmac-sha224, hmac-sha256, hmac-sha384, hmac-sha512
• primary_tsig_key – voliteľný (povinný, ak primary_tsig_enabled=1), reťazec – hodnota TSIG kľúča kódovaná v base64 (minimálna dĺžka dekódovaného kľúča 8 bajtov)
• template_id – voliteľný, celé číslo – ID šablóny použitej na vytvorenie domény; platí iba pre type=primary

Návratové kódy:

• 1000 – OK
• 2100 – chýba povinný parameter
• 2101 – neplatný vstupný parameter
• 2201 – nepodporovaná TLD
• 2202 – neplatný názov domény
• 2301 – neplatný formát parametra type
• 2302 – parameter primary_ip chýba
• 2303 – neplatný formát parametra primary_ip
• 2304 – neplatný formát parametra axfr_enabled
• 2305 – povinný parameter axfr_ips chýba
• 2306 – neplatný formát parametra axfr_ips
• 2322 – prekročený limit WDNS domén pre tento účet
• 2323 – šablóna nenájdená
• 2324 – šablónu možno použiť iba na vytvorenie primárnej domény
• 2325 – nie je definovaná žiadna šablóna
• 2330–2333 – neplatná konfigurácia TSIG (celkovo, názov, algoritmus, kľúč)
• 2355 – AXFR IP adresa nie je platná
• 2366 – axfr_ips reťazec je dlhší ako 255 znakov
• 2367 – nie je zadaná žiadna IP adresa pre odchádzajúci AXFR
• 3302 – pridanie domény do WDNS sa nepodarilo
• 3303 – doména už vo WDNS existuje
• 5001 – interná chyba autorizácie

Dáta odpovede:

• domain_id – interné ID novo vytvorenej domény
• name – názov domény

Príklad:

curl -X POST -H 'Authorization: Bearer <TOKEN>' -H 'Content-Type: application/json' \
  'https://api.wedos.com/v2/dns/domains/add' \
  --data '{"name":"domain1.tld","type":"primary"}'

Telo požiadavky:

{
  "name": "domain1.tld",
  "type": "primary"
}

Odpoveď:

{
  "code": 1000,
  "msg": "OK",
  "request_id": "f3a9c1e2-7b44-4e21-9c2a-1d6e8a5f3b75",
  "data": {
    "domain_id": 48213,
    "name": "domain1.tld"
  }
}

POST /domains/{domain}/commit

Uplatní čakajúce zmeny domény (commit) a rozšíri ich na produkčné DNS servery.

Parametre:

• domain – povinný, reťazec (path) – názov domény

Návratové kódy:

• 1000 – OK
• 2100 – chýba povinný parameter
• 2101 – neplatný vstupný parameter
• 2201 – nepodporovaná TLD
• 2202 – neplatný názov domény
• 3222 – nepodarilo sa otvoriť doménu
• 3223 – chyba autorizácie
• 3305 – doména je uzamknutá
• 3306 – doména je zmazaná
• 5001 – interná chyba autorizácie

Dáta odpovede: Endpoint nevracia žiadne dáta; úspech je indikovaný kódom 1000.

Príklad:

curl -X POST -H 'Authorization: Bearer <TOKEN>' \
  'https://api.wedos.com/v2/dns/domains/domain1.tld/commit'

{
  "code": 1000,
  "msg": "OK",
  "request_id": "f3a9c1e2-7b44-4e21-9c2a-1d6e8a5f3b76"
}

POST /domains/{domain}/copy

Vytvorí kópiu existujúcej domény (vrátane jej DNS záznamov) pod novým názvom.

Parametre:

• domain – povinný, reťazec (path) – názov zdrojovej domény
• name_new – povinný, reťazec (telo požiadavky) – názov novej domény

Návratové kódy:

• 1000 – OK
• 2100 – chýba povinný parameter
• 2101 – neplatný vstupný parameter
• 2201 – nepodporovaná TLD
• 2202 – neplatný názov domény
• 2320 – neplatný alebo nepodporovaný názov novej domény
• 2321 – nepodporovaná TLD nového názvu domény
• 2322 – prekročený limit DNS záznamov na používateľa
• 3222 – nepodarilo sa otvoriť doménu
• 3223 – chyba autorizácie
• 3305 – doména je uzamknutá
• 3306 – doména je zmazaná
• 3311 – kopírovanie sa nepodarilo
• 3312 – doména s týmto názvom už existuje
• 5001 – interná chyba autorizácie

Dáta odpovede: Endpoint nevracia žiadne dáta; úspech je indikovaný kódom 1000.

Príklad:

curl -X POST -H 'Authorization: Bearer <TOKEN>' -H 'Content-Type: application/json' \
  'https://api.wedos.com/v2/dns/domains/domain1.tld/copy' \
  --data '{"name_new":"domain2.tld"}'

Telo požiadavky:

{
  "name_new": "domain2.tld"
}

Odpoveď:

{
  "code": 1000,
  "msg": "OK",
  "request_id": "f3a9c1e2-7b44-4e21-9c2a-1d6e8a5f3b77"
}

POST /domains/{domain}/axfr-run

Okamžite spustí AXFR prenos DNS záznamov pre sekundárnu doménu (mimo pravidelného rozvrhu).

Parametre:

• domain – povinný, reťazec (path) – názov domény

Návratové kódy:

• 1000 – OK
• 2100 – chýba povinný parameter
• 2101 – neplatný vstupný parameter
• 2201 – nepodporovaná TLD
• 2202 – neplatný názov domény
• 2319 – možno vykonať iba na sekundárnej doméne
• 3222 – nepodarilo sa otvoriť doménu
• 3223 – chyba autorizácie
• 3305 – doména je uzamknutá
• 3306 – doména je zmazaná
• 5001 – interná chyba autorizácie

Dáta odpovede:

• next_run – čas najbližšej plánovanej aktualizácie

Príklad:

curl -X POST -H 'Authorization: Bearer <TOKEN>' \
  'https://api.wedos.com/v2/dns/domains/domain1.tld/axfr-run'

{
  "code": 1000,
  "msg": "OK",
  "request_id": "f3a9c1e2-7b44-4e21-9c2a-1d6e8a5f3b78",
  "data": {
    "next_run": "2026-10-01 09:15:00"
  }
}

POST /domains/{domain}/axfr-tsig

Vytvorí alebo zruší AXFR TSIG kľúč domény (autentizácia odchádzajúcich AXFR/IXFR prenosov).

Parametre:

• domain – povinný, reťazec (path) – názov domény
• action – voliteľný, reťazec (telo požiadavky) – create (vytvorenie/aktualizácia) alebo cancel, predvolene create; hodnota sa interne mapuje na WAPI parameter axfr_tsig_action

Návratové kódy:

• 1000 – OK
• 2335 – AXFR TSIG nebol pre doménu vytvorený
• 2336 – AXFR TSIG nebol pre doménu zrušený
• 2337 – neplatný AXFR TSIG príkaz
• 2340 – prekročený maximálny počet domén v jednej hromadnej akcii
• ďalšie chybové kódy súvisiace s otvorením domény – pozri GET /domains/{domain} (napr. 3222, 3223, 3305, 3306)

Dáta odpovede:

• name – názov domény
• axfr_tsig_action – vykonaná akcia (create/cancel)
• axfr_tsig_name – názov TSIG kľúča (iba pre create)
• axfr_tsig_alg – algoritmus TSIG kľúča (iba pre create)
• axfr_tsig_key – hodnota TSIG kľúča, base64 (iba pre create)

Príklad:

curl -X POST -H 'Authorization: Bearer <TOKEN>' -H 'Content-Type: application/json' \
  'https://api.wedos.com/v2/dns/domains/domain1.tld/axfr-tsig' \
  --data '{"action":"create"}'

Telo požiadavky:

{
  "action": "create"
}

Odpoveď:

{
  "code": 1000,
  "msg": "OK",
  "request_id": "f3a9c1e2-7b44-4e21-9c2a-1d6e8a5f3b79",
  "data": {
    "name": "example.cz",
    "axfr_tsig_action": "create",
    "axfr_tsig_name": "example.cz.",
    "axfr_tsig_alg": "hmac-sha256",
    "axfr_tsig_key": "asdfghJKL1234567890"
  }
}

POST /domains/{domain}/rows

Pridá k doméne nový DNS záznam.

Parametre:

• domain – povinný, reťazec (path) – názov domény
• name – povinný, reťazec (telo požiadavky) – názov záznamu; prázdny reťazec znamená záznam na úrovni samotnej domény (apex)
• ttl – povinný, celé číslo (telo požiadavky) – TTL záznamu v sekundách, nenulová hodnota
• type – povinný, reťazec (telo požiadavky) – typ záznamu; podporované hodnoty: A, AAAA, ALIAS, CAA, CNAME, DNAME, HTTPS, MX, NAPTR, NS, SRV, SSHFP, TLSA, TXT
• rdata – povinný, reťazec (telo požiadavky) – dáta záznamu (formát závisí od typu záznamu)
• author_comment – voliteľný, reťazec (telo požiadavky) – komentár autora; povolené sú iba písmená bez diakritiky, číslice a medzery; starší klienti môžu namiesto toho posielať auth_comment (rovnocenný alias)

Návratové kódy:

• 1000 – OK
• 2100 – chýba povinný parameter
• 2101 – neplatný vstupný parameter
• 2201 – nepodporovaná TLD
• 2202 – neplatný názov domény
• 2298 – parameter author_comment obsahuje neplatné znaky
• 2309 – neplatný typ záznamu
• 2310 – k doméne nemožno pridať ďalší záznam (dosiahnutý limit záznamov)
• 2311 – neplatný názov záznamu
• 2312 – neplatný názov pre daný 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 – operáciu nemožno vykonať na sekundárnej doméne
• 3222 – nepodarilo sa otvoriť doménu
• 3223 – chyba autorizácie
• 3305 – doména je uzamknutá
• 3306 – doména je zmazaná
• 3307 – pridanie záznamu domény sa nepodarilo
• 5001 – interná chyba autorizácie

Dáta odpovede:

• domain – názov domény
• row_id – ID novo vytvoreného záznamu

Príklad:

curl -X POST -H 'Authorization: Bearer <TOKEN>' -H 'Content-Type: application/json' \
  'https://api.wedos.com/v2/dns/domains/domain1.tld/rows' \
  --data '{"name":"www","ttl":1800,"type":"A","rdata":"46.28.105.2"}'

Telo požiadavky:

{
  "name": "www",
  "ttl": 1800,
  "type": "A",
  "rdata": "46.28.105.2"
}

Odpoveď:

{
  "code": 1000,
  "msg": "OK",
  "request_id": "f3a9c1e2-7b44-4e21-9c2a-1d6e8a5f3b80",
  "data": {
    "domain": "domain1.tld",
    "row_id": 125
  }
}

POST /domains/{domain}/zone-import

Importuje DNS záznamy domény. Podporované sú dva režimy (import_type):

• axfr – endpoint sa pokúsi stiahnuť záznamy cez AXFR zo zadanej IP adresy a vráti ich ako text vo formáte BIND na ručnú kontrolu. Toto volanie záznamy neimportuje automaticky. Na ich import ich skopírujte a odošlite v samostatnom volaní s import_type=text.
• text – záznamy odovzdané vo formáte BIND v parametri rows sa overia a importujú priamo do domény.

Import je možný iba pre primárnu doménu.

Parametre:

• domain – povinný, reťazec (path) – názov domény
• import_type – povinný, reťazec (telo požiadavky) – axfr alebo text
• axfr_ip – povinný pre import_type=axfr, reťazec (telo požiadavky) – IPv4 adresa DNS servera, z ktorého sa záznamy stiahnu cez AXFR
• rows – povinný pre import_type=text, reťazec (telo požiadavky) – DNS záznamy ako text vo formáte BIND (nie JSON pole, ale jediný viacriadkový reťazec)

Návratové kódy:

• 1000 – OK
• 2338 – nemáte oprávnenie upravovať túto doménu
• 2350 – neplatná hodnota typu importu
• 2351 – chýba zoznam DNS záznamov (rows nebol zadaný s import_type=text)
• 2352 – zo zadanej IP sa nepodarilo získať žiadne dáta na import
• 2353 – importovaný zoznam DNS obsahuje neplatný záznam; import nebol vykonaný
• 2354 – chýba AXFR IP adresa
• 2355 – AXFR IP adresa nie je platná
• 2357 – z textu sa nepodarilo získať žiadne dáta na import
• 2358 – nemožno importovať 2 zhodné záznamy (názov, typ, dáta)
• 2359 – prekročený maximálny počet záznamov
• 2360 – záznam CNAME nemožno importovať, ak pre jeho názov existuje akýkoľvek iný záznam
• 2363 – záznamy rovnakého typu musia mať rovnakú TTL
• 2364 – DNS záznamy neboli importované (interná chyba importu)
• 2365 – AXFR IP adresa musí byť vo formáte IPv4
• 2368 – import je povolený iba pre primárnu doménu

Dáta odpovede:

• pre import_type=axfr: name, import_type, axfr_ip, desc (popisná poznámka), rows (stiahnuté záznamy vo formáte BIND, ohraničené --- BEGIN ---/--- END ---, určené na skopírovanie do nadväzujúceho volania s import_type=text)
• pre import_type=text (úspešný import): name, import_type, source_rows (vstupný text), imported_rows (skutočne importované záznamy, vo formáte BIND)

Príklad:

curl -X POST -H 'Authorization: Bearer <TOKEN>' -H 'Content-Type: application/json' \
  'https://api.wedos.com/v2/dns/domains/domain1.tld/zone-import' \
  --data '{"import_type":"text","rows":"www IN A 46.28.105.2\nmail IN A 46.28.105.3"}'

Telo požiadavky:

{
  "import_type": "text",
  "rows": "www IN A 46.28.105.2\nmail IN A 46.28.105.3"
}

Odpoveď:

{
  "code": 1000,
  "msg": "OK",
  "request_id": "f3a9c1e2-7b44-4e21-9c2a-1d6e8a5f3b81",
  "data": {
    "name": "example.cz",
    "import_type": "text",
    "source_rows": "\n--- BEGIN ---\nwww IN A 46.28.105.2\nmail IN A 46.28.105.3\n--- END ---",
    "imported_rows": "\n--- BEGIN ---\nwww 3600 IN A 46.28.105.2\nmail 3600 IN A 46.28.105.3\n--- END ---"
  }
}

PATCH /domains/{domain}

Zmení nastavenia existujúcej domény (parametre AXFR a TSIG). Názov a typ domény touto operáciou zmeniť nemožno.

Parametre:

• domain – povinný, reťazec (path) – názov domény
• axfr_enabled – voliteľný, boolean (0/1) – povolený odchádzajúci AXFR
• axfr_ips – voliteľný, reťazec alebo pole reťazcov – IP adresy povolené pre odchádzajúci AXFR (reťazec adries oddelených medzerami, alebo JSON pole adries); povinný pri nastavení axfr_enabled=1
• primary_ip – voliteľný, reťazec – IPv4 adresa primárneho servera (iba sekundárna doména)
• primary_tsig_enabled – voliteľný, boolean – vyžaduje TSIG autentizáciu prichádzajúceho AXFR (iba sekundárna doména)
• primary_tsig_name – voliteľný, reťazec – názov TSIG kľúča
• primary_tsig_alg – voliteľný, reťazec – algoritmus TSIG kľúča (hmac-md5, hmac-sha1, hmac-sha224, hmac-sha256, hmac-sha384, hmac-sha512)
• primary_tsig_key – voliteľný, reťazec – hodnota TSIG kľúča, base64

Návratové kódy:

• 1000 – OK
• 2007 – prekročená maximálna veľkosť požiadavky
• 2100 – chýba vstupný parameter
• 2101 – neplatné vstupné parametre
• 2201 – nepodporovaná TLD
• 2202 – neplatný alebo nepodporovaný názov domény
• 2303 – neplatný formát parametra primary_ip
• 2304 – neplatný formát parametra axfr_enabled
• 2305 – povinný parameter axfr_ips chýba
• 2306 – neplatný formát parametra axfr_ips
• 2330–2333 – neplatná konfigurácia TSIG (celkovo, názov, algoritmus, kľúč)
• 3222 – nepodarilo sa otvoriť doménu
• 3223 – chyba autorizácie
• 3304 – aktualizácia záznamu domény sa nepodarila
• 3305 – doména je uzamknutá
• 3306 – doména je zmazaná
• 5001 – interná chyba autentizácie

Dáta odpovede: Endpoint nevracia žiadne dáta; úspech je indikovaný kódom 1000.

Príklad:

curl -X PATCH -H 'Authorization: Bearer <TOKEN>' -H 'Content-Type: application/json' \
  'https://api.wedos.com/v2/dns/domains/domain1.tld' \
  --data '{"axfr_enabled":1,"axfr_ips":"46.28.105.2 46.28.105.3"}'

Telo požiadavky:

{
  "axfr_enabled": 1,
  "axfr_ips": "46.28.105.2 46.28.105.3"
}

Odpoveď:

{
  "code": 1000,
  "msg": "OK",
  "request_id": "f3a9c1e2-7b44-4e21-9c2a-1d6e8a5f3b82"
}

PATCH /domains/{domain}/rows/{row_id}

Zmení existujúci DNS záznam. Názov a typ záznamu touto operáciou zmeniť nemožno; na ich zmenu pôvodný záznam zmažte a pridajte nový.

Parametre:

• domain – povinný, reťazec (path) – názov domény
• row_id – povinný, celé číslo (path) – ID DNS záznamu
• ttl – povinný, celé číslo (telo požiadavky) – nová hodnota TTL v sekundách
• rdata – povinný, reťazec (telo požiadavky) – nové dáta záznamu
• author_comment – voliteľný, reťazec (telo požiadavky) – komentár autora; povolené sú iba písmená bez diakritiky, číslice a medzery; starší klienti môžu namiesto toho posielať auth_comment .

Návratové kódy:

• 1000 – OK
• 2100 – chýba povinný parameter
• 2101 – neplatný vstupný parameter
• 2201 – nepodporovaná TLD
• 2202 – neplatný názov domény
• 2298 – parameter author_comment obsahuje neplatné znaky
• 2314 – neplatné dáta záznamu
• 2316 – tento záznam už existuje
• 2317 – neplatná TTL
• 2318 – operáciu nemožno vykonať na sekundárnej doméne
• 3222 – nepodarilo sa otvoriť doménu
• 3223 – chyba autorizácie
• 3305 – doména je uzamknutá
• 3306 – doména je zmazaná
• 3309 – záznam s týmto ID neexistuje
• 3310 – zmena záznamu sa nepodarila
• 5001 – interná chyba autorizácie

Dáta odpovede: Endpoint nevracia žiadne dáta; úspech je indikovaný kódom 1000.

Príklad:

curl -X PATCH -H 'Authorization: Bearer <TOKEN>' -H 'Content-Type: application/json' \
  'https://api.wedos.com/v2/dns/domains/domain1.tld/rows/123' \
  --data '{"ttl":3600,"rdata":"46.28.105.3"}'

Telo požiadavky:

{
  "ttl": 3600,
  "rdata": "46.28.105.3"
}

Odpoveď:

{
  "code": 1000,
  "msg": "OK",
  "request_id": "f3a9c1e2-7b44-4e21-9c2a-1d6e8a5f3b83"
}

DELETE /domains/{domain}

Zmaže doménu z WDNS.

Parametre:

• domain – povinný, reťazec (path) – názov domény

Návratové kódy:

• 1000 – OK
• 2100 – chýba povinný parameter
• 2101 – neplatný vstupný parameter
• 2201 – nepodporovaná TLD
• 2202 – neplatný alebo nepodporovaný názov domény
• 3222 – nepodarilo sa otvoriť doménu
• 3223 – prístup odmietnutý
• 3301 – odstránenie záznamu domény sa nepodarilo
• 3305 – doména je uzamknutá
• 3306 – doména je už zmazaná
• 5001 – interná chyba autorizácie

Dáta odpovede: Endpoint nevracia žiadne dáta; úspech je indikovaný kódom 1000.

Príklad:

curl -X DELETE -H 'Authorization: Bearer <TOKEN>' \
  'https://api.wedos.com/v2/dns/domains/domain1.tld'

{
  "code": 1000,
  "msg": "OK",
  "request_id": "f3a9c1e2-7b44-4e21-9c2a-1d6e8a5f3b84"
}

DELETE /domains/{domain}/rows/{row_id}

Zmaže DNS záznam domény.

Parametre:

• domain – povinný, reťazec (path) – názov domény
• row_id – povinný, celé číslo (path) – ID DNS záznamu

Návratové kódy:

• 1000 – OK
• 2100 – chýba povinný parameter
• 2101 – neplatný vstupný parameter
• 2201 – nepodporovaná TLD
• 2202 – neplatný alebo nepodporovaný názov domény
• 2318 – operáciu nemožno vykonať na sekundárnej doméne
• 3222 – nepodarilo sa otvoriť doménu
• 3223 – prístup odmietnutý
• 3305 – doména je uzamknutá
• 3306 – doména je zmazaná
• 3308 – zmazanie záznamu sa nepodarilo
• 3309 – záznam s týmto ID neexistuje
• 5001 – interná chyba autorizácie

Dáta odpovede: Endpoint nevracia žiadne dáta; úspech je indikovaný kódom 1000.

Príklad:

curl -X DELETE -H 'Authorization: Bearer <TOKEN>' \
  'https://api.wedos.com/v2/dns/domains/domain1.tld/rows/123'

{
  "code": 1000,
  "msg": "OK",
  "request_id": "f3a9c1e2-7b44-4e21-9c2a-1d6e8a5f3b85"
}