SOAP API VOIPEX Platformy 7. generace vám umožnuje umožňuje napojit vaše aplikace na naše elekomunikacní telekomunikační a billingové služby. Díky tomu mužete vytvorit můžete vytvořit vlastní administracní administrační rozhraní a snadno rozšírit rozšířit své informacní informační systémy, aplikace a další programové vybavení o o řadu funkcí, které API nabízí. Referencní Referenční aplikací je B2B portál, který využívá témer všechny téměr všechny možnosti API. V soucasné dobe současné době jsou implementovány pouze mobilní služby.
KROK 1: PRÍSTUPOVÉ UDAJEÚDAJE
Musíte získat prístupové údaje k API. Tyto údaje získáte od vašeho obchodníka.
...
- Celá komunikace s API probíha pres přes HTTPS protokol a WSDL (popis služeb API) je dostupné na adrese https://api.ipex.cz/soap/ProviderManagement/v1/?wsdl
- Zde uvádené príklady uváděné příklady jsou psány v PHP a pokud narazíte behem implementace na nejaké problémy, zkuste si projít Poznámky SOAP klienta v PHP.
- Prihlášení Přihlášení k API. Prihlašovací Přihlašovací údaje zadejte na vstup metody getAccessToken, v odpovedi odpovědi se vrátí accessToken nutný pro volání dalších metod. Token si nekam uložte naprnapř. do session. Více informací o tokenu a autentizaci se doctete dočtete zde.
$wsdl = 'https://api.ipex.cz/soap/ProviderManagement/v1?wsdl';
$soapClient = new SoapClient($wsdl, array('encoding' => 'UTF-8', 'trace' => 1,
'exceptions' => 1));
// ziskani overovaciho tokenu
$credentials = array(
'userName' => 'prihlasovaci jmeno',
'password' => 'heslo'
);
$out = $soapClient->__soapCall("getAccessToken", $credentials);
$accessToken = $out['accessToken']; - Po získání tokenu se vám zprístupní zpřístupní možnost volat další metody. Token se predává předává v hlavicce hlavičce SOAP požadavku:
$wsdl = 'https://api.ipex.cz/soap/ProviderManagement/v1?wsdl';
$soapClient = new SoapClient($wsdl, array('encoding' => 'UTF-8', 'trace' => 1,
'exceptions' => 1));
$tokenHeader = new StdClass;
$tokenHeader->accessToken = $accessToken;
$soapClient->__setSoapHeaders(new SoapHeader('urn:apiipex:
providermanagement', 'verifyAccess', $tokenHeader));
// provedeni dotazu
$params = array(
);
$reponse = $soapClient->__soapCall("getAccessRights", $params); - Celý príklad příklad je k dispozici mezi vzorovými príkladypříklady.
KROK 3: POKROCILÁ POKROČILÁ IMPLEMENTACE
- Proctete Pročtěte si dokumentaci jednotlivých metod a inspiraci hledejte mezi vzorovými príkladypříklady.
- V dokumentaci je v popisu parametru datový typ, který musí být dodržen, a to jestli je parametr povinný ci či nepovinný. U nepovinného vstupního parametru to znamená, že nemusí být vyplnen vyplněn a u výstupního, že nemusí být obsažen v odpovediodpovědi.
- Pokud klient odešle chybný vstupní parametr, je mu vracen vrácen chybový kód > 0 v parametru result a popis chyby v resultText, více naleznete v obecném popisu chyb a v dokumentaci jednotlivých metod.
...