WAPI - Kontakty domenowe

W tym artykule znajdziesz informacje na temat zarządzania kontaktami domen z następującymi obsługiwanymi domenami TLD:

• CZ
• UE
• SK
• PL
• gTLD a nTLD

a także na następujące polecenia:

• contact-check - sprawdź dostępność kontaktu
• contact-info - lista informacji kontaktowych
• contact-create - tworzenie nowego kontaktu
• contact-update - edycja danych kontaktowych
• contact-transfer - przeniesienie kontaktu od innego rejestratora
• contact-send-auth-info - wyślij AUTH-ID kontaktu

---

Kontakty w sprawie domen według poszczególnych rejestrów

Każdy rejestr domen zarządza kontaktami w inny sposób, istnieją różne zasady dotyczące identyfikatorów kontaktów, obowiązkowych elementów w szczegółach i tak dalej.

Domeny CZ

Podczas tworzenia kontaktu dla domeny CZ można określić nazwę. Użyj opcji contact-check, aby sprawdzić, czy wybrana nazwa jest dostępna (nieużywana, zablokowana, ..).

Nazwa kontaktu może zawierać tylko wielkie litery alfabetu angielskiego, cyfry i myślnik. Jeśli nie określisz nazwy podczas tworzenia kontaktu, system wygeneruje ją automatycznie.

W szczegółach kontaktu można ustawić:

• cname - nazwa kontaktu (tylko podczas tworzenia nowego); pomiń ten parametr lub pozostaw pusty, aby wygenerować pseudolosową nazwę)
• firma
• fname - nazwa - wymagane
• lname - nazwisko - wymagane
• e-mail - wymagany
• telefon - numer telefonu +XXX XXXXXXXXX
• faks - numer faksu +XXX XXXXXXXXX
• dic - identyfikator VAT
• addr_street - adres ulicy i numer domu - wymagane
• addr_city - adres miasta - wymagane
• addr_zip - kod pocztowy - wymagane
• addr_country - kraj (dwuliterowy kod ISO, małe litery) - wymagane
• addr_state - państwo lub region
• ident_type - typ dokumentu tożsamości (ico (identyfikator firmy), op (identyfikator osobisty), birthday (data urodzenia w formacie DD.MM.RRRR), paszport, mpsv (identyfikator MPSV))
• ident - numer dokumentu tożsamości (w zależności od ident_type)
• notify_email - adres e-mail powiadomienia
• disclose_phone - ukryj telefon
• disclose_fax - ukryj faks
• disclose_email - ukryj adres e-mail
• disclose_ident - ukrywa numer dokumentu tożsamości
• disclose_notify_email - ukrywa wiadomość e-mail z powiadomieniem

W przypadku kontaktów w domenie CZ możliwe jest ukrycie niektórych elementów w szczegółach kontaktu. Użyj wpisów disclose_* w szczegółach kontaktu z flagą 0/1 (1 = ukryte, 0 = publiczne), aby określić, czy te informacje powinny być ukryte. Jeśli te informacje są oznaczone jako ukryte, nie można ich przeglądać bez autoryzacji.

Od połowy stycznia 2018 r. można ustawić adres dostawy dla kontaktów w domenie CZ. Podczas tworzenia/edycji kontaktu należy wprowadzić następujące elementy:

• del_addr=1 - aktywny adres dostawy (wymagany)
• del_addr_street1 - ulica (wymagane)
• del_addr_street2 - ulica (opcjonalnie)
• del_addr_street3 - ulica (opcjonalnie)
• del_addr_city - miasto (wymagane)
• del_addr_state - stan lub region
• del_addr_country - kraj (dwuliterowy kod ISO, małe litery) (wymagane)

Aby dezaktywować adres dostawy dla kontaktu, wprowadź del_addr=0 podczas tworzenia/edycji kontaktu.

Domeny UE

Podczas tworzenia kontaktu w rejestrze EURid nie można określić jego nazwy. System zawsze przypisuje ją automatycznie.

W szczegółach kontaktu można ustawić:

