WAPI - příkaz domain-create
Příkaz pro registraci domény - syntaxe, příklady, souhlas s podmínkami
Datum: 21.10.2010
Pro vytvoření domény přes WAPI slouží příkaz domain-create. Příkaz je synchronní, tj. registrace domény se provede on-line. Upozorňujeme však, že proces registrace domény může trvat 5-20 sekund v závislosti na vytížení našeho systému a cílového registru domén.
UPOZORNĚNÍ! U všech domén je při registraci vyžadován souhlas majitele domény s pravidly registrace doménových jmen. Naše smluvní podmínky vyžadují, abyste vaše zákazníky s našimi podmínkami a s podmínkami příslušného registru domén seznámili! Pokud tak neučiníte, může to v případě sporu u domény vyústit až v její ztrátu bez náhrady škody.
U tohoto příkazu se aplikuje limit na max. 100 dotazů na dostupnost domény za hodinu. Více ve článku WAPI - omezení.
Parametry
- name - název domény včetně koncovky - povinné
- period - počet roků - povinné
- nsset - NSSET u cz domén - povinné (dns nebo nsset)
- dns - nastavení DNS - povinné (dns nebo nsset)
- owner_c - kontakt vlastníka - povinné
- admin_c - kontakt administrátora - nepovinné
- rules - jméno a příjmení osoby, která provedla souhlas s našimi podmínkami a podmínkami příslušného registru (typicky majitel domény)
Je třeba zadat buď nsset nebo dns.
Parametr "dns" - konfigurace DNS serverů
Pouze pokud není uveden parametr nsset.
Možné hodnoty parametru dns:
- parametr dns je prázdný = použít výchozí nastavení (nastaví se DNS servery WEDOS). Pozor, element dns je vyžadován, pouze je prázdný!
- parametr dns obsahuje konfiguraci DNS serverů = nelze použít u .cz domén (každý záznam musí obsahovat pole name, volitelně pak addr_ip4 a addr_ip6, jednotlivé servery jsou vnořeny v elementu server )
Příklad konfigurace DNS serverů v parametru dns:
-
XML
<dns> <server> <name>ns1.dns-server-host.tld</name> </server> <server> <name>ns2.dns-server-host.tld</name> </server> <server> <name>ns.transfering-domain-name.tld</name> <addr_ipv4>9.8.7.6</addr_ipv4> <addr_ipv6>ff01::101</addr_ipv6> </server> </dns>
-
JSON - servery musejí být očíslované!
"dns": { "array": { "server1": { "name": "ns1.dns-server-host.tld" // adresa 1. DNS serveru }, "server2": { "name": "ns2.dns-server-host.tld" // adresa 2. DNS serveru }, "server3": { "name": "ns.transfering-domain-name.tld", // adresa 3. DNS serveru "addr_ipv4": "9.8.7.6", // IPv4 GLUE "addr_ipv6": "ff01::101" // IPv6 GLUE } } }
Návratové hodnoty
- 1000 - doména byla úspěšně zaregistrována
- 1001 - požadavek na registraci byl přijat (některé domény není možné zaregistrovat ihned, o průběhu budete informováni pomocí systému notifikací, více v článku WAPI - notifikace)
- 3002 - nedostatečný kredit v zálohovém účtu
- 3201 - doménový název je již obsazen
- 3204 - doména je v karanténě
- 3205 - doména je rezervovaná
- 3206 - název domény je zablokován
- 2201 - nepodporované TLD
- 2203 - neplatné období
- 3221 - vytváření selhalo
- 4207 - vytvoření selhalo - chyba spojení
Návratová data
Po úspěšné registraci domény jsou v uzlu data vráceny dvě položky:
- num - číslo objednávky
- expiration - datum expirace domény
-
credit - informace o stavu zálohového účtu po dokončení operace
- amount - zbývající částka
- currency - měna
Příklad 1: Vytvoření domény s nastavením DNS WEDOS
XML dotaz:
<request> <user>tester</user> <auth>202b62bc4646281f97d225db1249840c8452dd8f</auth> <command>domain-create</command> <clTRID>a44B</clTRID> <data> <name>example.cz</name> <period>1</period> <dns></dns> <owner_c>_ID_KONTAKTU_MAJITELE_</owner_c> <admin_c>_ID_KONTAKTU_ADMINA_</admin_c> <rules> <fname>Jan</fname> <lname>Novák</lname> </rules> </data> </request>
XML odpověď:
<response> <code>1000</code> <result>OK</result> <timestamp>1286356644</timestamp> <clTRID>a44B</clTRID> <svTRID>1286356644.0246.21616</svTRID> <command>domain-create</command> <data> <num>1311000863</num> <expiration>2011-10-06</expiration> </data> </response>
Příklad 2: Registrace domény s použitím vlastního NSSETu
XML dotaz:
<request> <user>tester</user> <auth>202b62bc4646281f97d225db1249840c8452dd8f</auth> <command>domain-create</command> <clTRID>a44B</clTRID> <data> <name>example.cz</name> <period>3</period> <nsset>TESTNSSET</nsset> <owner_c>_ID_KONTAKTU_MAJITELE_</owner_c> <admin_c>_ID_KONTAKTU_ADMINA_</admin_c> <rules> <fname>Jan</fname> <lname>Novák</lname> </rules> </data> </request>
XML odpověď:
<response> <code>1000</code> <result>OK</result> <timestamp>1286356644</timestamp> <clTRID>a44B</clTRID> <svTRID>1286356644.0246.21616</svTRID> <command>domain-create</command> <data> <num>1311000863</num> <expiration>2011-10-06</expiration> </data> </response>
Příklad 3: Registrace domény s použitím seznamu DNS serverů
XML dotaz:
<request> <user>tester</user> <auth>202b62bc4646281f97d225db1249840c8452dd8f</auth> <command>domain-create</command> <clTRID>a44B</clTRID> <data> <name>example.eu</name> <period>1</period> <dns> <server> <name>ns.wedos.net</name> </server> <server> <name>ns.wedos.cz</name> </server> </dns> <owner_c>c1049663X</owner_c> <rules> <fname>Jan</fname> <lname>Novák</lname> </rules> </data> </request>
XML odpověď:
<response> <code>1000</code> <result>OK</result> <timestamp>1286356644</timestamp> <clTRID>a44B</clTRID> <svTRID>1286356644.0246.21616</svTRID> <command>domain-create</command> <data> <num>1311000863</num> <expiration>2011-10-06</expiration> </data> </response>
Související články
Diskuze k článku (6)
Zobrazit všechny
Přidat diskuzní příspěvek
Kontakt owner_c | Jan Střálka | 04.12.16 21:48 |
Re: Kontakt owner_c | Konstantin Dvorakovsky | 06.12.16 15:15 |
Re: Kontakt owner_c | Jan Střálka | 11.12.16 21:00 |
Re: Kontakt owner_c | Konstantin Dvorakovsky | 14.12.16 12:52 |
Re: Kontakt owner_c | Jan Střálka | 14.12.16 15:34 |
Re: Kontakt owner_c | Konstantin Dvorakovsky | 14.12.16 15:43 |