| Úvod | Objednávka | Technická podpora | Klientská sekce | Volná místa | Kontakt |
|
API registrace doménAPI (Application Programming Interface) je určen pro vzdálený – strojový přístup k rozhraní pro správu doménových jmen. Rozhraní je zpřístupněno pomocí protokolu SOAP (Simple Object Access Protocol), který má podporu ve většině běžně používaných jazyků.
Globální metody:CZ Doména:
CZ Kontakt:
CZ NSSet:
COCZ Doména:Generické domény:
EU domény:
HistorieVerze 1.3 (16.02.2009)
Verze 1.2 (9.10.2008)
Verze 1.1 (22.04.2008)
Verze 1.0 (15.04.2008)
Jak získat přístup k APIPro přístup k doménovému API stačí mít přístup k ovládacímu panelu se službou „Správa Domén“. Pokud účet nemáte stačí jej zaregistrovat. Po úspěšné registraci máte zřízeny jak doménové služby v ovládacím panelu tak i SOAP přístup, který můžete ihned využívat dle níže uvedené dokumentace. Pravidla použitíPravidla použití se řídí především Smluvními dokumenty Uživatel je dále oprávněn službu užívat pouze v případě, že:
Limity přístupůSlužba má interně nastavené bezpečnostní limity pro volání. Omezení dle IP adresyAPI dokáže přijímat rychlostí cca 3 požadavky za sekundu. Pokud je k API přistupováno z více vláken je nutné dodržet limit 3 požadavky za sekundu. V případě nedodžení stanoveného limitu systém vrací vyjimky. Pokud však přistupujete z jednoho vlánka (aplikace) stačí rozhraní běžně používat a k vrácení výjimky nedojde. Omezení na počty volání jednotlivých funkcí:Pokud bude volána jakákoliv stejná funkce dříve jak 3 sec od předchozího volání bude o 3 sec pozdržena (první volání je bez zdržení). V případě volání vícevláknově (několik spojení zároveň) je při nedodžení odstupu 3 sec vyvolána výjimka. V praxi limity fungují následovně: Příklad volání z PHP5Základní předpoklady:
Ověření funkčnosti SOAP voláníZda vše funguje jak má lze ověřit následujícím způsobem:
Volání vypíše: Greeting from Web4u soap gateway Jak získat identifikátor služby:Identifikátor služby, (Správy Domén) pod kterou budete funkce volat získáte jakýmkoliv zavoláním existující funkce, pouze s vašimi parametry „login“, „password“. Výsledkem bude výjimka obsahující přehled použitelných služeb s jejich ID.
Příklad volání
První parametry lze pak skrýt následovně:
pak voláme:
Příklad zpracování chyb
Tabulka chybových hlášeníChyby které jsou vraceny přímo (s chybovým kódem):
Následující chyby jsou „zabaleny“ v chybě číslo 10 (chyba validace), pokud mají číslo jedná se o níze definované chyby, jinak se jedna o chyby validačního charakteru.
greeting()Jednoduche volani na ověření funkčnosti SOAPu. checkDomain()
domainHistory()
domainList()
getCaptcha()
Příklad výstupu obrázku
requestStatus()
czRulesActualVersion()
czRulesConfirmed()
czDomainCreate()
czDomainCreateValidate()Parametry shodné jako u funkce czDomainCreate(), toto volání pouze ověří zda
jsou všechny požadované parametry korektně vyplněny. czDomainRenew()
czDomainRenewValidate()Parametry shodné jako u funkce czDomainRenew(), toto volání pouze ověří zda jsou
všechny požadované parametry korektně vyplněny. czDomainTransfer()
czDomainTransferValidate()Parametry shodné jako u funkce czDomainTransfer(), toto volání pouze ověří
zda jsou všechny požadované parametry korektně vyplněny. Funkce neověřuje
správnost zadaného transfer hesla. czDomainUpdate()
czDomainUpdateValidate()Parametry shodné jako u funkce czDomainUpdate(), toto volání pouze ověří zda
jsou všechny požadované parametry korektně vyplněny. czContactCheck()
czDomainInfo()Funkce vyžaduje potvrzení získaným captcha kódem. Viz getCaptcha().
czDomainTransferPasswordFunkce umožňuje zaslat transfer heslo Centrálním registrem na adresu
držitele daného objektu.
czContactNew()
czContactNewValidate()Parametry shodné jako u funkce czContactNew(),
toto volání pouze ověří zda jsou všechny požadované parametry korektně
vyplněny. czContactTransfer()
czContactTransferValidate()Parametry shodné jako u funkce czContactTransfer(), toto volání pouze
ověří zda jsou všechny požadované parametry korektně vyplněny. Funkce
neověřuje správnost zadaného transfer hesla. czContactUpdate()
czContactUpdateValidate()Parametry shodné jako u funkce czContactUpdate(), toto volání pouze ověří
zda jsou všechny požadované parametry korektně vyplněny. Funkce neověřuje
správnost zadaného transfer hesla. czContactHistory()
czContactList()
czContactInfo()Funkce vyžaduje potvrzení získaným captcha kódem. Viz getCaptcha().
czContactTransferPasswordFunkce umožňuje zaslat transfer heslo Centrálním registrem na adresu
držitele daného objektu.
czNSSetCheck()
czNSSetNew()
czNSSetNewValidate()Parametry shodné jako u funkce czNSSetNew(), toto
volání pouze ověří zda jsou všechny požadované parametry korektně
vyplněny. czNSSetTransfer()
czNSSetTransferValidate()Parametry shodné jako u funkce czNSSetTransfer(), toto volání pouze ověří zda
jsou všechny požadované parametry korektně vyplněny. Funkce neověřuje
správnost zadaného transfer hesla. czNSSetUpdate()
czNSSetUpdateValidate()Parametry shodné jako u funkce czNSSetUpdate(), toto volání pouze ověří zda jsou
všechny požadované parametry korektně vyplněny. Funkce neověřuje
správnost zadaného transfer hesla. czNSSetHistory()
czNSSetList()
czNSSetInfo()Funkce vyžaduje potvrzení získaným captcha kódem. Viz getCaptcha().
czNSSetTransferPasswordFunkce umožňuje zaslat transfer heslo Centrálním registrem na adresu
držitele daného objektu.
COCZ detailyCOCZ doména je implementačne i parametricky shodná jako doména CZ, funkce mají předponu „co“ například v případě registrace domény je to pak coczDomainCreate(). genericStates()
genericCountries()
genericDomainNew()
genericDomainNewValidate()Parametry shodné jako u funkce genericDomainNew(), toto volání pouze ověří
zda jsou všechny požadované parametry korektně vyplněny. genericDomainRenew()
genericDomainRenewValidate()Parametry shodné jako u funkce genericDomainRenew(), toto volání pouze
ověří zda jsou všechny požadované parametry korektně vyplněny. genericDomainTransfer()
genericDomainTransferValidate()Parametry shodné jako u funkce genericDomainTransfer(), toto volání pouze
ověří zda jsou všechny požadované parametry korektně vyplněny. genericDomainUpdate()
genericDomainUpdateValidate()Parametry shodné jako u funkce genericDomainUpdate(), toto volání pouze
ověří zda jsou všechny požadované parametry korektně vyplněny. genericDomainInfo()
euStates()
euLanguages()
euDomainNew()
euDomainNewValidate()Parametry shodné jako u funkce euDomainNew(),
toto volání pouze ověří zda jsou všechny požadované parametry korektně
vyplněny. euDomainTransfer()
euDomainTransferValidate()Parametry shodné jako u funkce euDomainTransfer(), toto volání pouze ověří
zda jsou všechny požadované parametry korektně vyplněny. euDomainTrade()
euDomainTradeValidate()Parametry shodné jako u funkce euDomainTrade(), toto volání pouze ověří zda jsou
všechny požadované parametry korektně vyplněny. euDomainRenew()Pokud nelze platnost domenového jména standardně prodloužit například z důvodu karantény, je nutné použít funkci euDomainReactivate().
euDomainRenewValidate()Parametry shodné jako u funkce euDomainRenew(), toto volání pouze ověří zda jsou
všechny požadované parametry korektně vyplněny. euDomainReactivate()Reaktivace doménového jména (pokud doména spadla | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||