• firma
• fname - nazwa - wymagane
• lname - nazwisko - wymagane
• e-mail - wymagany
• telefon - numer telefonu +XXX XXXXXXXXX
• faks - numer faksu +XXX XXXXXXXXX
• dic - identyfikator VAT
• addr_street - adres ulicy i numer domu - wymagane
• addr_city - adres miasta - wymagane
• addr_zip - kod pocztowy - wymagane
• addr_country - kraj (dwuliterowy kod ISO, małe litery) - wymagane
• addr_state - państwo lub region

Domeny SK

Podczas tworzenia kontaktu dla domeny SK można określić nazwę. Użyj opcji contact-check, aby sprawdzić, czy wybrana nazwa jest dostępna (nieużywana, zablokowana, ..).

Nazwa kontaktu może zawierać tylko wielkie litery alfabetu angielskiego, cyfry, myślniki i kropki. Minimalna długość nazwy kontaktu wynosi 5 znaków, a maksymalna 16 znaków. Jeśli nazwa nie zostanie określona podczas tworzenia kontaktu, system wygeneruje ją automatycznie. Format automatycznie wygenerowanej nazwy kontaktu to WEDOS-XXX-YYYY (gdzie XXX to kombinacja liter i cyfr, a YYYY to tylko cyfry).

W szczegółach kontaktu można ustawić:

• cname - nazwa kontaktu (tylko podczas tworzenia nowego); pomiń ten parametr lub pozostaw pusty, aby wygenerować pseudolosową nazwę)
• firma
• fname - nazwa - wymagane
• lname - nazwisko - wymagane
• e-mail - wymagany
• telefon - numer telefonu +XXX XXXXXXXXX
• faks - numer faksu +XXX XXXXXXXXX
• dic - identyfikator VAT
• addr_street - adres ulicy i numer domu - wymagane
• addr_city - adres miasta - wymagane
• addr_zip - kod pocztowy - wymagane
• addr_country - kraj (dwuliterowy kod ISO, małe litery) - wymagane
• addr_state - państwo lub region
• ident_type - typ podmiotu, może być ustawiony tylko raz(PERS = osoba fizyczna, CORP = firma)
• ident - wartość identyfikacyjna(PERS = data urodzenia w formacie RRRR-MM-DD, CORP = identyfikator firmy)
• disclose_name - ukryj nazwę
• disclose_org - ukryj nazwę firmy
• disclose_addr - ukrywa adres reklamowy
• disclose_phone - ukryj telefon
• disclose_fax - ukryj faks
• disclose_email - ukryj adres e-mail

Domeny PL

Podczas tworzenia kontaktu PL nie można określić jego nazwy. System zawsze przypisuje ją automatycznie.

W szczegółach kontaktu można ustawić:

• firma
• fname - nazwa, nie może być zmieniona dla legal_type = individual - wymagane
• lname - nazwisko, nie można zmienić dla legal_type = individual - wymagane
• e-mail - wymagany
• telefon - numer telefonu +XXX XXXXXXXXX
• faks - numer faksu +XXX XXXXXXXXX
• dic - identyfikator VAT
• addr_street - adres ulicy i numer domu - wymagane
• addr_city - adres miasta - wymagane
• addr_zip - kod pocztowy - wymagane
• addr_country - kraj (dwuliterowy kod ISO, małe litery) - wymagane
• addr_state - państwo lub region
• legal_type - typ prawny (firma, osoba fizyczna), nie można zmienić - wymagane

Domeny gTLD i nTLD

Podczas tworzenia kontaktu dla domen gTLD i nTLD nie można określić jego nazwy, system tworzy go automatycznie.

W szczegółach kontaktu można ustawić:

• firma
• fname - nazwa - wymagane
• lname - nazwisko - wymagane
• e-mail - wymagany
• telefon - numer telefonu +XXX XXXXXXXXX
• faks - numer faksu +XXX XXXXXXXXX
• dic - identyfikator VAT
• addr_street - adres ulicy i numer domu - wymagane
• addr_city - adres miasta - wymagane
• addr_zip - kod pocztowy - wymagane
• addr_country - kraj (dwuliterowy kod ISO, małe litery) - wymagane
• addr_state - państwo lub region

---

contact-check

Użyj żądania sprawdzenia kontaktu, aby zweryfikować dostępność nazwy kontaktu.

Parametry

• tld - TLD do utworzenia kontaktu (np. eu)
• cname - nazwa kontaktu

