WAPI – Kontakty domén

V tomto článku najdete informace o správě doménových kontaktů u následujících podporovaných TLD:

• CZ
• EU
• SK
• PL
• gTLD a nTLD

a také u těchto příkazů:

• contact-check – kontrola dostupnosti kontaktu
• contact-info – výpis informací o kontaktu
• contact-create – vytvoření nového kontaktu
• contact-update – úprava dat kontaktu
• contact-transfer – převod kontaktu od jiného registrátora
• contact-send-auth-info – odeslání AUTH-ID kontaktu

---

Kontakty domén podle jednotlivých registrů

Každý registr domén spravuje kontakty jinak, platí různá pravidla pro identifikátory kontaktů, povinné položky v údajích apod.

Domény CZ

Při vytváření kontaktu pro CZ doménu můžete zadat jméno. Použijte contact-check pro ověření, zda je zvolený název dostupný (nepoužitý, neblokovaný, ..).

Název kontaktu může obsahovat pouze velká písmena anglické abecedy, číslice a pomlčku. Pokud při vytváření kontaktu název neuvedete, systém jej vygeneruje automaticky.

V detailu kontaktu můžete nastavit:

• cname – název kontaktu (pouze při vytváření nového); parametr vynechte nebo nechte prázdný pro vygenerování pseudonáhodného názvu)
• company
• fname – jméno – povinné
• lname – příjmení – povinné
• e-mail – povinné
• phone – telefonní číslo +XXX XXXXXXXXX
• fax – číslo faxu +XXX XXXXXXXXX
• dic – DIČ
• addr_street – ulice a číslo popisné – povinné
• addr_city – město – povinné
• addr_zip – PSČ – povinné
• addr_country – země (dvoupísmenný ISO kód, malými písmeny) – povinné
• addr_state – stát nebo region
• ident_type – typ dokladu totožnosti (ico (IČO), op (občanský průkaz), birthday (datum narození ve formátu DD.MM.YYYY), passport, mpsv (průkaz MPSV))
• ident – číslo dokladu totožnosti (podle ident_type)
• notify_email – notifikační e-mailová adresa
• disclose_phone – skrýt telefon
• disclose_fax – skrýt fax
• disclose_email – skrýt e-mail
• disclose_ident – skrýt číslo dokladu totožnosti
• disclose_notify_email – skrýt notifikační e-mail

U kontaktů domén CZ je možné některé položky v údajích kontaktu skrýt. Použijte disclose_* položky v detailu kontaktu s příznakem 0/1 (1 = skryto, 0 = veřejné) určují, zda se má daná informace skrýt. Je-li informace označena jako skrytá, nelze ji zobrazit bez autorizace.

Od poloviny ledna 2018 můžete nastavit doručovací adresa pro kontakty CZ domén. Při vytváření/úpravě kontaktu zadejte tyto položky:

• del_addr=1 – aktivní doručovací adresa (povinné)
• del_addr_street1 – ulice (povinné)
• del_addr_street2 – ulice (volitelné)
• del_addr_street3 – ulice (volitelné)
• del_addr_city – město (povinné)
• del_addr_state – stát nebo region
• del_addr_country – země (dvoupísmenný ISO kód, malými písmeny) (povinné)

Pro deaktivaci doručovací adresy u kontaktu zadejte del_addr=0 při vytváření/úpravě kontaktu.

Domény EU

Při vytváření kontaktu v registru EURid nelze zadat jeho name. Systém jej vždy přiřadí automaticky.

V detailu kontaktu můžete nastavit:

• company
• fname – jméno – povinné
• lname – příjmení – povinné
• e-mail – povinné
• phone – telefonní číslo +XXX XXXXXXXXX
• fax – číslo faxu +XXX XXXXXXXXX
• dic – DIČ
• addr_street – ulice a číslo popisné – povinné
• addr_city – město – povinné
• addr_zip – PSČ – povinné
• addr_country – země (dvoupísmenný ISO kód, malými písmeny) – povinné
• addr_state – stát nebo region

SK domény

