Ten artykuł dotyczy poleceń WAPI specjalnie dla usługi WEDOS DNS (NSSET). Aby uzyskać informacje na temat konfigurowania WAPI i rozwiązywania typowych problemów, zobacz artykuł WAPI - Podręcznik.
Ten samouczek dotyczy poleceń WAPI dla NSSET, który jest używany tylko przez domeny CZ. Instrukcje dotyczące DNS można znaleźć w artykule WAPI - DNS.
Ten artykuł zawiera informacje na temat następujących żądań:
- nsset-check - sprawdzenie dostępności NSSET
- nsset-info - informacje o NSSET
- nsset-create - tworzenie zestawu NSSET
- nsset-update - aktualizacja NSSET
- nsset-transfer - transfer NSSET od innego rejestratora
- nsset-send-auth-info - wyślij NSSET AUTH-ID
nsset-check
Użyj żądania nsset-check, aby sprawdzić, czy nazwa NSSET jest wolna do rejestracji lub jest w innym stanie.
Parametry
- tld - domena TLD
- name - nazwa NSSET
Zwracane wartości
- 1000 = NSSET jest dostępny do rejestracji
- 2201 = nieprawidłowa 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 zwrotne
Żą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 żądania nsset-info, aby pobrać informacje o NSSET.
Parametry
- tld - TLD
- name - nazwa NSSET
Zwracane wartości
- 1000 = OK
- 2201 = nieprawidłowa TLD
- 2209 = błąd składni
- 2247 = nieobsługiwany format NSSET
- 3214 = błąd - NSSET nie został załadowany
- 3242 = NSSET jest niedostępny
- 4204 = błąd połączenia, spróbuj ponownie później
Dane zwrotne
W przypadku powodzenia, żądanie zwraca element nsset w węźle danych z następującymi wpisami:
- name - nazwa NSSET
- status - status
- reg_owner - bieżący rejestrator
- reg_creator - twórca NSSET (rejestrator)
- reg_update - rejestrator, który dokonał ostatniej aktualizacji
- created_date - data utworzenia
- updated_date - data ostatniej aktualizacji
- transfer_date - data przeniesienia 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 żądania nsset-create, aby utworzyć nowy zestaw NSSET. NSSET zawiera listę serwerów NS, każdy serwer zawiera wpis nazwy i ewentualnie adres IP. Możesz także 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
- serwer
- tech_c - kontakt techniczny - opcjonalnie
Zwracane wartości
- 1000 = OK, utworzono NSSET
- 2201 = wprowadzono nieprawidłową TLD
- 2210 = nieprawidłowy format serwerów ns
- 2211 = za dużo serwerów ns
- 2216 = nieprawidłowa składnia w kontakcie technicznym
- 2247 = nieobsługiwany format NSSET
- 3228 = nie obsługuje pracy z kontaktami
- 3229 = błąd ładowania styku
- 3242 = NSSET jest niedostępny
- 3244 = Tworzenie 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 = kontrola nie powiodła się - błąd komunikacji
- 4219 = tworzenie nie powiodło się - błąd komunikacji
Dane zwrotne
Jeśli się powiedzie, polecenie w węźle danych zostanie zwrócone:
- nsset - nazwa utworzonego zestawu 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 żądania nsset-update, aby zmodyfikować istniejący NSSET. Stary wpis zostanie całkowicie nadpisany, więc wszystkie dane należy wprowadzać ostrożnie.
Parametry
- tld - TLD
- name - nazwa NSSET
- dns - lista serwerów ns, każdy wpis serwera zawiera informacje o tym serwerze ns
- serwer
- name - nazwa domeny serwera
- addr_ipv4 - adres IPv4
- addr_ipv6 - adres IPv6
- serwer
- tech_c - identyfikator kontaktu technicznego - opcjonalnie
Zwracane wartości
- 1000 = OK, zmodyfikowano NSSET
- 2201 = wprowadzono nieprawidłową 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 w kontakcie
- 2247 = nieprawidłowy NSSET
- 3214 = błąd - NSSET nie został załadowany
- 3228 = nie obsługuje pracy z kontaktami
- 3229 = błąd ładowania styku
- 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 zwrotne
Żą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",
"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-update" } }
nsset-transfer
Żądanie nsset-transfer zmienia rejestratora NSSET na WEDOS.
Parametry
- tld - TLD
- name - nazwa NSSET
- auth_info - NSSET AUTH-ID
Zwracane wartości
- 1000 = OK
- 2100 = brak wymaganego parametru
- 2101 = nieprawidłowe parametry wejściowe
- 2201 = nieobsługiwana TLD
- 2209 = błąd składni
- 2215 = brak auth_info
- 2247 = nieprawidłowa nazwa NSSET
- 2249 = transfer NSSET nie jest dozwolony dla tej TLD
- 3214 = błąd - NSSET nie został załadowany
- 3242 = NSSET nie jest obsługiwany
- 3251 = NSSET jest już zarejestrowany u tego rejestratora
- 3255 = błąd autoryzacji
- 3256 = transfer NSSET nie powiódł się
- 4204 = NSSET nie został załadowany - błąd połączenia
- 4221 = transfer NSSET nie powiódł się - błąd połączenia
Dane zwrotne
Żą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 NSSET AUTH-ID na adres e-mail kontaktu technicznego NSSET.
Parametry
- tld - TLD
- name - nazwa NSSET
Zwracane wartości
- 1000 = OK, auth_info wysłane na kontaktowy adres e-mail
- 2201 = nieobsługiwana TLD
- 2209 = błąd składni NSSET
- 2216 = błąd składni kontaktu
- 2243 = dla tego NSSET nie jest dozwolone wysyłanie kodu autoryzacji
- 2247 = nieobsługiwany format NSSET
- 3214 = błąd - odczyt NSSET nie powiódł się
- 3217 = wysłanie kodu autoryzacji nie powiodło się
- 3228 = nie obsługuje pracy z kontaktami
- 3229 = odczyt kontaktu nie powiódł się
- 3242 = NSSET jest niedostępny
- 3257 = wysyłanie nie powiodło się, NSSET nie jest dostępny
- 4204 = NSSET nie jest dostępny - połączenie nie powiodło się
- 4212 = kontakt jest niedostępny - połączenie nie powiodło się
- 4222 = wysyłanie nie powiodło się - połączenie nie powiodło się
Dane zwrotne
Żą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" } }