Příkaz domain-transfer slouží k převedení domény od jiného registrátora k nám.
Příkaz je synchronní pouze pro CZ a EU domény, tj. u nich se v případě správného autorizačního hesla provede převod okamžitě a hned znáte výsledek. U ostatních domén je přeregistrace asynchronní, výsledek se dozvíte prostřednictvím notifikace.
UPOZORNĚNÍ! U všech domén je při přeregistraci vyžadován souhlas majitele domény s pravidly (pře)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ý parametr
- auth_info – autorizační heslo – povinný parametr
- owner_c – identifikátor kontaktu majitele – povinný parametr pouze u registrů, které jej vyžadují (sk, eu, gTLD)
- dns – konfigurace DNS serverů domény – nepovinný parametr; dostupné pouze u registrů, které podporují změnu DNS serverů při přeregistraci domény (eu, gTLD)
- 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)
Parametr „dns“ – konfigurace DNS serverů
Některé registry podporují změnu DNS serverů při přeregistraci domény (eu, gTLD).
Možné hodnoty parametru dns:
- parametr dns není v požadavku uveden = zachování aktuálního nastavení DNS serverů, tak jak jsou nastaveny u domény před přeregistrací. Při přeregistraci dojde k resolvování aktuálně nastavených DNS serverů. Pokud není možné aktuálně nastavené DNS servery resolvovat, může přeregistrace skončit chybou (gTLD)
- parametr dns je prázdný = při přeregistraci jsou nastaveny výchozí DNS servery WEDOS
- parametr dns obsahuje konfiguraci DNS serverů = při přeregistraci jsou u domény nastaveny DNS servery uvedené v parametru DNS
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 úspěšně přeregistrována
- 1001 – Požadavek na registraci byl přijat, čeká na provedení (některé domény není možné přeregistrovat ihned, o průběhu budete informováni pomocí systému notifikací, více v článku WAPI – notifikace)
- 2100 – chybí povinný parametr
- 2101 – neplatný tvar parametrů
- 2201 – špatně zvolená TLD
- 2202 – špatný formát doménového názvu
- 2204 – nebyl uveden identifikátor kontaktu majitele domény
- 2207 – neplatný identifikátor kontaktu majitele domény
- 2210 – neplatný formát DNS serverů
- 2215 – Nebylo zadáno autorizační heslo (auth_info) a u této domény je vyžadováno
- 2245 – nevyplněn souhlas
- 2246 – chyba dat souhlasu
- 2252 – překročen limit požadavků na oběření domény
- 2263 – autorizační heslo je kratší než je požadovaná minimální délka
- 2271 – neplatný formát autorizačního hesla
- 3001 – neplatná měna zálohového účtu
- 3003 – neplatné fakturační údaje zálohového účtu
- 3207 – doména je již registrovaná u nás
- 3208 – nelze přeregistrovat z důvodu příliš blízké expirace
- 3217 – Nebylo možné navázat spojení s registrem
- 3218 – Přeregistrace není možná
- 3219 – existuje nevyřízený požadavek na přeregistraci této domény
- 3220 – doména je již vedena v naší evidenci
- 3226 – nepodařilo se přeregistrovat doménu
- 3227 – chyba autorizace na registru domén
- 3258 – odstávka registru
- 3266 – nelze přeregistrovat, protože doména je po expiraci
- 3267 – nepodařilo se resolvovat autoritativní DNS servery domény
- 4002 – nepodařilo se odečíst kredit ze zálohového účtu
- 4003 – nepodařilo se vytvořit období ve fakturaci
- 4206 – nepodařilo se zjistit, zda je doménu možné přeregistrovat – chyba spojení
- 4209 – nepodařilo se zjistit typ přeregistrace (s/bez prodloužení)
- 5001 – interní chyba přihlášení
- 5002 – nepodařilo se vypočítat cenu přeregistrace
- 5004 – odstávka fakturace
Návratová data
Po úspěšné změně registrátora domény jsou vrácena následující data:
- num – číslo objednávky
- expiration – datum expirace domény
Příklad použití
XML dotaz:
<request> <user>tester</user> <auth>fb82be1466331148816bdbac855a6b1bd4e24b81</auth> <command>domain-transfer</command> <clTRID>HHUt</clTRID> <data> <name>example.cz</name> <auth_info>oz4agwR6</auth_info> <rules> <fname>Jan</fname> <lname>Novák</lname> </rules> </data> </request>
XML odpověď:
<response> <code>1000</code> <result>OK</result> <timestamp>1286874431</timestamp> <clTRID>LNjH</clTRID> <svTRID>1286874431.6516.30471</svTRID> <command>domain-transfer</command> <data> <num>1311001074</num> <expiration>2011-10-12</expiration> </data> </response>