WAPI – Kontakty domén

V tomto článku nájdete informácie o správe kontaktov domén s týmito podporovanými TLD:

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

a tiež na týchto príkazoch:

• contact-check – kontrola dostupnosti kontaktu
• contact-info – výpis informácií o kontakte
• contact-create – vytvorenie nového kontaktu
• contact-update – úprava údajov kontaktu
• contact-transfer – prevod kontaktu od iného registrátora
• contact-send-auth-info – odoslanie AUTH-ID kontaktu

---

Kontakty domén podľa jednotlivých registrov

Každý register domén spravuje kontakty inak, platia rôzne pravidlá pre identifikátory kontaktov, povinné položky v údajoch a podobne.

CZ domény

Pri vytváraní kontaktu pre CZ doménu môžete zadať meno. Použite contact-check na overenie, či je zvolený názov dostupný (nepoužitý, neblokovaný, ..).

Názov kontaktu môže obsahovať iba veľké písmená anglickej abecedy, číslice a pomlčku. Ak pri vytváraní kontaktu názov neuvediete, systém ho vygeneruje automaticky.

V detaile kontaktu môžete nastaviť:

• cname – názov kontaktu (iba pri vytváraní nového); parameter vynechajte alebo nechajte prázdny, aby sa vygeneroval pseudonáhodný názov)
• company
• fname – meno – povinné
• lname – priezvisko – povinné
• email – povinné
• phone – telefónne číslo +XXX XXXXXXXXX
• fax – faxové číslo +XXX XXXXXXXXX
• dic – IČ DPH
• addr_street – ulica a číslo domu – povinné
• addr_city – adresa mesta – povinné
• addr_zip – PSČ – povinné
• addr_country – krajina (dvojpísmenový ISO kód, malými písmenami) – povinné
• addr_state – štát alebo región
• ident_type – typ dokladu totožnosti (ico (IČO), op (občiansky preukaz), birthday (dátum narodenia vo formáte DD.MM.YYYY), passport, mpsv (identifikátor MPSV))
• ident – číslo dokladu totožnosti (podľa ident_type)
• notify_email – notifikačná e-mailová adresa
• disclose_phone – skrytie telefónu
• disclose_fax – skrytie faxu
• disclose_email – skrytie e-mailu
• disclose_ident – skrytie čísla dokladu totožnosti
• disclose_notify_email – skrytie notifikačného e-mailu

Pri kontaktoch CZ domén je možné niektoré položky v údajoch kontaktu skryť. Použite disclose_* položky v detaile kontaktu s príznakom 0/1 (1 = skryté, 0 = verejné), ktorými určíte, či sa má daná informácia skrývať. Ak je informácia označená ako skrytá, nedá sa zobraziť bez autorizácie.

Od polovice januára 2018 môžete nastaviť dodacia adresa pre kontakty CZ domén. Pri vytváraní/úprave kontaktu zadajte tieto položky:

• del_addr=1 – aktívna doručovacia adresa (povinné)
• del_addr_street1 – ulica (povinné)
• del_addr_street2 – ulica (voliteľné)
• del_addr_street3 – ulica (voliteľné)
• del_addr_city – mesto (povinné)
• del_addr_state – štát alebo región
• del_addr_country – krajina (dvojpísmenový ISO kód, malými písmenami) (povinné)

Ak chcete pre kontakt deaktivovať doručovaciu adresu, zadajte del_addr=0 pri vytváraní/úprave kontaktu.

EU domény

Pri vytváraní kontaktu v registri EURid nemôžete zadať jeho name. Systém ho vždy priradí automaticky.

V detaile kontaktu môžete nastaviť:

• company
• fname – meno – povinné
• lname – priezvisko – povinné
• email – povinné
• phone – telefónne číslo +XXX XXXXXXXXX
• fax – faxové číslo +XXX XXXXXXXXX
• dic – IČ DPH
• addr_street – ulica a číslo domu – povinné
• addr_city – adresa mesta – povinné
• addr_zip – PSČ – povinné
• addr_country – krajina (dvojpísmenový ISO kód, malými písmenami) – povinné
• addr_state – štát alebo región

SK domény

Pri vytváraní kontaktu pre SK doménu môžete zadať meno. Použite contact-check na overenie, či je zvolený názov dostupný (nepoužitý, neblokovaný, ..).

