WAPI – příkaz contact-info

  Kontakty, WAPI (API rozhraní)

Tento příkaz vrací detailní informace o kontaktu.

U .CZ domén funguje systém autorizačních hesel, který slouží k odkrytí skrytých položek v kontaktu. Příkaz contact-info může zavolat kdokoliv pro libovolný existující kontakt, a mohl by tak získat některé důvěrné informace, které jsou u něj uloženy. Proto jsou skryty a zobrazí se pouze po zadání autorizačního kódu.

V našem systému evidujeme, kdo daný kontakt vytvořil, případně kdo k němu zadal platné autorizační heslo, a tomu tyto položky zpřístupňujeme bez nutnosti jeho opakovaného vkládání do příkazu.

Parametry

  • tld – TLD
  • cname – název kontaktu
  • auth_info – autorizační heslo kontaktu – nepovinný parametr (pokud to doména podporuje, zadáním hesla se odkryjí skryté údaje kontaktu)

Návratové hodnoty

  • 1000 – Informace o kontaktu úspěšně získány
  • 2201 – chybně zadaná TLD
  • 2216 – chybná syntaxe kontaktu
  • 3228 – není podpora práce s kontakty
  • 3229 – chyba načtení kontaktu
  • 4212 – chyba spojení

Návratová data

V případě úspěchu (kód 1000) vrací příkaz v uzlu contact informace o kontaktu

Příklad použití

XML dotaz:

<request>
 <user>tester</user>
 <auth>463870369aef393f3b82274107c9ade4b5b2a414</auth>
 <command>contact-info</command>
 <clTRID>0094</clTRID>
 <data>
  <tld>cz</tld>
  <cname>TEST</cname>
 </data>
</request>

XML odpověď:

<response>
 <code>1000</code>
 <result>OK</result>
 <timestamp>1288084718</timestamp>
 <clTRID>0094</clTRID>
 <svTRID>1288084718.8477.32412.1</svTRID>
 <command>contact-info</command>
 <data>
  <contact>
   <contact_id>TEST</contact_id>
   <status>linked</status>
   <name>Honza tester</name>
   <company></company>
   <addr_street>Zlá 132</addr_street>
   <addr_city>Minas Morgull</addr_city>
   <addr_zip>13245</addr_zip>
   <addr_state></addr_state>
   <addr_country>vg</addr_country>
   <phone>+011 123456789</phone>
   <email>tester@example.com</email>
   <fax></fax>
   <reg_owner>REG-FRED_A</reg_owner>
   <reg_creator>REG-FRED_B</reg_creator>
   <reg_update>REG-FRED_B</reg_update>
   <created_date>2010-10-22 10:15:27</created_date>
   <updated_date>2010-10-22 15:10:19</updated_date>
   <transfer_date>2010-10-25 12:15:47</transfer_date>
   <fname>Honza</fname>
   <lname>Tester</lname>
   <email2></email2>
   <ic></ic>
   <dic></dic>
   <taxpayer></taxpayer>
   <disclose></disclose>
   <other>
    <notify_email>tester@example.com</notify_email>
    <ident_type></ident_type>
    <ident></ident>
   </other>
  </contact>
 </data>
</response>

Byl pro Vás tento návod užitečný?