WAPI – contacts for CZ domains

  WAPI (API Interface), Contacts

Each domain registry works with different contacts, different rules for identifiers of contacts, with required items in the detail and other. Here is a detailed description of contacts for CZ domain.

Contact name(contact ID)

  • For CZ domain names is possible to specify contact’s name before its creation. There is an available command contact-check for this register,  by which you can verify that the name(ID) is applicable (not used, blocked ..)
  • The contact name must contain only uppercase letters of the English alphabet, digits and dash.
  • If the contact name will not be specified during contact creation it will be generated automatically.

Contact detalis

  • cname – contact name (only when creating a contact), skip, or leave blank for generating automatically
  • company – your company
  • fname – your name – required
  • lname – your last name – required
  • email – e-mail – required
  • phone – your phone +XXX XXXXXXXXX
  • fax – your fax +XXX XXXXXXXXX
  • dic – VAT number
  • addr_street – address – street – required
  • addr_city – address – city – required
  • addr_zip – ZIP – required
  • addr_country – country (ISO code, lowercase, CZ.NIC accepts all countries) – required
  • addr_state – state
  • ident_type – document type
    • company ID (CID), identity card (IC), birthday date(DD.MM.YYYY), passport (pas), social affairs number (SAN)
  • ident – document number (depends on ident_type)
  • notify_email – notification e-mail
  • disclose_phone – hide phone
  • disclose_fax – hide fax
  • disclose_email – hide e-mail
  • disclose_ident – hide document
  • disclose_notify_email – hide notification e-mail

Hiding items

In the contact for the .CZ domain is possible to hide some items in the contact details. It is an items phone, fax, e-mail, document, e-mail. If these informations are marked as hidden, you can not view them without authorization.

To the hiding there is an option disclose_* in contact detail, where is possible to insert flag to the corresponding node 0/1 (1 = hidden, 0 = public). 

Exapmle

The request to create a contact in the registry CZ.NIC will look like this:

minimum:

<request>
 <user>tester</user>
 <auth>8b91c1b94fd9a4488dc3d9160eebbf25c0b2a03f</auth>
 <command>contact-create</command>
 <data>
  <tld>cz</tld>
  <contact>
   <fname>Jan</fname>
   <lname>Novák</lname>
   <email>jan.novak@example.com</email>
   <addr_street>Zelená 1568</addr_street>
   <addr_city>Minas Morgull</addr_city>
   <addr_zip>12345</addr_zip>
   <addr_country>vg</addr_country>
   <phone>+011 123456789</phone>
  </contact>
 </data>
</request>

maximum:

<request>
 <user>tester</user>
 <auth>8b91c1b94fd9a4488dc3d9160eebbf25c0b2a03f</auth>
 <command>contact-create</command>
 <data>
  <tld>cz</tld>
  <contact>
   <cname>JAN-NOVAK</cname>
   <company>Great Silver Eye</company>
   <fname>Jan</fname>
   <lname>Novák</lname>
   <email>novak@example.com</email>
   <phone>+011 123456789</phone>
   <fax>+011 987654321</fax>
   <addr_street>Zelená 1568</addr_street>
   <addr_city>Minas Morgull</addr_city>
   <addr_zip>12345</addr_zip>
   <addr_country>vg</addr_country>
   <addr_state>Jihočeský</addr_state>
   <ident_type>op</ident_type>
   <ident>123567891</ident>
   <notify_email>honzanovak@example.cz</notify_email>
   <dic>CZ987654321</dic>
   <disclose_phone>1</phone>
   <disclose_fax>1</fax>
   <disclose_email>1</email>
   <disclose_vat>1</vat>
   <disclose_ident>1</ident>
   <disclose_notify_email>1</notify_email>
  </contact>
 </data>
</request>
Děkujeme za zpětnou vazbu!