WAPI – NSSET

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

• nsset-check – kontrola dostupnosti NSSET
• nsset-info – informácie o NSSET
• nsset-create – vytvorenie NSSET
• nsset-update – úprava NSSET
• nsset-transfer – prevod NSSET od iného registrátora
• nsset-send-auth-info – odoslanie AUTH-ID NSSET

---

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