Eurotel SMS Connector SMS Connector - SMS Redirector Související změny Verze 0.2
Obsah 1. Úvod 4 1.1. Účel 4 1.2. Odkazy 4 2. Rozšíření o SMS Redirector - principy 4 2.1. Čísla aplikací a jejich dostupnost 4 2.2. Omezení vztahující se na přípony k číslům MSISDN aplikace 5 2.3. Zkušební provoz SMS Connector 5 2.4. Na velikosti písma nezávislé názvy parametrů na HTTP GET/POST 5 3. Rozšíření SMS Redirector změny rozhraní 6 3.1. Rozšířené rozhraní webových služeb 6 3.2. Rozšířené rozhraní HTTP GET/POST 6 4. Možné problémy s novou verzí SMS Connector 7 4.1. HTTP GET/POST názvy parametrů napsané nesprávnými znaky 7 4.2. Pořadí při ověřování parametrů 7
4 1. Úvod 1.1. Účel Tento dokument je vytvořen pro potřeby Eurotel business partnerů (BP), kteří mají v úmyslu pomocí Eurotel Messaging Platform s využitím služby SMS Connector přijímat a zákazníkům mobilních služeb odesílat textové a multimediální zprávy. Popisuje nové příležitosti, které službě SMS Connector dává rozšíření o SMS Redirector, a poskytuje přehled a odkazy na přislušné části partnerské dokumentace. 1.2. Odkazy V dokumentu jsou použity následující odkazy: [1] SMS Connector Technický popis rozhraní webových služeb [2] SMS Connector Technický popis rozhraní HTTP GET POST 2. Rozšíření o SMS Redirector - principy SMS Redirector je rozšířením služby Eurotel SMS Connector. Nabízí zákazníkům využívajícím SMS Connector možnost přijímat SMS zprávy odesílané zákazníky z jiných (než Eurotel) mobilních sítí, zákazníci služby SMS Connector si tedy mohou vytvořit nové scénáře pro využití této služby. Specifické otázky spojené s rozšířením služby o SMS Redirector jsou popsány dále v textu. 2.1. Čísla aplikací a jejich dostupnost V současné době je ke každé business aplikaci přiřazeno číslo business aplikace (BA) v tomto formátu 1991xxx. V případě zpráv odesílaných z mobilního zařízení jsou tato čísla dosažitelná pouze z přístrojů, které zákazníci používají v mobilní síti Eurotelu, pro zákazníky ostatních mobilních operátorů jsou nedostupná. Aby bylo možné přijímat SMS zprávy odesílané zákazníky z mobilních přístrojů fungujících v sítích ostatních mobilních operátorů, byla zavedena čísla MSISDN aplikace: každý z partnerů obdrží společně s číslem business aplikace ve formátu 1991xxx i číslo MSISDN aplikace v
5 následujícím formátu +420720001xxx. Číslo MSISDN aplikace je přístupné globálně zprávy na Eurotel SMS Connector přes něj mohou posílat i zákazníci ostatních mobilních sítí. Mezi těmito dvěma druhy čísel aplikací neexistuje žádná vazba. Pro SMS zprávy generované aplikací je možné použít oba formáty čísla odesilatele: zprávy budou vždy doručeny na zákazníkův mobilní telefon. Pokud ale vyvíjíte službu umožňující odpovědět na původní zprávu odeslanou aplikací, nezapomeňte, že mobilní zařízení odpověď zasílají na přednastavené číslo odesilatele, a že pokud je touto přednastavenou volbou číslo 1991xxx, odpovědi odesílané zákazníky jiných sítí než sítě Eurotelu nikdy do SMS Connector aplikace nedorazí. 2.2. Omezení vztahující se na přípony k číslům MSISDN aplikace Partnerské aplikace nesmějí k číslům aplikací ve formátu MSISDN přidávat přípony, toto omezení platí pro SMS odesílané z mobilních telefonů i z aplikací. Omezení vychází z obecných možností MSISDN čísel a z obecných garantovaných funkcí SMS center. Pokud tedy chcete přijímat i zprávy odesílané z mobilních telefonů zákazníků jiných mobilních sítí a přenášet pomocí zpráv dodatečné informace, je vhodnější místo přidávání přípon k číslu aplikace využít v SMS zprávách klíčová slova. 2.3. Zkušební provoz SMS Connector Díky rozšíření služby o SMS Redirector a díky funkcím umožňujícím přenositelnost mobilních čísel se zjednodušuje i zkušební režim služby SMS Connector. Původně bylo možné využít dva zkušební režimy: ET Only a All. Režim ET Only umožňoval zdarma rozesílat SMS generované aplikací zákazníkům společnosti Eurotel, posílání zpráv zákazníkům jiných sítí nebylo povoleno. Režim All umožňoval rozesílat SMS generované aplikací zákazníkům společnosti Eurotel i zákazníkům jiných mobilních operátorů, zprávy zasílané zákazníkům ostatních mobilních operátorů ale byly zpoplatněny. Nový zjednodušený zkušební režim služby SMS Connector odpovídá režimu All. 2.4. Na velikosti písma nezávislé názvy parametrů na HTTP GET/POST Na základě zpětné vazby, kterou nám poskytli zákazníci využívající službu SMS Connector, jsme se na rozhraní HTTP GET/POST rozhodli zavést na velikosti písma nezávislé (case insensitive) názvy http parametrů. Parametry nezávislé na velikosti písma byly zavedeny i všude jinde, kde to bylo možné. Usnadní se tak vývoj podle potřeb zákazníka upravovaných business aplikací využívajících rozhraní HTTP GET/POST.
6 3. Rozšíření SMS Redirector změny rozhraní Partneři mohou se službou SMS Connector komunikovat pomocí dvou rozhraní Web Services a HTTP GET/POST. Do těchto rozhraní byly s ohledem na zpětnou kompatibilitu zapracovány principy a funkce popsané v kapitole 2. 3.1. Rozšířené rozhraní webových služeb HTTP GET/POST rozhraní služby SMS Connector bylo rozšířeno tak, aby bylo možné podporovat i přijímání/odesílání zpráv odesílaných aplikací z MSISDN čísel. Rozhraní je zpětně kompatibilní. Pro rozhraní webových služeb nebyly definovány žádné nové parametry, WSDL popis služby SMS Connector se nemění. Znění těchto parametrů bylo přizpůsobeno nové funkconalitě: fromnumber, tonumber. Byly zavedeny nové kódy pro odpovědi: EAPP_060, EFMT_010. Znění kódů odpovědí bylo přizpůsobeno nové funkcionalitě: EAPP_020. Následující kódy odpovědí se již nepoužívají: EAPP_022. Více informací o parametrech rozhraní naleznete v dokumentu [1], kapitola 5.2. Data. Více informací o kódech pro odpovědi naleznete v dokumentu [1], kapitola 15. Příloha H: Kódy odpovědí. 3.2. Rozšířené rozhraní HTTP GET/POST HTTP GET/POST rozhraní služby SMS Connector bylo rozšířeno tak, aby mohlo podporovat i přijímání/odesílání zpráv odesílaných aplikací z MSISDN čísel. Rozhraní je zpětně kompatibilní. Nové parametry rozhraní jsou: fromnumber. Znění těchto parametrů bylo přizpůsobeno nové funkcionalitě: suffix, tonumber. Nové kódy odpovědí: EAPP_060, EFMT_009, EFMT_010, EFMT_011, EFMT_012. Znění kódů odpovědí bylo přizpůsobeno nové funkcionalitě: EAPP_020. Následující kódy odpovědí se již nepoužívají: EAPP_022. Více informací o parametrech rozhraní naleznete v dokumentu [2], kapitoly 5.2. Vstupní parametry BA a 5.4. Výstupní parametry MP.
7 Více informací o kódech pro odpovědi naleznete v dokumentu [2], kapitola 8. Příloha A: Kódy odpovědí. 4. Možné problémy s novou verzí SMS Connector Změny na obou rozhraních, tj. HTTP GET/POST rozhraní a rozhraní webových služeb, byly navrženy jako zpětně kompatibilní; Eurotel se snažil předejít jakýmkoliv problémům s kompatibilitou u aplikací, které klienti již vyvinuli a používají. V případě, že partnerova business aplikace přesně nesplňuje požadavky pro partnerská rozhraní a spoléhá se na nezdokumentované a nezaručené prvky, mohou se u jednotlivých business aplikací objevit menší problémy s kompatibilitou. Tyto problémy jsou popsány v následujících podkapitolách. 4.1. HTTP GET/POST názvy parametrů napsané nesprávnými znaky Pokud stávající partnerská business aplikace používala nesprávně uváděný název parametru (například Priorita místo priorita ), předcházející verze služby SMS Connector nerozšířená o SMS Redirector tento parametr ignorovala. U nových verzí služby SMS Connector se tento parametr uplatňuje a jeho hodnota bude využita při zpracování. Může tedy dojít k narušení podmínek, na kterých je partnerská aplikace založena, a ke změnám ve fungování aplikace. POZNÁMKA: Právě tento problém Eurotel odhalil u současné verze aplikace SMS Manažer, která je v současnosti distribuována zdarma společně se službou SMS Connector. V případě SMS Manažer byla ale učiněna výjimka, protože tuto aplikaci poskytuje Eurotel a je využívána velkým množstvím zákazníků: služba SMS Connector byla tedy upravena tak, aby s aplikací spolupracovala i přes to, že nefunguje správně, není tedy nutné aplikaci nyní měnit nebo aktualizovat. V budoucnu ale tuto korekci nesprávné hodnoty parametru odstraníme. Eurotel tedy doporučuje všem zákazníkům využívajícím SMS Manažer, aby si instalovali jeho novou verzi, jakmile bude k dispozici. Pouze s ní bude možné využívat nový SMS Redirector. 4.2. Pořadí při ověřování parametrů
8 Pořadí, ve kterém jsou ověřovány hodnoty parametrů zpráv, není garantováno a partnerská aplikace se na něj nesmí spoléhat. Například partnerské aplikaci, která odešle nesprávnou AO zprávu se dvěma chybami, může být v SMS Redirector verzi služby SMS Connector přiřazen jiný chybový kód než v předchozí verzi SMS Connector. Eurotel pořadí, ve kterém jsou zprávy ověřovány, nezaručuje, ani jej v dokumentaci určené pro partnery nepopisuje.