Zwracane wartości

• 1000 - kontakt jest bezpłatny i może być używany
• 2201 - nieprawidłowa TLD
• 2216 - nieprawidłowy format kontaktu
• 2218 - nazwa jest generowana automatycznie (dla niektórych TLD nie można określić nazwy kontaktu)
• 3231 - kontakt już istnieje
• 3233 - kontakt nie może być użyty
• 3234 - kontakt nie może być użyty - w kwarantannie
• 3235 - kontakt nie może być użyty - zarezerwowane
• 3236 - kontakt nie może być użyty - zablokowany
• 4211 - weryfikacja nie powiodła się - błąd komunikacji, powtórz polecenie później

Dane odpowiedzi

Żądanie nie zwraca żadnych danych.

Szablony

Żądanie JSON:

{
  "request": {
    "user": "your@login.tld",
    "auth": "authentication string",
    "command": "contact-check",
    "clTRID": "your ID",
    "data": {
      "tld": "tld",
      "cname": "contact id"
    }
  }
}

Odpowiedź JSON (OK):

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

---

contact-info

Polecenie contact-info zwraca szczegółowe informacje o kontakcie.

Parametry

• tld - TLD
• cname - nazwa kontaktu
• auth_info - AUTH-ID kontaktu - opcjonalne (jeśli domena to obsługuje, wprowadzenie AUTH-ID ujawni ukryte dane kontaktu)

Zwracane wartości

• 1000 - pomyślnie odebrano informacje kontaktowe
• 2201 - nieprawidłowa TLD
• 2216 - nieprawidłowa składnia kontaktu 
• 3228 - nieobsługiwana wartość
• 3229 - błąd ładowania kontaktu
• 4212 - błąd połączenia

Dane odpowiedzi

W przypadku powodzenia (kod 1000) polecenie zwraca informacje o kontakcie w węźle kontaktów.

Szablony

Żądanie JSON:

{
  "request": {
    "user": "your@login.tld",
    "auth": "authentication string",
    "command": "contact-info",
    "clTRID": "your ID",
    "data": {
      "tld": "cz",
      "cname": "contact id"
    }
  }
}

Odpowiedź JSON (OK):

{
  "response": {
    "code": 1000,
    "result": "OK",
    "timestamp": "UTF timestamp",
    "clTRID": "your ID",
    "svTRID": "server ID",
    "command": "contact-info",
    "data": {
      "contact": {
        "contact_id": "contact id",
        "status": "status",
        "name": "name and surname",
        "company": "company",
        "addr_street": "street and number",
        "addr_city": "city",
        "addr_zip": "zip code",
        "addr_state": "state or region",
        "addr_country": "country iso code",
        "phone": "full phone number",
        "email": "email",
        "fax": "full fax number",
        "reg_owner": "",
        "reg_creator": "",
        "reg_update": "",
        "created_date": "YYYY-MM-DD hh:mm:ss",
        "updated_date": "YYYY-MM-DD hh:mm:ss",
        "transfer_date": "YYYY-MM-DD hh:mm:ss",
        "fname": "name",
        "lname": "surname",
        "email2": "",
        "ic": "company id",
        "dic": "vat id",
        "taxpayer": "",
        "disclose": "",
        "other": {
          "notify_email": "",
          "ident_type": "",
          "ident": ""
        }
      }
    }
  }
}

---

contact-create

Użyj żądania contact-create, aby utworzyć nowy kontakt, którego możesz używać z domenami zarejestrowanymi w odpowiednim rejestrze. Każdy kontakt jest identyfikowany przez jego nazwę, która jest zawsze unikalna. Więcej informacji na temat pracy z kontaktami z poszczególnych rejestrów można znaleźć w rozdziale Kontakty domen według poszczególnych rejestrów.

Parametry

• tld - domena TLD
• kontakt - tablica elementów kontaktu:
  • cname - nazwa kontaktu (pusta = generowana automatycznie)
  • fname - nazwa
  • lname - nazwisko
  • spółka - spółka
  • addr_street - ulica i numer domu
  • addr_city - miasto
  • addr_zip - kod pocztowy
  • addr_state - państwo lub region
  • addr_country - kraj (dwuliterowy kod ISO, małe litery)
  • telefon
  • faks
  • e-mail
  • inne elementy w zależności od rejestru