Názov kontaktu môže obsahovať iba veľké písmená anglickej abecedy, číslice, pomlčky a bodky. Minimálna dĺžka názvu kontaktu je 5 znakov, maximálna 16 znakov. Ak pri vytváraní kontaktu názov neuvediete, systém ho vygeneruje automaticky. Formát automaticky vygenerovaného názvu kontaktu je WEDOS-XXX-YYYY (kde XXX je kombinácia písmen a číslic a YYYY sú iba číslice).

V detaile kontaktu môžete nastaviť:

• cname – názov kontaktu (iba pri vytváraní nového); parameter vynechajte alebo nechajte prázdny, aby sa vygeneroval pseudonáhodný názov)
• company
• fname – meno – povinné
• lname – priezvisko – povinné
• email – povinné
• phone – telefónne číslo +XXX XXXXXXXXX
• fax – faxové číslo +XXX XXXXXXXXX
• dic – IČ DPH
• addr_street – ulica a číslo domu – povinné
• addr_city – adresa mesta – povinné
• addr_zip – PSČ – povinné
• addr_country – krajina (dvojpísmenový ISO kód, malými písmenami) – povinné
• addr_state – štát alebo región
• ident_type – typ subjektu, je možné nastaviť iba raz (PERS = fyzická osoba, CORP = firma)
• ident – identifikačná hodnota (PERS = dátum narodenia vo formáte RRRR-MM-DD, CORP = IČO)
• disclose_name – skrytie mena
• disclose_org – skrytie názvu spoločnosti
• disclose_addr – skrytie adresy
• disclose_phone – skrytie telefónu
• disclose_fax – skrytie faxu
• disclose_email – skrytie e-mailovej adresy

PL domény

Pri vytváraní PL kontaktu nemôžete zadať jeho name. Systém ho vždy priradí automaticky.

V detaile kontaktu môžete nastaviť:

• company
• fname – meno, nie je možné zmeniť pri legal_type = individual – povinné
• lname – priezvisko, nie je možné zmeniť pri legal_type = individual – povinné
• email – povinné
• phone – telefónne číslo +XXX XXXXXXXXX
• fax – faxové číslo +XXX XXXXXXXXX
• dic – IČ DPH
• addr_street – ulica a číslo domu – povinné
• addr_city – adresa mesta – povinné
• addr_zip – PSČ – povinné
• addr_country – krajina (dvojpísmenový ISO kód, malými písmenami) – povinné
• addr_state – štát alebo región
• legal_type – právna forma (company, individual), nie je možné zmeniť – povinné

Domény gTLD a nTLD

Pri vytváraní kontaktu pre domény gTLD a nTLD nemôžete zadať jeho názov, systém ho vytvorí automaticky.

V detaile kontaktu môžete nastaviť:

• company
• fname – meno – povinné
• lname – priezvisko – povinné
• email – povinné
• phone – telefónne číslo +XXX XXXXXXXXX
• fax – faxové číslo +XXX XXXXXXXXX
• dic – IČ DPH
• addr_street – ulica a číslo domu – povinné
• addr_city – adresa mesta – povinné
• addr_zip – PSČ – povinné
• addr_country – krajina (dvojpísmenový ISO kód, malými písmenami) – povinné
• addr_state – štát alebo región

---

contact-check

Použite contact-check požiadavka na overenie dostupnosti názvu kontaktu.

Parametre

• tld – TLD, pre ktoré sa kontakt vytvára (napr. eu)
• cname – názov kontaktu

Návratové hodnoty

• 1000 – kontakt je voľný a je možné ho použiť
• 2201 – neplatné TLD
• 2216 – neplatný formát kontaktu
• 2218 – názov sa generuje automaticky (pri niektorých TLD nie je možné zadať názov kontaktu)
• 3231 – kontakt už existuje
• 3233 – kontakt nie je možné použiť
• 3234 – kontakt nie je možné použiť – v karanténe
• 3235 – kontakt nie je možné použiť – rezervovaný
• 3236 – kontakt nie je možné použiť – blokovaný
• 4211 – overenie zlyhalo – chyba komunikácie, zopakujte príkaz neskôr

Dáta odpovede

Požiadavka nevracia žiadne dáta.

Šablóny

