WAPI - Domeny

Ten artykuł zawiera informacje na temat następujących żądań:

• domains-list - lista domen na koncie klienta
• domain-check - sprawdza, czy domena jest dostępna
• domain-create - rejestracja nowej domeny
• domain-info - pobieranie informacji o domenie
• domain-renew - odnowienie domeny
• domain-update-ns - zmiana serwerów DNS domeny
• domain-transfer-check - sprawdź dostępność transferu
• domain-transfer - transfer domeny od innego rejestratora
• domain-send-auth-info - wyślij AUTH-ID domeny
• domain-update-keyset - edycja zestawu kluczy domeny
• domain-tld-period-check - sprawdzenie dostępności okresu

---

lista domen

Żądanie domains-list zwraca listę wszystkich domen na koncie klienta i ich status. Zwraca również nazwy usuniętych domen. Jeśli domena ma przypisane więcej niż jedno zamówienie, żądanie zwróci ją wielokrotnie z odpowiednim statusem (np. usunięta).

Parametry

• status - filtrowanie według statusu (opcjonalne)

Typowe stany domeny obejmują:

• fee_waiting - oczekuje na płatność
• setup_processing - tworzenie w toku
• aktywny
• renew_processing - odnowienie w toku
• wygasły
• wyłączony
• odwołany
• transfer_fee_waiting - oczekiwanie na płatność przelewem
• transfer_processing - transfer od innego rejestratora w toku
• usunięty

Zwracane wartości

• 1000 - OK

Dane odpowiedzi

Polecenie domains-list zwraca listę domen, w której każda domena zawiera następujące wpisy:

• name - nazwa domeny
• status - status domeny

Szablony

Żądanie JSON:

{
  "request": {
    "user": "your@login.tld",
    "auth": "authentication string",
    "command": "domains-list",
    "clTRID": "your ID",
  }
}

Odpowiedź JSON (OK):

{
  "response": {
    "code": 1000,
    "result": "OK",
    "timestamp": "UTF timestamp",
    "clTRID": "your ID",
    "svTRID": "server ID",
    "command": "domains-list",
    "data": {
      "domain": {
        "1": {
          "name": "domain1.tld",
          "status": "status"
         },
         "0": {
          "name": "domain2.tld",
          "status": "status"
        }
      }
    }
  }
}

---

domain-check

Użyj żądania sprawdzenia domeny, aby sprawdzić, czy możemy zarejestrować domenę.

Parametry

• nazwa – nazwa domeny bez www lub wiele domen oddzielonych przecinkami

Zwracane wartości

• 1000 – domena jest dostępna do rejestracji lub żądanie zostało zwrócone (kod odpowiedzi dla żądania z wieloma domenami)
• 3201 - nazwa domeny jest już używana
• 3204 - domena została poddana kwarantannie
• 3205 - domena jest zarezerwowana
• 3206 - nazwa domeny jest zablokowana

Dane odpowiedzi

• name - nazwa domeny
• kod – wartość zwracana dla tej domeny, jest uwzględniana w danych tylko wtedy, gdy żądanie sprawdza wiele domen
• wynik – wartość tekstowa kodu odpowiedzi, jest uwzględniana w danych tylko wtedy, gdy żądanie sprawdza wiele domen

Szablony

Żądanie JSON:

{
  "request": {
    "user": "your@login.tld",
    "auth": "authentication string",
    "command": "domain-check",
    "clTRID": "your ID",
    "data": {
      "name": "your domain without www, or multiple comma-separated domains"
    }
  }
}

Odpowiedź JSON dla pojedynczej domeny (OK):

{
  "response": {
    "code": 1000,
    "result": "OK",
    "timestamp": "UTF timestamp",
    "clTRID": "your ID",
    "svTRID": "server ID",
    "command": "domain-check",
    "data": {
      "name": "your domain without www"
    }
  }
}

Odpowiedź JSON dla wielu domen (OK):

{
  "response": {
    "code": 1000,
    "result": "OK",
    "timestamp": "UTF timestamp",
    "clTRID": "your ID",
    "svTRID": "server ID",
    "command": "domain-check"
    "data":[
        {
          "name":"existing-domain.tld",
          "code":3201,
          "result":"Domain is registered"
        },
        {
          "name":"free-domain.tld",
          "code":1000,
          "result":"OK"
        }
      ]
    }
  }
}

---

domain-create

Użyj żądania domain-create, aby zarejestrować nową domenę. Żądanie jest synchroniczne lub asynchroniczne, w zależności od TLD domeny.

Parametry