Zwracane wartości

• 1000 = kontakt został pomyślnie utworzony
• 2201 = nieprawidłowy tld
• 2216 = nieprawidłowa nazwa kontaktu
• 2218 = nazwa kontaktu jest tworzona automatycznie
• 2219 = pozycja niewypełniona przez firmę
• 2220 = nazwa elementu nie jest wypełniona
• 2221 = niewypełnione nazwisko 
• 2222 = adres e-mail nie został wypełniony 
• 2223 = nieprawidłowy format wiadomości e-mail
• 2224 = email2 nie wypełniony
• 2225 = nieprawidłowy format email2
• 2226 = telefon niewypełniony
• 2227 = nieprawidłowy format telefonu
• 2228 = faks niewypełniony
• 2229 = nieprawidłowy format faksu 
• 2230 = identyfikator firmy nie został wypełniony 
• 2231 = nieprawidłowy format identyfikatora firmy
• 2232 = niewypełniony numer VAT
• 2233 = nieprawidłowy format numeru VAT
• 2234 = ulica niewypełniona
• 2235 = miasto niewypełnione
• 2236 = niewypełniony ZIP
• 2237 = kraj niewypełniony
• 2238 = nieprawidłowy format kraju
• 2239 = stan niewypełniony
• 2240 = inne niewypełnione dane
• 2241 = inny nieprawidłowy format danych 
• 3228 = domena nie działa z kontaktami
• 3230 = nie udało się utworzyć kontaktu
• 3231 = nazwa kontaktu jest już używana
• 3232 = kontakt nie może być użyty - przyczyna nieznana
• 3233 = kontakt nie może być użyty
• 3234 = kontakt nie może być użyty - poddany kwarantannie
• 3235 = kontakt nie może być użyty - zarezerwowane
• 3236 = kontakt nie może być użyty - zablokowany
• 3237 = kontakt jest już u nas zarejestrowany
• 4211 = nie udało się sprawdzić kontaktu - błąd komunikacji
• 4213 = nie udało się utworzyć kontaktu - błąd komunikacji

Dane odpowiedzi

Kontakt zwraca następujące dane:

• cname - nazwa utworzonego kontaktu

Szablony

Żądanie JSON:

{
  "request": {
    "user": "your@login.tld",
    "auth": "authentication string",
    "command": "contact-create",
    "clTRID": "your ID",
    "data": {
      "tld": "cz",
      "contact": {
        "fname": "name",
        "lname": "surname",
        "email": "email",
        "addr_street": "street and number",
        "addr_city": "city",
        "addr_zip": "zip code",
        "addr_country": "country ISO code",
        "phone": "full phone number",
        "notify_email": "notification email"
      }
    }
  }
}

Odpowiedź JSON (OK):

{
  "response": {
    "code": 1000,
    "result": "OK",
    "timestamp": "UTF timestamp",
    "clTRID": "your ID",
    "svTRID": "server ID",
    "command": "contact-create",
    "data": {
      "cname": "contact id"
    }
  }
}

---

contact-update

Użyj żądania aktualizacji kontaktu, aby edytować wpisy kontaktów.

Więcej informacji na temat pracy z kontaktami z poszczególnych rejestrów można znaleźć w rozdziale Kontakty z domenami według poszczególnych rejestrów.

Parametry

• tld - TLD
• cname - nazwa kontaktu
• auth_info - AUTH-ID
• kontakt - pozycje kontaktowe
  • fname - nazwa
  • lname - nazwisko
  • firma
  • addr_street - ulica i numer
  • addr_city - miasto
  • addr_zip - kod pocztowy
  • addr_state - państwo lub region
  • addr_country - kraj (dwuliterowy kod ISO, małe litery)
  • telefon
  • faks
  • e-mail
  • inne pozycje zgodnie z rejestrem

Zwracane wartości