Při vytváření kontaktu pro SK doménu můžete zadat jméno. Použijte contact-check pro ověření, zda je zvolený název dostupný (nepoužitý, neblokovaný, ..).

Název kontaktu může obsahovat pouze velká písmena anglické abecedy, číslice, pomlčky a tečky. Minimální délka názvu kontaktu je 5 znaků, maximální 16 znaků. Pokud při vytváření kontaktu název neuvedete, systém jej vygeneruje automaticky. Formát automaticky vygenerovaného názvu kontaktu je WEDOS-XXX-YYYY (kde XXX je kombinace písmen a číslic a YYYY jsou pouze číslice).

V detailu kontaktu můžete nastavit:

• cname – název kontaktu (pouze při vytváření nového); parametr vynechte nebo nechte prázdný pro vygenerování pseudonáhodného názvu)
• company
• fname – jméno – povinné
• lname – příjmení – povinné
• e-mail – povinné
• phone – telefonní číslo +XXX XXXXXXXXX
• fax – číslo faxu +XXX XXXXXXXXX
• dic – DIČ
• addr_street – ulice a číslo popisné – povinné
• addr_city – město – povinné
• addr_zip – PSČ – povinné
• addr_country – země (dvoupísmenný ISO kód, malými písmeny) – povinné
• addr_state – stát nebo region
• ident_type – typ subjektu, lze nastavit pouze jednou (PERS = fyzická osoba, CORP = firma)
• ident – identifikační hodnota (PERS = datum narození ve formátu RRRR-MM-DD, CORP = IČ)
• disclose_name – skrýt jméno
• disclose_org – skrýt název společnosti
• disclose_addr – skrýt adresu
• disclose_phone – skrýt telefon
• disclose_fax – skrýt fax
• disclose_email – skrýt e-mailovou adresu

PL domény

Při vytváření PL kontaktu nelze zadat jeho name. Systém jej vždy přiřadí automaticky.

V detailu kontaktu můžete nastavit:

• company
• fname – jméno, nelze změnit pro legal_type = individual – povinné
• lname – příjmení, nelze změnit pro legal_type = individual – povinné
• e-mail – povinné
• phone – telefonní číslo +XXX XXXXXXXXX
• fax – číslo faxu +XXX XXXXXXXXX
• dic – DIČ
• addr_street – ulice a číslo popisné – povinné
• addr_city – město – povinné
• addr_zip – PSČ – povinné
• addr_country – země (dvoupísmenný ISO kód, malými písmeny) – povinné
• addr_state – stát nebo region
• legal_type – právní typ (company, individual), nelze změnit – povinné

Domény gTLD a nTLD

Při vytváření kontaktu pro domény gTLD a nTLD nelze zadat jeho jméno, systém jej vytvoří automaticky.

V detailu kontaktu můžete nastavit:

• company
• fname – jméno – povinné
• lname – příjmení – povinné
• e-mail – povinné
• phone – telefonní číslo +XXX XXXXXXXXX
• fax – číslo faxu +XXX XXXXXXXXX
• dic – DIČ
• addr_street – ulice a číslo popisné – povinné
• addr_city – město – povinné
• addr_zip – PSČ – povinné
• addr_country – země (dvoupísmenný ISO kód, malými písmeny) – povinné
• addr_state – stát nebo region

---

contact-check

Použijte contact-check požadavek pro ověření dostupnosti názvu kontaktu.

Parametry

• tld – TLD, pro které se kontakt vytváří (např. eu)
• cname – název kontaktu

Návratové hodnoty

• 1000 – kontakt je volný a lze jej použít
• 2201 – neplatné TLD
• 2216 – neplatný formát kontaktu
• 2218 – název je vygenerován automaticky (u některých TLD nelze název kontaktu zadat)
• 3231 – kontakt již existuje
• 3233 – kontakt nelze použít
• 3234 – kontakt nelze použít – v karanténě
• 3235 – kontakt nelze použít – rezervovaný
• 3236 – kontakt nelze použít – blokovaný
• 4211 – ověření se nezdařilo – chyba komunikace, zopakujte příkaz později