• name - nazwa domeny, w tym TLD - wymagane
• okres - liczba lat - wymagany
• dns lub nsset - lista serwerów DNS lub NSSET (tylko domeny CZ) - wymagane
• owner_c - identyfikator kontaktowy właściciela - wymagane
• admin_c - identyfikator kontaktu z administratorem - opcjonalnie
• zasady - imię i nazwisko osoby, która zgodziła się na nasze warunki i warunki rejestru (zazwyczaj właściciela domeny)

Możliwe wartości parametrów dns:

• Pusta wartość parametru dns - użyj wartości domyślnej (serwery DNS WEDOS). Uwaga, nawet jeśli pozostawisz parametr DNS pusty, nadal musisz go określić! Parametr NSSET musi zawsze zawierać wartość (np. WEDOS).
• Własna konfiguracja DNS - nie może być używana dla domen CZ (każdy rekord musi zawierać pole nazwy, opcjonalnie addr_ip4 i addr_ip6, poszczególne serwery są zagnieżdżone w elemencie serwera). Szczegółowe informacje można znaleźć w szablonie.

Zwracane wartości

• 1000 - domena została pomyślnie zarejestrowana
• 1001 - zaakceptowano asynchroniczne żądanie rejestracji
• 3002 - niewystarczające środki na rachunku kredytowym
• 3201 - nazwa domeny jest już używana
• 3204 - domena została poddana kwarantannie
• 3205 - domena jest zarezerwowana
• 3206 - nazwa domeny jest zablokowana
• 2201 - nieobsługiwana TLD
• 2203 - nieprawidłowy okres
• 3221 - tworzenie nie powiodło się
• 4207 - tworzenie nie powiodło się - błąd połączenia

Dane odpowiedzi

Po pomyślnej rejestracji domeny w węźle danych zwracane są następujące elementy:

• num - numer zamówienia
• wygaśnięcie - data wygaśnięcia domeny
• kredyt - stan rachunku kredytowego po zakończeniu operacji
  • kwota - uznanie salda konta
  • waluta - waluta

Szablony

Żądanie JSON z WEDOS NSSET:

{
  "request": {
    "user": "your@login.tld",
    "auth": "authentication string",
    "command": "domain-create",
    "clTRID": "your ID",
    "data": {
      "name": "domain.cz",
      "period": "number of years",
      "nsset": "WEDOS",
      "owner_c": "owner contact ID",
      "admin_c": "admin contact ID",
      "rules": {
        "fname": "Name",
        "lname": "Surname"
      }
    }
  }
}

Żądanie JSON z własnym DNS:

{
  "request": {
    "user": "your@login.tld",
    "auth": "authentication string",
    "command": "domain-create",
    "clTRID": "your ID",
    "data": {
      "name": "domain.tld",
      "period": "number of years",
      "dns": {
        "server1":
          {
            "name": "ns1.dns-provider.tld"
          },
        "server2":
          {
            "name": "ns2.dns-provider.tld"
          }
        }
      },
      "owner_c": "domain owner contact ID",
      "admin_c": "domain admin contact ID",
      "rules": {
        "fname": "Name",
        "lname": "Surname"
      }
    }
  }
}

Odpowiedź JSON (OK):

{
  "response": {
    "code": 1000,
    "result": "OK",
    "timestamp": "UTF timestamp",
    "clTRID": "your ID",
    "svTRID": "server ID",
    "command": "domain-create",
    "data": {
      "num": "order number",
      "expiration": "YYYY-MM-DD"
    }
  }
}

---

domena-info

Użyj żądania domain-info, aby uzyskać informacje o określonej domenie.

Parametry

• name - nazwa domeny, w przypadku wielu domen należy użyć ciągu oddzielonego przecinkami (patrz szablon) - wymagane

Zwracane wartości

• 1000 - komenda powiodła się, dane elementu zawierają informacje o domenie
• 3222 - nie udało się pobrać obiektu domeny 
• 3216 - nie udało się pobrać informacji o domenie
• 3223 - domena nie należy do konta klienta
• 4205 - błąd związany z rejestrem

Dane odpowiedzi

Ten element danych zawiera informacje o domenie, jeśli się powiedzie. Konkretne dane zależą od typu domeny i innych okoliczności. Oto najważniejsze z nich:

• name - nazwa domeny
• status - status domeny
• owner_c - identyfikator właściciela domeny
• setup_date - data utworzenia
• wygaśnięcie - data wygaśnięcia
• dns lub NSSET - lista serwerów DNS lub NSSET
• elementy z prefiksem own_ - informacje o właścicielu domeny

