WEDOS Global administráciaAdministrácia
Znalostná báza›WEDOS API (WAPI)›NSSET

WAPI – NSSET

Na tejto stránkensset-checknsset-infonsset-creatensset-updatensset-transfernsset-send-auth-info

Tento článok sa venuje príkazom WAPI určeným pre službu WEDOS DNS (NSSET). Informácie o nastavení WAPI a riešení bežných problémov nájdete v článku WAPI – Manuál.

Tento návod sa venuje príkazom WAPI pre NSSET, ktorý sa používa iba pri doménach CZ. Návod pre DNS nájdete v článku WAPI – DNS.

Tento článok obsahuje informácie o nasledujúcich požiadavkách:

nsset-check

Použite nsset-check požiadavku na kontrolu, či je názov NSSET voľný na registráciu, prípadne v akom inom stave sa nachádza.

Parametre

  • tld – TLD domény
  • name – názov NSSET

Návratové hodnoty

  • 1000 = NSSET je dostupný na registráciu
  • 2201 = neplatná TLD
  • 2247 = nepodporovaný formát NSSET
  • 3242 = NSSET nie je dostupný
  • 3245 = NSSET je už zaregistrovaný
  • 3246 = nedostupné
  • 3247 = nedostupné
  • 3248 = nedostupné – karanténa
  • 3249 = nedostupné – rezervované
  • 3250 = nedostupné – blokované
  • 3251 = už zaregistrované (u nás)
  • 4218 = odoslanie zlyhalo – chyba komuniká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": "nsset-check",
    "clTRID": "your ID",
    "data": {
      "tld": "cz",
      "name": "NSSET name"
    }
  }
}

JSON odpoveď (OK):

{
  "response": {
    "code": 1000,
    "result": "OK",
    "timestamp": "UTF timestamp",
    "clTRID": "your ID",
    "svTRID": "server ID",
    "command": "nsset-check"
  }
}

nsset-info

Použite nsset-info požiadavku na získanie informácií o NSSET.

Parametre

  • tld – TLD
  • name – názov NSSET

Návratové hodnoty

  • 1000 = OK
  • 2201 = neplatná TLD
  • 2209 = chyba syntaxe
  • 2247 = nepodporovaný formát NSSET 
  • 3214 = chyba – NSSET sa nepodarilo načítať
  • 3242 = NSSET nie je dostupný
  • 4204 = chyba spojenia, skúste to neskôr

Návratové dáta

Pri úspechu požiadavka vráti v uzle data prvok nsset s nasledujúcimi položkami:

  • name – názov NSSET
  • status – stav
  • reg_owner – aktuálny registrátor
  • reg_creator – zakladateľ NSSET (registrátor)
  • reg_update – registrátor, ktorý vykonal poslednú zmenu
  • created_date – dátum vytvorenia
  • updated_date – dátum poslednej zmeny
  • transfer_date – dátum prevodu k inému registrátorovi
  • tech_c – technický kontakt NSSET
  • dns – zoznam DNS serverov
  • server
    • name – názov servera
    • addr_ipv4 – IPv4 adresa servera
    • addr_ipv6 – IPv6 adresa servera

Šablóny

JSON požiadavka:

{
  "request": {
    "user": "your@login.tld",
    "auth": "authentication string",
    "command": "nsset-info",
    "clTRID": "your ID",
    "data": {
      "tld": "cz",
      "name": "NSSET name"
    }
  }
}

JSON odpoveď (OK):

{
  "response": {
    "code": 1000,
    "result": "OK",
    "timestamp": "UTF timestamp",
    "clTRID": "your ID",
    "svTRID": "server ID",
    "command": "nsset-info",
    "data": {
      "nsset": {
        "name": "NSSET name",
        "status": "status",
        "reg_owner": "current registrar",
        "reg_creator": "NSSET creator (registrar)",
        "reg_update": "last update registrar",
        "created_date": "date and time of creation",
        "updated_date": "date and time of last update",
        "transfer_date": "date and time of last transfer",
        "tech_c": "technical contact ID",
        "dns": {
          "server1": {
            "name": "DNS server name",
            "addr_ipv4": "DNS server IPv4",
            "addr_ipv6": "DNS server IPv6"
          }
        }
      }
    }
  }
}

nsset-create

Použite nsset-create požiadavku na vytvorenie nového NSSET. NSSET obsahuje zoznam NS serverov, pričom každý server obsahuje položku name a prípadne aj svoju IP adresu. Nastaviť môžete aj technický kontakt – ak tak neurobíte, nastaví sa predvolený (WEDOS).

