Zákaznická administrace WEDOS GlobalAdmin Panel
Znalostní báze›WEDOS API (WAPI)›NSSET

WAPI – NSSET

Na této stráncensset-checknsset-infonsset-creatensset-updatensset-transfernsset-send-auth-info

Tento článek se věnuje příkazům WAPI určeným pro službu WEDOS DNS (NSSET). Informace o nastavení WAPI a řešení běžných problémů najdete v článku WAPI – Manuál.

Tento návod se věnuje příkazům WAPI pro NSSET, který používají pouze domény CZ. Návod pro DNS najdete v článku WAPI – DNS.

Tento článek popisuje následující požadavky:

nsset-check

Použijte požadavek nsset-check ke kontrole, zda je název NSSET volný k registraci, případně v jakém je stavu.

Parametry

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

Návratové hodnoty

  • 1000 = NSSET je dostupný k registraci
  • 2201 = neplatná TLD
  • 2247 = nepodporovaný formát NSSET
  • 3242 = NSSET je nedostupný
  • 3245 = NSSET je již registrován
  • 3246 = nedostupné
  • 3247 = nedostupné
  • 3248 = nedostupné – karanténa
  • 3249 = nedostupné – rezervováno
  • 3250 = nedostupné – blokováno
  • 3251 = již registrován (u nás)
  • 4218 = odeslání se nezdařilo – chyba komunikace

Návratová data

Požadavek nevrací žádná data.

Šablony

JSON požadavek:

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

JSON odpověď (OK):

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

nsset-info

Použijte požadavek nsset-info k načtení informací o 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 nenačten
  • 3242 = NSSET je nedostupný
  • 4204 = chyba spojení, zkuste to později

Návratová data

Při úspěchu vrátí požadavek v uzlu data prvek nsset s následujícími položkami:

  • name – název NSSET
  • status – stav
  • reg_owner – aktuální registrátor
  • reg_creator – zakladatel NSSET (registrátor)
  • reg_update – registrátor, který provedl poslední změnu
  • created_date – datum vytvoření
  • updated_date – datum poslední změny
  • transfer_date – datum převodu k jinému registrátorovi
  • tech_c – technický kontakt NSSET
  • dns – seznam DNS serverů
  • server
    • name – název serveru
    • addr_ipv4 – IPv4 adresa serveru
    • addr_ipv6 – IPv6 adresa serveru

Šablony

JSON požadavek:

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

JSON odpověď (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žijte požadavek nsset-create k vytvoření nového NSSET. NSSET obsahuje seznam NS serverů, každý server obsahuje položku s názvem a případně i jeho IP adresu. Nastavit lze také technický kontakt – pokud jej nenastavíte, použije se výchozí (WEDOS).

Parametry

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

Návratové hodnoty

  • 1000 = OK, NSSET vytvořen
  • 2201 = zadána chybná TLD
  • 2210 = neplatný formát ns serverů
  • 2211 = příliš mnoho ns serverů
  • 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 je nedostupný
  • 3244 = vytvoření NSSET se nezdařilo
  • 3245 = NSSET je již registrován
  • 3246 = nedostupné
  • 3247 = nedostupné
  • 3248 = nedostupné – karanténa
  • 3249 = nedostupné – rezervováno
  • 3250 = nedostupné – blokováno
  • 3251 = již registrován
  • 4212 = chyba spojení
  • 4218 = kontrola se nezdařila – chyba komunikace
  • 4219 = vytvoření se nezdařilo – chyba komunikace

Návratová data

Při úspěchu vrátí příkaz v uzlu data:

  • nsset – název vytvořeného NSSET

Šablony

JSON požadavek:

{
  "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 odpověď (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žijte požadavek nsset-update ke změně existujícího NSSET. Původní záznam bude zcela přepsán, proto zadávejte všechna data pečlivě.

Parametry

  • tld – TLD – povinné
  • auth_info – NSSET AUTH-ID – povinné
  • name – název NSSET – povinné
  • dns – seznam ns serverů, každá položka serveru obsahuje informace o daném ns serveru – povinné
    • server – povinné alespoň 2
      • name – doménové jméno serveru – povinné
      • addr_ipv4 – IPv4 adresa – nepovinné
      • addr_ipv6 – IPv6 adresa – nepovinné
  • tech_c – ID technického kontaktu – povinné

Návratové hodnoty

  • 1000 = OK, NSSET změněn
  • 2201 = zadána chybná TLD
  • 2209 = syntaktická chyba
  • 2210 = neplatný formát seznamu dns serverů
  • 2211 = příliš mnoho dns serverů
  • 2216 = neplatná syntaxe v kontaktu
  • 2247 = neplatný NSSET
  • 3214 = chyba – NSSET nenač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 = změna NSSET se nezdařila nsset
  • 4204 = NSSET je nedostupný – chyba spojení
  • 4220 = změna NSSET se nezdařila – chyba spojení
  • 4212 = kontakt je nedostupný – chyba spojení

Návratová data

Požadavek nevrací žádná data.

Šablony

JSON požadavek:

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

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

nsset-transfer

Příkaz nsset-transfer změní registrátora NSSET na WEDOS.

Parametry

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

Návratové hodnoty

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

Návratová data

Požadavek nevrací žádná data.

Šablony

JSON pří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 odpověď (OK):

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

nsset-send-auth-info

Příkaz 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 e-mail kontaktu
  • 2201 = nepodporovaná TLD
  • 2209 =  syntaktická chyba NSSET
  • 2216 = syntaktická chyba kontaktu
  • 2243 = pro tento NSSET není povoleno odeslat autorizační kód
  • 2247 = nepodporovaný formát NSSET
  • 3214 = chyba – načtení NSSET se nezdařilo
  • 3217 = odeslání autorizačního kódu se nezdařilo
  • 3228 = nepodporuje práci s kontakty
  • 3229 = načtení kontaktu se nezdařilo
  • 3242 = NSSET není dostupný
  • 3257 = odeslání se nezdařilo, NSSET není dostupný
  • 4204 = NSSET není dostupný – spojení se nezdařilo
  • 4212 = kontakt není dostupný – spojení se nezdařilo
  • 4222 = odeslání se nezdařilo – spojení se nezdařilo

Návratová data

Požadavek nevrací žádná data.

Šablony

JSON požadavek:

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

JSON odpověď (OK):

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

Pomohl vám tento návod?

Vaše hodnocení nám pomáhá návody zlepšovat.

Vzkaz si přečte redakce návodů, ale neodpovídá na něj. Když potřebujete poradit, zeptejte se na komunitním webu Help. Nepište sem hesla ani osobní údaje.

Související návody

WAPI – WEDOS Protection (WGP)

Tento článek přináší informace o příkazech WAPI, které se váží ke službám WEDOS Protection.

WAPI – příručka

Jak WAPI funguje ve WEDOS Global a jak ho aktivovat v zákaznické administraci.

WAPI – WEDOS DNS

Tento článek poskytuje informace o příkazech WAPI, které se vážou ke službám WEDOS DNS.

Nenašli jste, co hledáte?

Pošlete nám dotaz přes kontaktní formulář.

Kontaktní formulář