Niektóre informacje o domenie lub jej właścicielu mogą być ukryte; w takim przypadku mają wartość HIDDEN.

Szablony

Żądanie JSON z 2 domenami:

{
  "request": {
    "user": "your@login.tld",
    "auth": "authentication string",
    "command": "domain-info",
    "clTRID": "your ID",
    "data": {
      "name": "domain.name1, domain.name2"
    }
  }
}

Odpowiedź JSON (domena.nazwa1 OK, domena.nazwa2 błąd):

{
  "response": {
    "code": 1000,
    "result": "OK",
    "timestamp": "UTF timestamp",
    "clTRID": "your ID",
    "svTRID": "server ID",
    "command": "domain-info",
    "data": {
      "domain": [{
        "name": "domain.name1",
        "status": "status",
        "owner_c": "owner ID",
        "nsset": "WEDOS",
        "reg_owner": "",
        "reg_creator": "",
        "setup_date": "YYYY-MM-DD",
        "expiration": "YYYY-MM-DD",
        "reg_update": "",
        "updated_date": "",
        "transfer_date": "",
        "dns": {
          "server1":
            {
              "name": "ns1.server-provider.tld"
            },
          "server2":
            {
              "name": "ns1.server-provider.tld"
            }
          }
        },
        "own_company": "",
        "own_name": "",
        "own_lname": "",
        "own_fname": "",
        "own_email": "",
        "own_email2": "",
        "own_phone": "",
        "own_fax": "",
        "own_ic": "",
        "own_dic": "",
        "own_taxpayer": "",
        "own_addr_street": "",
        "own_addr_city": "",
        "own_addr_zip": "",
        "own_addr_country": "",
        "own_addr_state": "",
        "admin_c": "",
        "own_other": {
          "notify_email": "",
          "ident_type": "",
          "ident": ""
        }
      },
      {
        "name": "domain.name2",
        "code": 3222,
        "result": "Domain open failed"
      }]
    }
  }
}

---

odnowienie domeny

Żądanie odnowienia domeny umożliwia odnowienie domeny, która nie ma jeszcze zamówionego odnowienia.

Parametry

• name - nazwa domeny - wymagane
• okres - liczba lat do odnowienia - wymagany

Zwracane wartości

• 1000 - Domena została pomyślnie odnowiona
• 2203 - Nieprawidłowy okres odnowienia
• 2269 - żądanie odnowienia już istnieje

Dane odpowiedzi

Jeśli polecenie się powiedzie, zwrócona zostanie nowa data wygaśnięcia.

• wygaśnięcie - data wygaśnięcia nowej domeny

Szablony

Żądanie JSON:

{
  "request": {
    "user": "your@login.tld",
    "auth": "authentication string",
    "command": "domain-renew",
    "clTRID": "your ID",
    "data": {
      "name": "your domain name without www",
      "period": "number of years"
    }
  }
}

Odpowiedź JSON (OK):

{
  "response": {
    "code": 1000,
    "result": "OK",
    "timestamp": "UTF timestamp",
    "clTRID": "your ID",
    "svTRID": "server ID",
    "command": "domain-renew",
    "data": {
      "expiration": "YYYY-MM-DD"
    }
  }
}

---

domain-update-ns

Użyj żądania domain-update-ns, aby zmienić serwery DNS domeny lub NSSET.

Parametry

• name - nazwa domeny - wymagane
• dns lub nsset - serwery DNS lub NSSET dla domen CZ - wymagane

Możliwe wartości parametrów dns:

• Pusta wartość parametru dns - użyj wartości domyślnej (serwery DNS WEDOS). Uwaga, nawet jeśli pozostawisz parametr DNS pusty, nadal musisz go określić! Parametr NSSET musi zawsze zawierać wartość (np. WEDOS).
• Własna konfiguracja DNS - nie może być używana dla domen CZ (każdy rekord musi zawierać pole nazwy, opcjonalnie addr_ip4 i addr_ip6, poszczególne serwery są zagnieżdżone w elemencie serwera). Szczegółowe informacje można znaleźć w szablonie.

Zwracane wartości

• 1000 - Serwery DNS ustawione pomyślnie 
• 2209 - nieprawidłowy format NSSET (dla domen CZ)
• 2210 - nieprawidłowy format serwera DNS

Dane odpowiedzi

Żądanie nie zwraca żadnych danych.

Szablony

Żądanie JSON:

{
  "request": {
    "user": "your@login.tld",
    "auth": "authentication string",
    "command": "domain-update-ns",
    "clTRID": "your ID",
    "data": {
      "name": "domain.tld",
      "dns": {
        "server1":
          {
            "name": "ns1.own-dns-server.tld"
          },
        "server2":
          {
            "name": "ns1.own-dns-server.tld"
          }
        }
      }
    }
  }  
}

