API: update_contact
Provede změny v kontaktu. Používá se jak pro CZ tak pro generické domény, s určitými odlišnostmi. Návratový kód 1000 OK, 2004 Failed v případě nemožnosti změnit kontakt, 8001 This contact does not belong to your account v případě že kontakt není přiřazen k vašemu účtu, 8002 This contact is not allowed to be edited by this user v případě že nemáte právo kontakt měnit, 8800 Malformed input v případě neplatných hodnot vstupních polí. Detaily selhání jsou předány v elementu errors. V případě úspěšného přijetí příkazu je vygenerován email pro schválení změn držitelem kontaktu. Struktura parametrů je identická s příkazem create_contact.
Důležité: XML musí mít <ssid> jako první element uvnitř <api> a jednotlivé elementy příkazu v pořadí dle schématu (validace přes XSD používá sequence, takže na pořadí záleží). Kontakt k úpravě se identifikuje elementem <contact_id> převzatým z list_contacts.
Parametry:
- contact_id - identifikátor kontaktu.
- type - typ kontaktu. Povolené hodnoty CZ pro české domény a generic pro generické domény (.com atd.)
- name - jméno a příjmení. Platné jen pro české domény.
- firstname - křestní jméno. Platné jen pro generické domény.
- lastname - příjmení. Platné jen pro generické domény.
- organization - jméno společnosti. Nepovinné.
- street - ulice a číslo domu.
- city - město.
- psc - poštovní směrovací číslo.
- cc - dvoumístný kód země (country code).
- phone - telefonní číslo ve formátu +420.123456789. Povinné pro české domény.
- disclose_phone - zveřejnit telefonní číslo v registru. Možné hodnoty yes a no. Platné jen pro české domény.
- fax - faxové číslo ve formátu +420.123456789. Nepovinné.
- disclose_fax - zveřejnit faxové číslo v registru. Možné hodnoty yes a no. Platné jen pro české domény.
- email - emailová adresa.
- disclose_email - zveřejnit emailovou adresu v registru. Možné hodnoty yes a no. Platné jen pro české domény.
- dic - DIČ. Platné jen pro české domény.
- disclose_dic - zveřejnit DIČ v registru. Možné hodnoty yes a no. Platné jen pro české domény.
- ident_type - typ identifikace. Možné hodnoty: op (číslo občanského průkazu), passport (číslo pasu), mpsv (číslo sociálního pojištění), ico (IČO) a birthday (datum narození). Platné jen pro české domény.
- ident_number - číslo identifikace. Platné jen pro české domény.
- disclose_ident - zveřejnit číslo identifikace v registru. Možné hodnoty yes a no. Platné jen pro české domény.
- notifyemail - emailová adresa pro notifikace o změnách. Nepovinné. Platné jen pro české domény.
- disclose_notifyemail - zveřejnit emailovou adresu pro notifikace v registru. Možné hodnoty yes a no. Platné jen pro české domény.
Bez návratových hodnot.
Příklad:
<?xml version="1.0" encoding="UTF-8"?> <api> <ssid>sygCqZlagT0OdBcgFwVio7uYsS69Rr</ssid> <update_contact> <contact_id>TEST007</contact_id> <type>CZ</type> <name>Test Testovič</name> <organization>Testing Inc.</organization> <street>Testovací 11/7</street> <city>Testov</city> <psc>87410</psc> <cc>CZ</cc> <phone>+420.602602602</phone> <disclose_phone>yes</disclose_phone> <fax/> <disclose_fax>yes</disclose_fax> <email>pav@oook.cz</email> <disclose_email>no</disclose_email> <dic/> <disclose_dic>yes</disclose_dic> <ident_type>birthday</ident_type> <ident_number>19.8.1980</ident_number> <disclose_ident>no</disclose_ident> <notifyemail>pav@oook.cz</notifyemail> </update_contact> </api>
<?xml version="1.0" encoding="UTF-8"?> <api> <status code="1000">OK</status> </api>