Parametre

  • tld – TLD
  • name – názov NSSET
  • dns – zoznam ns serverov, každá položka servera obsahuje informácie o danom ns serveri
    • server
      • name – názov (adresa domény)
      • addr_ipv4 – IPv4 adresa
      • addr_ipv6 – IPv6 adresa
  • tech_c – technický kontakt – voliteľné

Návratové hodnoty

  • 1000 = OK, NSSET vytvorený
  • 2201 = zadaná nesprávna TLD
  • 2210 = neplatný formát ns serverov
  • 2211 = príliš veľa ns serverov
  • 2216 = neplatná syntax technického kontaktu 
  • 2247 = nepodporovaný formát NSSET 
  • 3228 = nepodporuje prácu s kontaktmi
  • 3229 = chyba pri načítaní kontaktu
  • 3242 = NSSET nie je dostupný
  • 3244 = vytvorenie NSSET zlyhalo
  • 3245 = NSSET je už zaregistrovaný
  • 3246 = nedostupné
  • 3247 = nedostupné
  • 3248 = nedostupné – karanténa
  • 3249 = nedostupné – rezervované
  • 3250 = nedostupné – blokované
  • 3251 = už zaregistrované
  • 4212 = chyba spojenia
  • 4218 = kontrola zlyhala – chyba komunikácie
  • 4219 = vytvorenie zlyhalo – chyba komunikácie

Návratové dáta

Pri úspechu príkaz v uzle data vráti:

  • nsset – názov vytvoreného NSSET

Šablóny

JSON požiadavka:

{
  "request": {
    "user": "your@login.tld",
    "auth": "authentication string",
    "command": "nsset-create",
    "clTRID": "your ID",,
    "data": {
      "tld": "cz",
      "name": "NSSET name",
      "dns": {
        "server1": {
          "name": "DNS server name",
          "addr_ipv4": "DNS server IPv4 address",
          "addr_ipv6": "DNS server IPv6 address"
        }
      },
      "tech_c": "technical contact ID"
    }
  }
}

JSON odpoveď (OK):

{
  "response": {
    "code": 1000,
    "result": "OK",
    "timestamp": "UTF timestamp",
    "clTRID": "your ID",
    "svTRID": "server ID",
    "command": "nsset-create",
    "data": {
      "nsset": "NSSET name"
    }
  }
}

nsset-update

Použite nsset-update požiadavku na úpravu existujúceho NSSET. Pôvodný záznam sa úplne prepíše, preto všetky údaje zadávajte pozorne.

Parametre

  • tld – TLD – povinné
  • auth_info – AUTH-ID NSSET – povinné
  • name – názov NSSET – povinné
  • dns – zoznam ns serverov, každá položka servera obsahuje informácie o danom ns serveri – povinné
    • server – minimálne 2 povinné
      • name – doménový názov servera – povinné
      • addr_ipv4 – IPv4 adresa – voliteľné
      • addr_ipv6 – IPv6 adresa – voliteľné
  • tech_c – ID technického kontaktu – povinné

Návratové hodnoty

  • 1000 = OK, NSSET upravený
  • 2201 = zadaná nesprávna TLD
  • 2209 = chyba syntaxe
  • 2210 = neplatný formát zoznamu dns serverov
  • 2211 = príliš veľa dns serverov
  • 2216 = neplatná syntax kontaktu
  • 2247 = neplatný NSSET
  • 3214 = chyba – NSSET sa nepodarilo načítať
  • 3228 = nepodporuje prácu s kontaktmi
  • 3229 = chyba pri načítaní kontaktu
  • 3242 = NSSET nie je podporovaný pre túto doménu 
  • 3252 = chyba autorizácie
  • 3254 = úprava NSSET zlyhala nsset
  • 4204 = NSSET nie je dostupný – chyba spojenia
  • 4220 = úprava NSSET zlyhala – chyba spojenia
  • 4212 = kontakt nie je dostupný – chyba spojenia

Návratové dáta

Požiadavka nevracia žiadne dáta.

Šablóny

JSON požiadavka:

{
  "request": {
    "user": "your@login.tld",
    "auth": "authentication string",
    "command": "nsset-update",
    "clTRID": "your ID",
    "data": {
      "tld": "cz",
      "name": "NSSET name",
      "auth_info": "NSSET AUTH-ID",
      "dns": {
        "server1": {
          "name": "DNS server name"
        },
        "server2": {
          "name": "DNS server name"
        }
      },
      "tech_c": "technical contact ID"
    }
  }
}

