WAPI – NSSET

Ten artykuł zawiera informacje o następujących żądaniach:

• nsset-check – sprawdzenie dostępności NSSET
• nsset-info – informacje o NSSET
• nsset-create – utworzenie NSSET
• nsset-update – aktualizacja NSSET
• nsset-transfer – transfer NSSET od innego rejestratora
• nsset-send-auth-info – wysłanie AUTH-ID NSSET

---

nsset-check

Użyj polecenia nsset-check , aby sprawdzić, czy nazwa NSSET jest wolna do rejestracji, czy też jest w innym stanie.

Parametry

• tld – TLD domeny
• name – nazwa NSSET

Wartości zwracane

• 1000 = NSSET jest dostępny do rejestracji
• 2201 = nieprawidłowy TLD
• 2247 = nieobsługiwany format NSSET
• 3242 = NSSET jest niedostępny
• 3245 = NSSET jest już zarejestrowany
• 3246 = niedostępny
• 3247 = niedostępny
• 3248 = niedostępny – kwarantanna
• 3249 = niedostępny – zarezerwowany
• 3250 = niedostępny – zablokowany
• 3251 = już zarejestrowany (u nas)
• 4218 = wysyłanie nie powiodło się – błąd komunikacji

Dane zwracane

Żądanie nie zwraca żadnych danych.

Szablony

Żądanie JSON:

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

Odpowiedź JSON (OK):

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

---

nsset-info

Użyj polecenia nsset-info , aby pobrać informacje o NSSET.

Parametry

• tld – TLD
• name – nazwa NSSET

Wartości zwracane

• 1000 = OK
• 2201 = nieprawidłowy TLD
• 2209 = błąd składni
• 2247 = nieobsługiwany format NSSET 
• 3214 = błąd – nie wczytano NSSET
• 3242 = NSSET jest niedostępny
• 4204 = błąd połączenia, spróbuj ponownie później

Dane zwracane

W przypadku powodzenia żądanie zwraca w węźle data element nsset z następującymi wpisami:

• name – nazwa NSSET
• status – stan
• reg_owner – aktualny rejestrator
• reg_creator – twórca NSSET (rejestrator)
• reg_update – rejestrator, który wykonał ostatnią aktualizację
• created_date – data utworzenia
• updated_date – data ostatniej aktualizacji
• transfer_date – data transferu do innego rejestratora
• tech_c – kontakt techniczny NSSET
• dns – lista serwerów DNS
• serwer
  • name – nazwa serwera
  • addr_ipv4 – adres IPv4 serwera
  • addr_ipv6 – adres IPv6 serwera

Szablony

Żądanie JSON:

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

Odpowiedź 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

Użyj polecenia nsset-create , aby utworzyć nowy NSSET. NSSET zawiera listę serwerów NS, każdy serwer zawiera wpis z nazwą i ewentualnie także jego adres IP. Możesz też ustawić kontakt techniczny – jeśli tego nie zrobisz, zostanie ustawiony domyślny (WEDOS).

Parametry

• tld – TLD
• name – nazwa NSSET
• dns – lista serwerów ns, każdy wpis serwera zawiera informacje o tym serwerze ns
  • serwer
    • name – nazwa (adres domeny)
    • addr_ipv4 – adres IPv4
    • addr_ipv6 – adres IPv6
• tech_c – kontakt techniczny – opcjonalne

Wartości zwracane

• 1000 = OK, NSSET utworzony
• 2201 = podano nieprawidłowy TLD
• 2210 = nieprawidłowy format serwerów ns
• 2211 = zbyt wiele serwerów ns
• 2216 = nieprawidłowa składnia kontaktu technicznego 
• 2247 = nieobsługiwany format NSSET 
• 3228 = brak obsługi pracy z kontaktami
• 3229 = błąd wczytywania kontaktu
• 3242 = NSSET jest niedostępny
• 3244 = utworzenie NSSET nie powiodło się
• 3245 = NSSET jest już zarejestrowany
• 3246 = niedostępny
• 3247 = niedostępny
• 3248 = niedostępny – kwarantanna
• 3249 = niedostępny – zarezerwowany
• 3250 = niedostępny – zablokowany
• 3251 = już zarejestrowany
• 4212 = błąd połączenia
• 4218 = sprawdzenie nie powiodło się – błąd komunikacji
• 4219 = utworzenie nie powiodło się – błąd komunikacji

Dane zwracane

W przypadku powodzenia polecenie zwraca w węźle data:

• nsset – nazwę utworzonego NSSET

Szablony

Żądanie 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"
    }
  }
}

Odpowiedź 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

Użyj polecenia nsset-update , aby zmodyfikować istniejący NSSET. Stary wpis zostanie całkowicie nadpisany, dlatego wprowadź wszystkie dane starannie.

Parametry

• tld – TLD – wymagane
• auth_info – AUTH-ID NSSET – wymagane
• name – nazwa NSSET – wymagane
• dns – lista serwerów ns, każdy wpis serwera zawiera informacje o tym serwerze ns – wymagane
  • serwer – wymagane co najmniej 2
    • name – nazwa domeny serwera – wymagane
    • addr_ipv4 – adres IPv4 – opcjonalne
    • addr_ipv6 – adres IPv6 – opcjonalne
• tech_c – ID kontaktu technicznego – wymagane

Wartości zwracane

• 1000 = OK, NSSET zmodyfikowany
• 2201 = podano nieprawidłowy TLD
• 2209 = błąd składni
• 2210 = nieprawidłowy format listy serwerów dns
• 2211 = zbyt wiele serwerów dns
• 2216 = nieprawidłowa składnia kontaktu
• 2247 = nieprawidłowy NSSET
• 3214 = błąd – nie wczytano NSSET
• 3228 = brak obsługi pracy z kontaktami
• 3229 = błąd wczytywania kontaktu
• 3242 = NSSET nie jest obsługiwany dla tej domeny 
• 3252 = błąd autoryzacji
• 3254 = modyfikacja NSSET nie powiodła się nsset
• 4204 = NSSET jest niedostępny – błąd połączenia
• 4220 = modyfikacja NSSET nie powiodła się – błąd połączenia
• 4212 = kontakt jest niedostępny – błąd połączenia

Dane zwracane

Żądanie nie zwraca żadnych danych.

Szablony

Żądanie JSON:

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

Odpowiedź JSON (OK):

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

---

nsset-transfer

Żądanie nsset-transfer zmienia rejestratora NSSET na WEDOS.

Parametry

• tld – TLD
• name – nazwa NSSET
• auth_info – AUTH-ID NSSET

Wartości zwracane

• 1000 = OK
• 2100 = brak wymaganego parametru
• 2101 = nieprawidłowe parametry wejściowe
• 2201 = nieobsługiwany TLD
• 2209 = błąd składni
• 2215 = brak auth_info
• 2247 = nieprawidłowa nazwa NSSET 
• 2249 = transfer NSSET  nie jest dozwolony dla tego TLD
• 3214 = błąd – nie wczytano NSSET
• 3242 = NSSET nieobsługiwany
• 3251 = NSSET jest już zarejestrowany u tego rejestratora 
• 3255 = błąd autoryzacji
• 3256 = transfer NSSET nie powiódł się
• 4204 = nie wczytano NSSET – błąd połączenia
• 4221 = transfer NSSET nie powiódł się – błąd połączenia

Dane zwracane

Żądanie nie zwraca żadnych danych.

Szablony

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

Odpowiedź JSON (OK):

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

---

nsset-send-auth-info

Żądanie nsset-send-auth-info wysyła AUTH-ID NSSET na adres e-mail kontaktu technicznego NSSET.

Parametry

• tld – TLD
• name – nazwa NSSET

Wartości zwracane

• 1000 = OK, auth_info wysłano na e-mail kontaktu
• 2201 = nieobsługiwany TLD
• 2209 =  błąd składni NSSET
• 2216 = błąd składni kontaktu
• 2243 = dla tego NSSET nie jest dozwolone wysyłanie kodu autoryzacyjnego
• 2247 = nieobsługiwany format NSSET
• 3214 = błąd – odczyt NSSET nie powiódł się
• 3217 = wysłanie kodu autoryzacyjnego nie powiodło się
• 3228 = brak obsługi pracy z kontaktami
• 3229 = odczyt kontaktu nie powiódł się
• 3242 = NSSET jest niedostępny
• 3257 = wysyłanie nie powiodło się, NSSET jest niedostępny
• 4204 = NSSET jest niedostępny – błąd połączenia
• 4212 = kontakt jest niedostępny – błąd połączenia
• 4222 = wysyłanie nie powiodło się – błąd połączenia

Dane zwracane

Żądanie nie zwraca żadnych danych.

Szablony

Żądanie JSON:

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

Odpowiedź JSON (OK):

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