WAPI - NSSET

Tento článek obsahuje informace o následujících žádostech:

• nsset-check - Kontrola dostupnosti NSSET
• nsset-info - Informace o NSSET
• nsset-create - vytvoří NSSET
• nsset-update - aktualizuje NSSET
• nsset-transfer - přenos NSSET od jiného registrátora
• nsset-send-auth-info - odeslání NSSET AUTH-ID

---

nsset-check

Pomocí požadavku nsset-check můžete zkontrolovat, zda je název NSSET volný pro registraci nebo zda je v jiném stavu.

Parametry

• tld - doména TLD
• name - název NSSET

Návratové hodnoty

• 1000 = NSSET je k dispozici pro registraci
• 2201 = neplatná TLD
• 2247 = nepodporovaný formát NSSET
• 3242 = NSSET není k dispozici
• 3245 = NSSET je již registrován
• 3246 = nedostupné
• 3247 = nedostupné
• 3248 = nedostupný - karanténa
• 3249 = nedostupné - vyhrazeno
• 3250 = nedostupný - blokovaný
• 3251 = již registrovaný (u nás)
• 4218 = odeslání se nezdařilo - chyba komunikace

Vrátit data

Požadavek nevrací žádná data.

Šablony

Požadavek JSON:

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

Odpověď JSON (OK):

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

---

nsset-info

Požadavek nsset-info slouží ke stažení informací o síti NSSET.

Parametry

• tld - TLD
• name - název NSSET

Návratové hodnoty

• 1000 = OK
• 2201 = neplatná TLD
• 2209 = syntaktická chyba
• 2247 = nepodporovaný formát NSSET 
• 3214 = chyba - NSSET není načtený
• 3242 = NSSET není k dispozici
• 4204 = chyba připojení, zkuste to později

Vrátit data

Pokud je požadavek úspěšný, vrátí prvek nsset v datovém uzlu s následujícími položkami:

• name - název NSSET
• status - stav
• reg_owner - aktuální registrátor
• reg_creator - tvůrce NSSET (registrátor)
• reg_update - registrátor, který provedl poslední aktualizaci
• created_date - datum vytvoření
• updated_date - datum poslední aktualizace
• transfer_date - datum převodu k jinému registrátorovi
• tech_c - technický kontakt NSSET
• dns - Seznam serverů DNS
• server
  • name - název serveru
  • addr_ipv4 - Adresa serveru IPv4
  • addr_ipv6 - Adresa serveru IPv6

Šablony

Požadavek JSON:

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

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

K vytvoření nového NSSET použijte požadavek nsset-create. NSSET obsahuje seznam serverů NS, každý server obsahuje položku jména a případně také svou IP adresu. Můžete také nastavit technický kontakt - pokud tak neučiníte, bude nastaven výchozí (WEDOS).

Parametry

• tld - TLD
• name - název NSSET
• dns - seznam serverů ns, každá položka serveru obsahuje informace o daném serveru ns.
  • server
    • name - název (adresa domény)
    • addr_ipv4 - Adresa IPv4
    • addr_ipv6 - Adresa IPv6
• tech_c - technický kontakt - nepovinné

Návratové hodnoty

• 1000 = OK, vytvořen NSSET
• 2201 = špatně zadaná TLD
• 2210 = neplatný formát ns serverů
• 2211 = příliš mnoho serverů ns
• 2216 = neplatná syntaxe v technickém kontaktu 
• 2247 = nepodporovaný formát NSSET 
• 3228 = nepodporuje práci s kontakty
• 3229 = chyba při načítání kontaktu
• 3242 = NSSET není k dispozici
• 3244 = Vytvoření NSSET se nezdařilo
• 3245 = NSSET je již registrován
• 3246 = nedostupné
• 3247 = nedostupné
• 3248 = nedostupný - karanténa
• 3249 = nedostupné - vyhrazeno
• 3250 = nedostupný - blokovaný
• 3251 = již registrovaný
• 4212 = chyba připojení
• 4218 = kontrola selhala - chyba komunikace
• 4219 = vytvoření se nezdařilo - chyba komunikace