JSON odpoveď (OK):

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

nsset-transfer

Požiadavka nsset-transfer zmení registrátora NSSET na WEDOS.

Parametre

  • tld – TLD
  • name – názov NSSET
  • auth_info – AUTH-ID NSSET

Návratové hodnoty

  • 1000 = OK
  • 2100 = chýba povinný parameter
  • 2101 = neplatné vstupné parametre
  • 2201 = nepodporovaná TLD
  • 2209 = chyba syntaxe
  • 2215 = chýba auth_info
  • 2247 = neplatný názov NSSET 
  • 2249 = prevod NSSET nie  je povolený pre túto TLD
  • 3214 = chyba – NSSET sa nepodarilo načítať
  • 3242 = NSSET nie je podporovaný
  • 3251 = NSSET je už zaregistrovaný u tohto registrátora 
  • 3255 = chyba autorizácie
  • 3256 = prevod NSSET zlyhal
  • 4204 = NSSET sa nepodarilo načítať – chyba spojenia
  • 4221 = prevod NSSET zlyhal – chyba spojenia

Návratové dáta

Požiadavka nevracia žiadne dáta.

Šablóny

JSON príkaz:

{
  "request": {
    "user": "your@login.tld",
    "auth": "authentication string",
    "command": "nsset-transfer",
    "clTRID": "your ID",
    "data": {
      "tld": "cz",
      "name": "NSSET name",
      "auth_info": "NSSET AUTH-ID"
    }
  }
}

JSON odpoveď (OK):

{
  "response": {
    "code": 1000,
    "result": "OK",
    "timestamp": "UTF timestamp",
    "clTRID": "your ID",
    "svTRID": "server ID",
    "command": "nsset-transfer"
  }
}

nsset-send-auth-info

Požiadavka nsset-send-auth-info odošle AUTH-ID NSSET na e-mail technického kontaktu NSSET.

Parametre

  • tld – TLD
  • name – názov NSSET

Návratové hodnoty

  • 1000 = OK, auth_info bolo odoslané na e-mail kontaktu
  • 2201 = nepodporovaná TLD
  • 2209 =  chyba syntaxe NSSET
  • 2216 = chyba syntaxe kontaktu
  • 2243 = pre tento NSSET nie je povolené odosielať autorizačný kód
  • 2247 = nepodporovaný formát NSSET
  • 3214 = chyba – načítanie NSSET zlyhalo
  • 3217 = odoslanie autorizačného kódu zlyhalo
  • 3228 = nepodporuje prácu s kontaktmi
  • 3229 = načítanie kontaktu zlyhalo
  • 3242 = NSSET nie je dostupný
  • 3257 = odoslanie zlyhalo, NSSET nie je dostupný
  • 4204 = NSSET nie je dostupný – spojenie zlyhalo
  • 4212 = kontakt nie je dostupný – spojenie zlyhalo
  • 4222 = odoslanie zlyhalo – spojenie zlyhalo

Návratové dáta

Požiadavka nevracia žiadne dáta.

Šablóny

JSON požiadavka:

{
  "request": {
    "user": "your@login.tld",
    "auth": "authentication string",
    "command": "nsset-send-auth-info",
    "clTRID": "your ID",
    "data": {
      "tld": "cz",
      "name": "NSSET name"
    }
  }
}

JSON odpoveď (OK):

{
  "response": {
    "code": 1000,
    "result": "OK",
    "timestamp": "UTF timestamp",
    "clTRID": "your ID",
    "svTRID": "server ID",
    "command": "nsset-send-auth-info"
  }
}

Pomohol vám tento článok?

Vaše hodnotenie nám pomáha zlepšovať naše články.

Vašu správu si prečíta tím tvorcov dokumentácie, ale neodpovedá na ňu. Ak potrebujete poradiť, kontaktujte nás pomocou kontaktného formulára. Nezadávajte sem heslá ani osobné údaje.

Súvisiace návody

WAPI – WEDOS Protection (WGP)

Tento článok prináša informácie o príkazoch WAPI, ktoré sa viažu na služby WEDOS Protection.

WAPI – príručka

V tomto článku sa dozviete, ako WAPI funguje vo WEDOS Global a ako ho aktivovať v zákazníckej administrácii.

WAPI – WEDOS DNS

Tento článok poskytuje informácie o príkazoch WAPI, ktoré sa viažu na služby WEDOS DNS.

Nenašli ste, čo hľadáte?

Pošlite nám otázku cez kontaktný formulár.

Kontaktný formulár