Data odpovědi

Požadavek nevrací žádná data.

Šablony

JSON požadavek:

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

JSON odpověď (OK):

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

---

contact-info

Tlačítko contact-info příkaz vrací podrobné informace o kontaktu.

Parametry

• tld – TLD – povinné
• cname – název kontaktu – povinné
• auth_info – AUTH-ID kontaktu – volitelné (pokud to doména podporuje, zadáním AUTH-ID se zobrazí skrytá data kontaktu)
• reg_key – ID registru – volitelné

Návratové hodnoty

• 1000 – informace o kontaktu byly úspěšně načteny
• 2201 – neplatné TLD
• 2216 – neplatná syntaxe kontaktu 
• 3215 – odeslání auth info kontaktu se nezdařilo
• 3228 – nepodporovaná hodnota
• 3229 – chyba při načítání kontaktu
• 3236 – kontakt je blokován
• 4212 – chyba spojení
• 5001 – nepřihlášen

Data odpovědi

Při úspěchu (kód 1000) vrátí příkaz informace o kontaktu v uzlu contact.

Šablony

JSON požadavek (kontakt CZ.NIC):

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

JSON odpověď (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": ""
        }
      }
    }
  }
}

JSON odpověď (kontakt nenalezen):

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

---

contact-create

Použijte contact-create požadavek pro vytvoření nového kontaktu, který můžete použít u svých domén registrovaných u odpovídajícího registru. Každý kontakt je identifikován svým názvem, který je vždy unikátní. Více informací o práci s kontakty u jednotlivých registrů najdete v kapitole Kontakty domén podle jednotlivých registrů.

Parametry

• tld – TLD domény
• kontakt – pole položek kontaktu:
  • cname – název kontaktu (prázdné = vygenerovat automaticky)
  • fname – jméno
  • lname – příjmení
  • company – společnost
  • addr_street – ulice a číslo popisné
  • addr_city – město
  • addr_zip – PSČ
  • addr_state – stát nebo region
  • addr_country – země (dvoupísmenný ISO kód, malými písmeny)
  • phone
  • fax
  • e-mail
  • další položky v závislosti na registru

Návratové hodnoty

• 1000 = kontakt byl úspěšně vytvořen
• 2201 = neplatná tld
• 2216 = neplatný název kontaktu
• 2218 = název kontaktu se vytváří automaticky
• 2219 = nevyplněná položka firma
• 2220 = není vyplněna položka name
• 2221 = není vyplněno příjmení 
• 2222 = není vyplněn email 
• 2223 = chybný formát email
• 2224 = není vyplněn email2
• 2225 = chybný formát email2
• 2226 = není vyplněn telefon
• 2227 = chybný formát telefonu
• 2228 = není vyplněn fax
• 2229 = chybný formát faxu 
• 2230 = není vyplněno IČ 
• 2231 = chybný formát IČ
• 2232 = Není vyplněno DIČ
• 2233 = Chybný formát DIČ
• 2234 = není vyplněna ulice
• 2235 = není vyplněno město
• 2236 = Není vyplněno PSČ
• 2237 = není vyplněna země
• 2238 = chybný formát země
• 2239 = není vyplněn stát
• 2240 = nejsou vyplněna ostatní data
• 2241 = chybný formát ostatních dat 
• 3228 = doména nepracuje s kontakty
• 3230 = nepodařilo se vytvořit kontakt
• 3231 = název kontaktu je již použit
• 3232 = kontakt nelze použít – neznámý důvod
• 3233 = kontakt nelze použít
• 3234 = kontakt nelze použít – v karanténě
• 3235 = kontakt nelze použít – rezervovaný
• 3236 = kontakt nelze použít – blokovaný
• 3237 = kontakt je u nás již registrovaný
• 4211 = nepodařilo se zkontrolovat kontakt – chyba komunikace
• 4213 = nepodařilo se vytvořit kontakt – chyba komunikace

Data odpovědi

Kontakt vrací tato data:

• cname – název vytvořeného kontaktu

Šablony

JSON požadavek:

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

JSON odpověď (OK):

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

---

contact-update

Použijte contact-update požadavek pro úpravu položek kontaktu.

Více informací o práci s kontakty u jednotlivých registrů najdete v kapitole Kontakty domén podle jednotlivých registrů.

Parametry

• tld – TLD
• cname – název kontaktu
• auth_info – AUTH-ID
• kontakt – položky kontaktu
  • fname – jméno
  • lname – příjmení
  • company
  • addr_street – ulice a číslo
  • addr_city – město
  • addr_zip – PSČ
  • addr_state – stát nebo region
  • addr_country – země (dvoupísmenný ISO kód, malými písmeny)
  • phone
  • fax
  • e-mail
  • další položky podle registru

Návratové hodnoty

• 1000 = OK
• 2201 = neplatná TLD
• 2207 = neplatná syntaxe v názvu kontaktu
• 2216 = neplatný název kontaktu
• 2219 = nevyplněná položka firma
• 2220 = nevyplněná položka jméno
• 2221 = nevyplněná položka příjmení
• 2222 = nevyplněná položka email
• 2223 = chybný formát položky email
• 2224 = nevyplněná položka email2
• 2225 = chybný formát položky email2
• 2226 = nevyplněná položka telefon
• 2227 = chybný formát položky telefon
• 2228 = nevyplněná položka fax
• 2229 = chybný formát položky fax
• 2230 = nevyplněná položka IČ
• 2231 = chybný formát položky IČ
• 2232 = nevyplněná položka DIČ
• 2233 = chybný formát položky DIČ
• 2234 = nevyplněná položka ulice
• 2235 = nevyplněná položka město
• 2236 = nevyplněná položka PSČ
• 2237 = nevyplněná položka země
• 2238 = chybný formát položky země
• 2239 = nevyplněná položka stát
• 2240 = nevyplněná položka ostatní data
• 2241 = chybný formát položky ostatní data
• 3211 = chyba – nepodařilo se načíst kontakt
• 3238 = chyba autorizace
• 3239 = operace selhala
• 4202 = nedostupný kontakt – chyba spojení, zkuste to později
• 4215 = provedení selhalo – chyba spojení, zkuste to později

Data odpovědi

Požadavek nevrací žádná data.

Šablony

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

JSON odpověď (OK):

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

contact-transfer

Použijte contact-transfer požadavek pro převod kontaktu od jiného registrátora k WEDOS.

Parametry

• tld – TLD
• cname – název kontaktu
• auth_info – AUTH-ID

Návratové hodnoty

• 1000 = OK
• 2201 = neplatná TLD
• 2215 = chybí parametr auth_info
• 2216 = neplatný identifikátor kontaktu  
• 2244 = Tato doména nepodporuje převod kontaktu 
• 3229 = kontakt není dostupný
• 3237 = kontakt je u nás již registrovaný
• 3240 = chyba autorizace
• 3241 = převod se nezdařil
• 4216 = selhalo – chyba spojení

Data odpovědi

Požadavek nevrací žádná data.

Šablony

JSON požadavek:

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

JSON odpověď (OK):

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

---

contact-send-auth-info

Použijte contact-send-auth-info požadavek pro odeslání e-mailu s AUTH-ID kontaktu.

Parametry

• tld – TLD
• cname – název kontaktu

Návratové hodnoty

• 1000 = OK
• 2201 = neplatná TLD
• 2216 = neplatný název kontaktu
• 2243 = odeslání auth_info není povoleno
• 3213 = kontakt je nedostupný
• 3215 = nepodařilo se odeslat auth-id
• 3228 = kontakt není podporován pro tuto doménu
• 4217 = odeslání selhalo – chyba komunikace

Data odpovědi

Požadavek nevrací žádná data.

Šablony

JSON požadavek:

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

JSON odpověď (OK):

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

Pomohl vám tento návod?

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

AnoNe

Chcete nám k návodu něco napsat? (nepovinné)

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.

Tohle pole nevyplňujte