JSON požiadavka:

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

JSON odpoveď (OK):

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

---

contact-info

The contact-info príkaz vracia podrobné informácie o kontakte.

Parametre

• tld – TLD – povinné
• cname – názov kontaktu – povinné
• auth_info – AUTH-ID kontaktu – voliteľné (ak to doména podporuje, zadaním AUTH-ID sa zobrazia skryté údaje kontaktu)
• reg_key – ID registra – voliteľné

Návratové hodnoty

• 1000 – informácie o kontakte boli úspešne načítané
• 2201 – neplatné TLD
• 2216 – neplatná syntax kontaktu 
• 3215 – odoslanie auth info kontaktu zlyhalo
• 3228 – nepodporovaná hodnota
• 3229 – chyba pri načítaní kontaktu
• 3236 – kontakt je blokovaný
• 4212 – chyba spojenia
• 5001 – neprihlásený

Dáta odpovede

Pri úspechu (kód 1000) príkaz vráti informácie o kontakte v uzle contact.

Šablóny

JSON požiadavka (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 odpoveď (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 odpoveď (kontakt sa nenašiel):

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

---

contact-create

Použite contact-create požiadavka na vytvorenie nového kontaktu, ktorý môžete použiť pri doménach registrovaných u príslušného registra. Každý kontakt je identifikovaný svojím názvom, ktorý je vždy jedinečný. Viac informácií o práci s kontaktmi u jednotlivých registrov nájdete v kapitole Kontakty domén podľa jednotlivých registrov.

Parametre

• tld – TLD domény
• contact – pole položiek kontaktu:
  • cname – názov kontaktu (prázdne = vygeneruje sa automaticky)
  • fname – meno
  • lname – priezvisko
  • company – spoločnosť
  • addr_street – ulica a číslo domu
  • addr_city – mesto
  • addr_zip – PSČ
  • addr_state – štát alebo región
  • addr_country – krajina (dvojpísmenový ISO kód, malými písmenami)
  • phone
  • fax
  • email
  • ďalšie položky v závislosti od registra

Návratové hodnoty

• 1000 = kontakt bol úspešne vytvorený
• 2201 = neplatná tld
• 2216 = neplatný názov kontaktu
• 2218 = názov kontaktu sa vytvára automaticky
• 2219 = nevyplnená položka firma
• 2220 = nie je vyplnený názov položky
• 2221 = nevyplnené priezvisko 
• 2222 = nevyplnený email 
• 2223 = nesprávny formát email
• 2224 = nevyplnený email2
• 2225 = nesprávny formát email2
• 2226 = nevyplnený telefón
• 2227 = nesprávny formát telefónu
• 2228 = nevyplnený fax
• 2229 = nesprávny formát faxu 
• 2230 = nevyplnené IČO 
• 2231 = nesprávny formát IČO
• 2232 = Nevyplnené IČ DPH
• 2233 = Nesprávny formát IČ DPH
• 2234 = nevyplnená ulica
• 2235 = nevyplnené mesto
• 2236 = Nevyplnené PSČ
• 2237 = nevyplnená krajina
• 2238 = nesprávny formát krajiny
• 2239 = nevyplnený štát
• 2240 = nevyplnené ostatné údaje
• 2241 = nesprávny formát ostatných údajov 
• 3228 = doména nepracuje s kontaktmi
• 3230 = vytvorenie kontaktu zlyhalo
• 3231 = názov kontaktu sa už používa
• 3232 = kontakt nie je možné použiť – neznámy dôvod
• 3233 = kontakt nie je možné použiť
• 3234 = kontakt nie je možné použiť – v karanténe
• 3235 = kontakt nie je možné použiť – rezervovaný
• 3236 = kontakt nie je možné použiť – blokovaný
• 3237 = kontakt je už u nás zaregistrovaný
• 4211 = kontrola kontaktu zlyhala – chyba komunikácie
• 4213 = vytvorenie kontaktu zlyhalo – chyba komunikácie

Dáta odpovede

Kontakt vracia nasledujúce dáta:

• cname – názov vytvoreného kontaktu

Šablóny

JSON požiadavka:

{
  "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 odpoveď (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žite contact-update požiadavka na úpravu položiek kontaktu.

Viac informácií o práci s kontaktmi u jednotlivých registrov nájdete v kapitole Kontakty domén podľa jednotlivých registrov.

Parametre

• tld – TLD
• cname – názov kontaktu
• auth_info – AUTH-ID
• contact – položky kontaktu
  • fname – meno
  • lname – priezvisko
  • company
  • addr_street – ulica a číslo
  • addr_city – mesto
  • addr_zip – PSČ
  • addr_state – štát alebo región
  • addr_country – krajina (dvojpísmenový ISO kód, malými písmenami)
  • phone
  • fax
  • email
  • ďalšie položky podľa registra

Návratové hodnoty

• 1000 = OK
• 2201 = neplatná TLD
• 2207 = neplatná syntax názvu kontaktu
• 2216 = neplatný názov kontaktu
• 2219 = nevyplnená položka firma
• 2220 = nevyplnená položka meno
• 2221 = nevyplnená položka priezvisko
• 2222 = nevyplnená položka email
• 2223 = nesprávny formát položky email
• 2224 = nevyplnená položka email2
• 2225 = nesprávny formát položky email2
• 2226 = nevyplnená položka telefón
• 2227 = nesprávny formát položky telefón
• 2228 = nevyplnená položka fax
• 2229 = nesprávny formát položky fax
• 2230 = nevyplnená položka IČO
• 2231 = nesprávny formát položky IČO
• 2232 = nevyplnená položka IČ DPH
• 2233 = nesprávny formát položky IČ DPH
• 2234 = nevyplnená položka ulica
• 2235 = nevyplnená položka mesto
• 2236 = nevyplnená položka PSČ
• 2237 = nevyplnená položka krajina
• 2238 = nesprávny formát položky krajina
• 2239 = nevyplnená položka štát
• 2240 = nevyplnená položka ostatné údaje
• 2241 = nesprávny formát položky ostatné údaje
• 3211 = chyba – kontakt sa nepodarilo získať
• 3238 = chyba autorizácie
• 3239 = operácia zlyhala
• 4202 = nedostupný kontakt – chyba pripojenia, skúste to znova neskôr
• 4215 = vykonanie zlyhalo – chyba pripojenia, skúste to znova neskôr

Dáta odpovede

Požiadavka nevracia žiadne dáta.

Šablóny

JSON prí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 odpoveď (OK):

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

contact-transfer

Použite contact-transfer požiadavka na prevod kontaktu od iného registrátora k WEDOS.

Parametre

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

Návratové hodnoty

• 1000 = OK
• 2201 = neplatná TLD
• 2215 = chýba parameter auth_info
• 2216 = neplatný kontaktný identifikátor  
• 2244 = Táto doména nepodporuje prevod kontaktu 
• 3229 = kontakt nie je dostupný
• 3237 = kontakt je už u nás zaregistrovaný
• 3240 = chyba autorizácie
• 3241 = prevod zlyhal
• 4216 = zlyhalo – chyba pripojenia

Dáta odpovede

Požiadavka nevracia žiadne dáta.

Šablóny

JSON požiadavka:

{
  "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 odpoveď (OK):

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

---

contact-send-auth-info

Použite contact-send-auth-info požiadavka na odoslanie e-mailu s AUTH-ID kontaktu.

Parametre

• tld – TLD
• cname – názov kontaktu

Návratové hodnoty

• 1000 = OK
• 2201 = neplatná TLD
• 2216 = neplatný názov kontaktu
• 2243 = odoslanie auth_info nie je povolené
• 3213 = kontakt je nedostupný
• 3215 = odoslanie auth-id zlyhalo
• 3228 = kontakt nie je podporovaný pre túto doménu
• 4217 = odoslanie zlyhalo – chyba komunikácie

Dáta odpovede

Požiadavka nevracia žiadne dáta.

Šablóny

JSON požiadavka:

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

JSON odpoveď (OK):

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

Pomohol vám tento článok?

Vaše hodnotenie nám pomáha zlepšovať naše články.

ÁnoNie

Chceli by ste nám k tomuto článku niečo napísať? (nepovinné)

Vašu správu si prečíta tím tvorcov dokumentácie, ale neodpovedá na ňu. Ak potrebujete poradiť, kontaktujte nás pomocou kontaktného formulára. Nezadávajte sem heslá ani osobné údaje.

Toto pole nevypĺňajte