• 1000 = OK
• 2201 = nieprawidłowa TLD
• 2207 = nieprawidłowa składnia w nazwie kontaktu
• 2216 = nieprawidłowa nazwa kontaktu
• 2219 = pozycja niewypełniona przez firmę
• 2220 = niewypełniona nazwa elementu
• 2221 = nie wypełniono pozycji nazwisko
• 2222 = niewypełniony element wiadomości e-mail
• 2223 = nieprawidłowy format elementu e-mail
• 2224 = niewypełniony element email2
• 2225 = nieprawidłowy format elementu email2
• 2226 = niewypełniony element telefonu
• 2227 = nieprawidłowy format elementu telefonu
• 2228 = pozycja niewypełniona faksem
• 2229 = nieprawidłowy format pozycji faksu
• 2230 = niewypełniony identyfikator firmy elementu
• 2231 = nieprawidłowy identyfikator firmy w formacie elementu
• 2232 = pozycja niewypełniona Numer VAT
• 2233 = nieprawidłowy format pozycji Numer VAT
• 2234 = pozycja niewypełniona ulica
• 2235 = pozycja niewypełniona miasto
• 2236 = pozycja niewypełniona zip
• 2237 = niewypełniony kraj pozycji
• 2238 = nieprawidłowy kraj formatu elementu
• 2239 = niewypełniony stan elementu
• 2240 = pozycja niewypełniona inne dane
• 2241 = nieprawidłowy format pozycji w ostatnich dniach
• 3211 = błąd - nie udało się pobrać kontaktu
• 3238 = błąd autoryzacji
• 3239 = operacja nie powiodła się
• 4202 = kontakt niedostępny - błąd połączenia, spróbuj ponownie później
• 4215 = wdrożenie nie powiodło się - błąd połączenia, spróbuj ponownie później

Dane odpowiedzi

Żądanie nie zwraca żadnych danych.

Szablony

JSON příkaz:

{
  "request": {
    "user": "your@login.tld",
    "auth": "authentication string",
    "command": "contact-update",
    "clTRID": "your ID",
    "data": {
      "tld": "cz",
      "contact": {
        "fname": "name",
        "lname": "surname",
        "email": "email",
        "addr_street": "street and number",
        "addr_city": "city",
        "addr_zip": "zip code",
        "addr_country": "country ISO code",
        "phone": "full phone number",
        "notify_email": "email"
      }
    }
  }
}

Odpowiedź JSON (OK):

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

kontakt-transfer

Użyj żądania przeniesienia kontaktu, aby przenieść kontakt od innego rejestratora do WEDOS.

Parametry

• tld - TLD
• cname - nazwa kontaktu
• auth_info - AUTH-ID

Zwracane wartości

• 1000 = OK
• 2201 = nieprawidłowa TLD
• 2215 = brak parametru auth_info
• 2216 = nieprawidłowy identyfikator kontaktu  
• 2244 = Ta domena nie obsługuje transferu kontaktów 
• 3229 = kontakt jest niedostępny
• 3237 = kontakt jest już u nas zarejestrowany
• 3240 = błąd autoryzacji
• 3241 = transfer nie powiódł się
• 4216 = nie powiodło się - błąd połączenia

Dane odpowiedzi

Żądanie nie zwraca żadnych danych.

Szablony

Żądanie JSON:

{
  "request": {
    "user": "your@login.tld",
    "auth": "authentication string",
    "command": "contact-transfer",
    "clTRID": "your ID",
    "data": {
      "tld": "cz",
      "cname": "contact id",
      "auth_info": "auth-id"
    }
  }
}

Odpowiedź JSON (OK):

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

---

contact-send-auth-info

Użyj żądania contact-send-auth-info, aby wysłać wiadomość e-mail z identyfikatorem AUTH-ID kontaktu.

Parametry

• tld - TLD
• cname - nazwa kontaktu

Zwracane wartości

• 1000 = OK
• 2201 = nieprawidłowa TLD
• 2216 = nieprawidłowa nazwa kontaktu
• 2243 = niedozwolone wysyłanie auth_info
• 3213 = kontakt jest niedostępny
• 3215 = nie udało się wysłać auth-id
• 3228 = kontakt nie jest obsługiwany dla tej domeny
• 4217 = wysyłanie nie powiodło się - błąd komunikacji

Dane odpowiedzi

Żądanie nie zwraca żadnych danych.

Szablony

Żądanie JSON:

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

Odpowiedź JSON (OK):

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