Vrátit data

V případě úspěchu se vrátí příkaz v datovém uzlu:

• nsset - název vytvořeného NSSETu

Šablony

Požadavek JSON:

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

Odpověď JSON (OK):

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

---

nsset-update

Pomocí požadavku nsset-update můžete upravit existující síť NSSET. Starý záznam bude zcela přepsán, proto zadávejte všechny údaje pečlivě.

Parametry

• tld - TLD
• name - název NSSET
• dns - seznam serverů ns, každá položka serveru obsahuje informace o daném serveru ns.
  • server
    • name - název domény serveru
    • addr_ipv4 - Adresa IPv4
    • addr_ipv6 - Adresa IPv6
• tech_c - ID technického kontaktu - nepovinné

Návratové hodnoty

• 1000 = OK, NSSET upraveno
• 2201 = zadána špatná TLD
• 2209 = syntaktická chyba
• 2210 = neplatný formát seznamu serverů DNS
• 2211 = příliš mnoho serverů DNS
• 2216 = neplatná syntaxe v kontaktu
• 2247 = neplatný NSSET
• 3214 = chyba - NSSET není načtený
• 3228 = nepodporuje práci s kontakty
• 3229 = chyba při načítání kontaktu
• 3242 = NSSET není pro tuto doménu podporován. 
• 3252 = chyba autorizace
• 3254 = NSSET modifikace se nezdařila nsset
• 4204 = NSSET není k dispozici - chyba spojení
• 4220 = modifikace NSSET se nezdařila - chyba spojení
• 4212 = kontakt je nedostupný - chyba spojení

Vrátit data

Požadavek nevrací žádná data.

Šablony

Požadavek JSON:

{
  "request": {
    "user": "your@login.tld",
    "auth": "authentication string",
    "command": "nsset-update",
    "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"
    }
  }
}

Odpověď JSON (OK):

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

---

nsset-transfer

Požadavek nsset-transfer změní registrátora NSSET na WEDOS.

Parametry

• tld - TLD
• name - název NSSET
• auth_info - NSSET AUTH-ID

Návratové hodnoty

• 1000 = OK
• 2100 = chybí požadovaný parametr
• 2101 = neplatné vstupní parametry
• 2201 = nepodporovaná TLD
• 2209 = syntaktická chyba
• 2215 = chybí auth_info
• 2247 = neplatný název NSSET 
• 2249 = přenos NSSET není pro tuto TLD povolen
• 3214 = chyba - NSSET není načtený
• 3242 = NSSET není podporován
• 3251 = NSSET je již u tohoto registrátora registrován. 
• 3255 = chyba autorizace
• 3256 = přenos NSSET se nezdařil
• 4204 = NSSET není načten - chyba spojení
• 4221 = přenos NSSET se nezdařil - chyba spojení

Vrátit data

Požadavek nevrací žádná data.

Šablony

Příkaz JSON:

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

Odpověď JSON (OK):

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

---

nsset-send-auth-info

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

Parametry

• tld - TLD
• name - název NSSET

Návratové hodnoty

• 1000 = OK, auth_info odesláno na kontaktní e-mail
• 2201 = nepodporovaná TLD
• 2209 = chyba syntaxe NSSET
• 2216 = chyba syntaxe kontaktu
• 2243 = pro tento NSSET není povoleno odeslat autorizační kód
• 2247 = nepodporuje formát NSSET
• 3214 = chyba - čtení NSSET selhalo
• 3217 = odeslání autorizačního kódu se nezdařilo
• 3228 = nepodporuje práci s kontakty
• 3229 = čtení kontaktu se nezdařilo
• 3242 = NSSET není k dispozici
• 3257 = odeslání se nezdařilo, NSSET není k dispozici
• 4204 = NSSET není k dispozici - spojení se nezdařilo
• 4212 = kontakt není k dispozici - spojení se nezdařilo
• 4222 = odeslání se nezdařilo - spojení se nezdařilo

Vrátit data

Požadavek nevrací žádná data.

Šablony

Požadavek JSON:

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

Odpověď JSON (OK):

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