Odpowiedź JSON (OK):

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

---

domain-transfer-check

Użyj żądania domain-transfer-check, aby sprawdzić, czy domena może zostać przeniesiona od innego rejestratora do nas.

Parametry

• name - nazwa domeny bez www - wymagane

Zwracane wartości

Żądanie zazwyczaj zwraca następujące wartości:

• 1000 - Transfer jest możliwy
• 3217 - Nie udało się nawiązać połączenia z rejestrem
• 3218 - Transfer nie jest możliwy

Dane odpowiedzi

Żądanie nie zwraca żadnych danych.

Szablony

Żądanie JSON:

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

JSON odpověď (OK):

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

---

transfer domeny

Użyj żądania transferu domeny, aby przenieść domenę od innego rejestratora do WEDOS.

Żądanie jest synchroniczne tylko dla domen CZ i EU, tj. dla nich, jeśli AUTH-ID jest poprawny, transfer jest wykonywany natychmiast i od razu znasz wynik. W przypadku innych domen transfery są asynchroniczne, więc wynik zostanie podany w powiadomieniu.

Parametry

• name - nazwa domeny bez www - wymagane
• auth_info - AUTH-ID domeny - wymagane
• owner_c - identyfikator właściciela domeny - wymagany tylko dla niektórych rejestrów (SK, EU, gTLD)
• dns - konfiguracja serwera DNS domeny - opcjonalna; dostępna tylko dla rejestrów, które ją obsługują (EU, gTLD)
• zasady - imię i nazwisko osoby, która zgodziła się na nasze warunki i warunki rejestru (zazwyczaj właściciela domeny) - wymagane

Dostępne wartości parametru dns:

• Pominięcie parametru DNS - domena zachowa bieżące ustawienia serwera DNS. Podczas transferu bieżące serwery DNS zostaną rozwiązane. Jeśli nie można rozwiązać bieżących serwerów DNS, transfer może spowodować błąd (gTLD).
• Pusty parametr DNS - system podejmie próbę ustawienia domyślnych serwerów DNS WEDOS.
• Parametr DNS z serwerami - system spróbuje ustawić te serwery DNS.

Zwracane wartości

• 1000 - Domena została pomyślnie przeniesiona
• 1001 - Żądanie transferu zostało zaakceptowane, oczekuje na realizację.
• 2100 - Brakujący wymagany parametr
• 2101 - Nieprawidłowa wartość parametru
• 2201 - Nieprawidłowa TLD
• 2202 - Nieprawidłowy format nazwy domeny
• 2204 - Nie określono identyfikatora kontaktu właściciela domeny
• 2207 - Nieprawidłowy identyfikator kontaktu właściciela domeny
• 2210 - Nieprawidłowy format serwera DNS
• 2215 - AUTH-ID nie został określony i jest wymagany dla tej domeny.
• 2245 - Brak zgody
• 2246 - Błąd danych zgody
• 2252 - Przekroczono liczbę żądań domeny
• 2263 - AUTH-ID jest krótszy niż wymagana minimalna długość
• 2271 - Nieprawidłowy format AUTH-ID
• 3001 - Nieprawidłowa waluta rachunku kredytowego
• 3003 - Nieprawidłowe informacje rozliczeniowe konta kredytowego
• 3207 - Domena jest już u nas zarejestrowana
• 3208 - Transfer nie powiódł się z powodu błędu daty wygaśnięcia
• 3217 - Nie można nawiązać połączenia z rejestrem
• 3218 - Transfer niemożliwy
• 3219 - Już oczekujące żądanie transferu dla tej domeny
• 3220 - Domena jest już zarejestrowana w naszym rejestrze
• 3226 - transfer domeny nie powiódł się
• 3227 - Błąd autoryzacji w rejestrze domen
• 3258 - Przestój rejestru
• 3266 - Nie można przenieść, ponieważ domena wygasła
• 3267 - Nie udało się rozpoznać autorytatywnych serwerów DNS
• 4002 - Nie udało się odliczyć kredytu od rachunku kredytowego
• 4003 - Nie udało się utworzyć okresu rozliczeniowego
• 4206 - Nie udało się ustalić, czy domena może zostać przeniesiona - błąd połączenia
• 4209 - Nie udało się określić typu transferu (z / bez odnowienia)
• 5001 - Wewnętrzny błąd logowania
• 5002 - Nie udało się obliczyć ceny transferu
• 5004 - Przestój w rozliczeniach

