API: register_domain
Registrace nové domény
používá se jak pro CZ, tak pro generické domény, s určitými odlišnostmi
domény jsou placeny z kreditu na vašem účtu
Parametry:
- domain - jméno domény
- owner - kontakt majitele
- additional - rozšířené údaje vyžadované pro registraci určitých zahraničních domén
- name - jméno položky
- value - hodnota položky
- additional ...
- period - období (počet let), 1 až 10
- nsset - NSSET (jen pro české domény)
- keyset - KEYSET (volitelně; jen pro české domény)
- admin - administrativní kontakt
- ns - nameserver (jen pro zahraniční domény)
- ns ...
Nepovinné atributy:
- test - Boolean hodnota, určeno pro testování aplikace
Návratové kódy:
- 1000 OK
- 2004 Failed - nelze registrovat doménu. Detaily selhání jsou předány v elementu errors.
- 2006 Domain already exists - doména již existuje
- 2009 Reserved domain name - jméno domény je vyjmuto z registrací na straně registrátora
- 2010 Missing required additional field - Chybí některá z vyžadovaných rozšířených položek nutných k registraci domén v dané TLD. Detaily jsou předány v elementu errors.
- 2013 Invalid nameservers section - nebyly předány nameservery nebo nevyhovuje jejich počet. Detaily jsou předány v elementu errors.
- 2016 Contact is not valid - majitelský (owner) nebo administrativní (admin) kontakt nemá vyplněný telefon. Detaily jsou předány v elementu errors.
- 3000 Your credit is low - nemáte dostatečný kredit
- 8000 Not supported TLD - domény v této TLD nenabízíme k registraci
- 8001 This contact/NSSET/KEYSET/nameserver does not belong to your account - použitý objekt není přiřazen k vašemu účtu
- 8800 Malformed input - neplatné hodnoty vstupních polí. Detaily selhání jsou předány v elementu errors.
Bez návratových hodnot.
Příklad registrace české domény:
<?xml version="1.0" encoding="UTF-8"?>
<api>
<ssid>etLvxXwuXogjc9lXaVckHzTkSjOjh9</ssid>
<register_domain test='true'>
<domain>lteweb.cz</domain>
<owner>HORNYAK</owner>
<period>1</period>
<nsset>TELE3</nsset>
</register_domain>
</api>
Příklad registrace zahraniční domény, se sekcí rozšířených údajů:
<?xml version="1.0" encoding="UTF-8"?>
<api>
<ssid>etLvxXwuXogjc9lXaVckHzTkSjOjh9</ssid>
<register_domain>
<domain>arcierebianco.it</domain>
<owner>G-674184</owner>
<additional>
<name>nationalityCode</name>
<value>CZ</value>
</additional>
<additional>
<name>entityType</name>
<value>1</value>
</additional>
<additional>
<name>regCode</name>
<value>123456789</value>
</additional>
<period>1</period>
<nsset>TELE3</nsset>
<admin>G-674184</admin>
<ns>ns1.tele3.cz</ns>
<ns>ns2.tele3.cz</ns>
</register_domain>
</api>
Příklad odpovědi při neúspěšném volání:
<?xml version="1.0" encoding="UTF-8"?>
<api><credit currency="CZK">116.00</credit><status code="2006">Domain already exists</status></api>
Příklad odpovědi při úspěšném volání:
<?xml version="1.0" encoding="UTF-8"?>
<api><credit currency="CZK">116.00</credit><status code="1000">OK</status></api>