WAPI – Kontakty domény

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

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

a tiež pri 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 doménu CZ môžete zadať názov. Použite contact-check pre 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 názov pri vytváraní kontaktu nezadáte, 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 pre vygenerovanie pseudonáhodného názvu)
• firma
• fname – meno – povinné
• lname – priezvisko – povinné
• e-mail – povinné
• phone – telefónne číslo +XXX XXXXXXXXX
• fax – číslo faxu +XXX XXXXXXXXX
• dic – IČ DPH
• addr_street – ulica a súpisné číslo – povinné
• addr_city – mesto – 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 (cestovný pas), mpsv (identifikátor MPSV))
• ident – číslo dokladu totožnosti (podľa ident_type)
• notify_email – notifikačná e-mailová adresa
• disclose_phone – skryť telefón
• disclose_fax – skryť fax
• disclose_email – skryť e-mail
• disclose_ident – skryť číslo dokladu totožnosti
• disclose_notify_email – skryť notifikačný e-mail

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 skryť. Ak je informácia označená ako skrytá, nedá sa zobraziť bez autorizácie.

Od polovice januára 2018 môžete nastaviť doručovacia adresa pre kontakty domén CZ. 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é)

Doručovaciu adresu kontaktu deaktivujete zadaním 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 priraďuje automaticky.

V detaile kontaktu môžete nastaviť:

• firma
• fname – meno – povinné
• lname – priezvisko – povinné
• e-mail – povinné
• phone – telefónne číslo +XXX XXXXXXXXX
• fax – číslo faxu +XXX XXXXXXXXX
• dic – IČ DPH
• addr_street – ulica a súpisné číslo – povinné
• addr_city – mesto – 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

Domény SK

Pri vytváraní kontaktu pre doménu SK môžete zadať názov. Použite contact-check pre 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 názov pri vytváraní kontaktu nezadáte, systém ho vygeneruje automaticky. Formát automaticky generované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 pre vygenerovanie pseudonáhodného názvu)
• firma
• fname – meno – povinné
• lname – priezvisko – povinné
• e-mail – povinné
• phone – telefónne číslo +XXX XXXXXXXXX
• fax – číslo faxu +XXX XXXXXXXXX
• dic – IČ DPH
• addr_street – ulica a súpisné číslo – povinné
• addr_city – mesto – 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, možno 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 – skryť meno
• disclose_org – skryť názov spoločnosti
• disclose_addr – skryť adresu
• disclose_phone – skryť telefón
• disclose_fax – skryť fax
• disclose_email – skryť e-mailovú adresu

PL domény

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

V detaile kontaktu môžete nastaviť:

• firma
• fname – meno, nemožno zmeniť pre legal_type = individual – povinné
• lname – priezvisko, nemožno zmeniť pre legal_type = individual – povinné
• e-mail – povinné
• phone – telefónne číslo +XXX XXXXXXXXX
• fax – číslo faxu +XXX XXXXXXXXX
• dic – IČ DPH
• addr_street – ulica a súpisné číslo – povinné
• addr_city – mesto – 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), nemožno 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ť:

• firma
• fname – meno – povinné
• lname – priezvisko – povinné
• e-mail – povinné
• phone – telefónne číslo +XXX XXXXXXXXX
• fax – číslo faxu +XXX XXXXXXXXX
• dic – IČ DPH
• addr_street – ulica a súpisné číslo – povinné
• addr_city – mesto – 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 možno ho použiť
• 2201 – neplatné TLD
• 2216 – neplatný formát kontaktu
• 2218 – názov je generovaný automaticky (pri niektorých TLD nemožno názov kontaktu zadať)
• 3231 – kontakt už existuje
• 3233 – kontakt nemožno použiť
• 3234 – kontakt nemožno použiť – v karanténe
• 3235 – kontakt nemožno použiť – rezervovaný
• 3236 – kontakt nemožno 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

Tento 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, zadanie AUTH-ID odhalí skryté dáta kontaktu)
• reg_key – ID registra – voliteľné

Návratové hodnoty

• 1000 – informácie o kontakte ú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 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 nenájdený):

{
  "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 svojich doménach registrovaných v zodpovedajúcom registri. Každý kontakt je identifikovaný svojím názvom, ktorý je vždy jedinečný. Viac informácií o práci s kontaktmi pri jednotlivých registroch nájdete v kapitole Kontakty domén podľa jednotlivých registrov.

Parametre

• tld – TLD domény
• kontakt – pole položiek kontaktu:
  • cname – názov kontaktu (prázdne = vygenerovať automaticky)
  • fname – meno
  • lname – priezvisko
  • firma – spoločnosť
  • addr_street – ulica a súpisné čí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
  • e-mail
  • ď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 = položka meno nie je vyplnená
• 2221 = priezvisko nie je vyplnené
• 2222 = e-mail nie je vyplnený
• 2223 = e-mail má nesprávny formát
• 2224 = email2 nie je vyplnený
• 2225 = email2 má nesprávny formát
• 2226 = telefón nie je vyplnený
• 2227 = telefón má nesprávny formát
• 2228 = fax nie je vyplnený
• 2229 = fax má nesprávny formát
• 2230 = IČO nie je vyplnené
• 2231 = IČO má nesprávny formát
• 2232 = DIČ nie je vyplnené
• 2233 = DIČ má nesprávny formát
• 2234 = ulica nie je vyplnená
• 2235 = mesto nie je vyplnené
• 2236 = PSČ nie je vyplnené
• 2237 = krajina nie je vyplnená
• 2238 = krajina má nesprávny formát
• 2239 = štát nie je vyplnený
• 2240 = ostatné údaje nie sú vyplnené
• 2241 = ostatné údaje majú nesprávny formát
• 3228 = doména nepracuje s kontaktmi
• 3230 = vytvorenie kontaktu zlyhalo
• 3231 = názov kontaktu sa už používa
• 3232 = kontakt sa nedá použiť – neznámy dôvod
• 3233 = kontakt sa nedá použiť
• 3234 = kontakt sa nedá použiť – v karanténe
• 3235 = kontakt sa nedá použiť – rezervovaný
• 3236 = kontakt sa nedá 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
• kontakt – položky kontaktu
  • fname – meno
  • lname – priezvisko
  • firma
  • 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
  • e-mail
  • ďalšie položky podľa registra

Návratové hodnoty

• 1000 = OK
• 2201 = neplatná TLD
• 2207 = neplatná syntax v názve 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 e-mail
• 2223 = nesprávny formát položky e-mail
• 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 DIČ
• 2233 = nesprávny formát položky DIČ
• 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 v ostatných údajoch
• 3211 = chyba – nepodarilo sa načítať kontakt
• 3238 = chyba autorizácie
• 3239 = operácia zlyhala
• 4202 = nedostupný kontakt – chyba pripojenia, skúste to znova neskôr
• 4215 = realizácia zlyhala – 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ý identifikátor kontaktu
• 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 nie je dostupný
• 3215 = odoslanie auth-id zlyhalo
• 3228 = kontakt nie je pre túto doménu podporovaný
• 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",
  }
}