Dane odpowiedzi

• num - numer zamówienia
• wygaśnięcie - data wygaśnięcia domeny

Szablony

Żądanie JSON:

{
  "request": {
    "user": "your@login.tld",
    "auth": "authentication string",
    "command": "domain-transfer",
    "clTRID": "your ID",
    "data": {
      "name": "domain.tld",
      "auth_info": "AUTH-ID",
      "dns": {
        "server1":
          {
            "name": "ns1.mydns.tld"
          },
        "server2":
          {
            "name": "ns2.mydns.tld"
          }
        }
      },
      "rules": {
        "fname": "Name",
        "lname": "Surname"
      }
   }
}

Odpowiedź JSON (OK):

{
  "response": {
    "code": 1000,
    "result": "OK",
    "timestamp": "UTF timestamp",
    "clTRID": "your ID",
    "svTRID": "server ID",
    "command": "domain-transfer",
    "data": {
      "num": "order number",
      "expiration": "YYYY-MM-DD"
    }
  }
}

---

domain-send-auth-info

Użyj żądania domain-send-auth-info, aby wysłać AUTH-ID domeny na adres e-mail właściciela domeny.

Parametry

• name - nazwa domeny - wymagane

Zwracane wartości

• 1000 - AUTH-ID jest wysyłany na adres e-mail właściciela domeny 
• 2243 - Niedozwolone wysyłanie auth_info
• 3209 - Nie udało się wysłać auth_info
• 3210 - Nie udało się wysłać auth_info - domena jest niedostępna
• 3222 - Nie udało się pobrać domeny
• 3223 - Domena nie należy do tego konta klienta
• 4214 - Nie udało się wysłać auth_info - błąd połączenia - spróbuj ponownie później

Dane odpowiedzi

Żądanie nie zwraca żadnych danych.

Szablony

Żądanie JSON:

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

Odpowiedź JSON (OK):

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

---

domain-update-keyset

Żądanie domain-update-keyset umożliwia wprowadzenie zmian w ustawieniach KEYSET dla domeny, tj. włączenie, wyłączenie lub aktualizację ustawień DNSSEC.

Parametry

• name - nazwa domeny - wymagane
• keyset - ustawienia KEYSET - wymagane
  0 = brak KEYSET / wyłącz DNSSEC
  1 = nasz KEYSET / nasz DNSSEC (jeśli domena korzysta z naszych serwerów DNS i jest ustawiona jako podstawowa)
  string = nazwa własnego KEYSET (jeśli domena nie korzysta z naszych serwerów DNS lub jest ustawiona jako drugorzędna)

Zwracane wartości

• 1000 = OK
• 2202 = nieprawidłowa lub nieobsługiwana nazwa istniejącej domeny
• 2264 = nieprawidłowa nazwa KEYSET
• 2265 = brak obsługi DNSSEC
• 2266 = nieobsługiwana akcja dla domeny dodatkowej
• 2267 = nieobsługiwana akcja dla domeny podstawowej
• 3260 = oczekujące zlecenie DNSSEC już istnieje
• 3258 = trwa przestój rejestru
• 3263 = domena nie używa naszego DNS
• 3222 = otwarcie domeny nie powiodło się
• 3223 = odmowa dostępu
• 3259 = KEYSET jest niedostępny
• 3262 = Konfiguracja DNSSEC nie powiodła się
• 3264 = KEYSET jest zablokowany

Dane zwrotne

Żądanie nie zwraca żadnych danych.

Szablony

Żądanie JSON:

{
  "request": {
    "user": "your@login.tld",
    "auth": "authentication string",
    "command": "domain-update-keyset",
    "clTRID": "your ID",
    "data": {
      "name": "domain name",
      "keyset": "0/1/string",
    }
  }
}

Odpowiedź JSON (OK):

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

---

domain-tld-period-check

Użyj żądania domain-tld-period-check, aby sprawdzić, czy można ustawić określony okres rejestracji dla TLD.

Parametry

• tld - TLD
• okres - liczba lat

Zwracane wartości

• 1000 - okres może być użyty dla tej domeny
• 2203 -period nie może być użyty dla tej domeny

Dane odpowiedzi

Żądanie nie zwraca żadnych danych.

Szablony

JSON příkaz:

{
  "request": {
    "user": "your@login.tld",
    "auth": "authentication string",
    "command": "domain-tld-period-check",
    "clTRID": "your ID",
    "data": {
      "tld": "domain tld",
      "period": "number of years"
    }
  }
}

Odpowiedź JSON (OK):

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