API pro službu Mobilem.cz, verze XML 4.9

Transkript

1 API pro službu Mobilem.cz, verze XML 4.9 Tento dokument je určen pro partnery Mobilem.cz. Není dovoleno obsah použít pro jiný účel než za jakým byl poskytnut. Všechna práva vyhrazena pro DCCI s.r.o. Publikováno: Obsah 1. Obsah Volání API a identifikace pro partnerské portály...2 Obecné parametry Volání API a identifikace pro aplikace...2 Identifikace partnera...2 Autorizace uživatele v požadavku Formát požadavku...3 Testovací parametry...3 Příklad zaslání požadavku Formát odpovědí...3 status= ok...3 status= error...3 API pro JavaHry, mobilní obsah (loga, melodie, obrázky) Typy obsahů Podporované mobilní telefony (pouze pro hry) Podporované mobilní telefony k obsahu Kategorie obsahů Výpis obsahu...6 Společné položky odpovědi...7 Výpis telefonů podporujících listovaný obsah...8 JavaHry contenttype game...8 Melodie contenttype melodie...8 Melodie contenttype tapeta Zakoupení obsahu získání URL...9 Informace o platnosti URL pro download obsahu Zaslání WapPush zprávy Nejstahovanější obsah HiScore Seznam objednávek mobilního čísla Průběh stahování objednávky Výměna nekompatibilního obsahu Skladby Žánry skladeb Interpreti skladeb Top skladeb...15 Zaslání SMS Zaslání SMS...16 Vzhled doručenky em...17 Formát předání doručenky na Zaslání libovolné binární a textové SMS...17

2 2. Volání API a identifikace pro partnerské portály Pokud Vaše aplikace / portál vyžaduje dočasné přihlášení uživatele pro jeho práci, je třeba využít následující způsob volání, který se vyznačuje parametrem SID Session ID. Po přihlášení je uživateli vygenerován SID, který se následně musí předávat při každém dalším požadavku. Uživatel zůstává přihlášen 10 minut od posledního volání API. Obecné parametry Každý požadavek na API rozhraní obsahuje povinné parametry, které slouží k identifikaci partnera. Tyto parametry jsou: cust hash sid První čtyři písmena z přihlašovacího jména (pro DCCI login) partnera Přidělený 32 místný identifikátor. Tento identifikátor se nebude měnit. (pozn.: nejedná se o MD5 hesla) Session ID. Není přítomno při prvním požadavku systém jej vygeneruje a zašle zpět jako součást odpovědi. Klíč HASH je každému partnerovi přidělen individuelně a není možné jej libovolně vygenerovat mimo server DCCI. Jeho přidělení je možné až na základě registrace na DCCI portálu. Přihlášení se pak provádí příkazem login. Tento způsob identifikace uživatele se vylučuje s následující metodou. 3. Volání API a identifikace pro aplikace Toto volání je zjednodušené a nevyžaduje uchovávání údajů na straně aplikace. Díky tomu je však nutné se při každém požadavku autorizovat. Identifikace partnera Každý požadavek na API rozhraní může obsahovat parametry sloužící k identifikaci partnera. Pokud jsou uvedeny, je využívaná služba přičtená na účet partnera, který pak může získávat smluvní provizi ze služby. Tyto parametry jsou: cust hash První čtyři písmena z přihlašovacího jména (pro DCCI login) partnera Přidělený 32 místný identifikátor. Tento identifikátor se nebude měnit. (pozn.: nejedná se o MD5 hesla) Klíč HASH je každému partnerovi přidělen individuelně a není možné jej libovolně vygenerovat mimo server DCCI. Jeho přidělení je možné až na základě registrace na DCCI portálu. Autorizace uživatele v požadavku Pro některé požadavky API (placené a personifikované služby) je nutné se autorizovat systému: login auth Přihlašovací jméno uživatele Autorizační klíč. Jeho hodnota se spočítá jako MD5 hash následujícíh informací zapsaných za sebou bez mezer: MD5 hash hesla Přihlašovací jméno

3 Akce 4. Formát požadavku Prvních 31 znaků zprávy, pokud je kratší, tak méně. Tedy: md5(md5(heslo)+login+action+substring(msg,0,31)) Partnerská SMS brána DCCI je umístěna na adrese: Na toto url se zasílají veškeré požadavky na API. Parametry lze zasílat v GET i POST požadavku. Testovací parametry Tyto testovací parametry použijte pouze pro účely vývoje a ladění vašeho portálu. Bez použití vlastních údajů nemůžete sledovat počty registrovaných uživatelů, počet zaslaných SMS a získávat provizi z využívání služeb. cust hash tros c4ca4238a0b923820d49b Příklad zaslání požadavku &msg=1 5. Formát odpovědí Odpověď na požadavek je zaslána ve formátu XML zprávy. Příklady odpovědí: <?xml version="1.0" encoding="windows-1250"?> <mobilem_api status="ok"> <device> <id>0</id> <name>pro všechny telefony</name> </device> </mobilem_api> Základním tagem je mobilem_api který má povinný parametr status="xx", kde XX je odpověď OK nebo ERROR. status= ok V případě odpovědi OK, se další obsah řídí funkcí, která byl požadována. status= error Příklad chybové odpovědi: <?xml version="1.0" encoding="windows-1250"?> <mobilem_api status="error"> <error> <code>971</code>

4 <message>není vybrána kategorie pro výpis</message> </error> </mobilem_api> Kódy chyb a jejich popis naleznete v následující tabulce: 901 Chyba při přihlášení uživatele (z bezpečnostních důvodů se nerozlišuje chyba jména, nebo hesla) 902 Nízký kredit 903 Služba není aktivovaná 904 Špatný parametr 905 Text SMS je prázdný 906 Číslo příjemce je špatné 907 Špatný AUTH kód 908 Špatný 909 Tento účet již existuje, ale ještě nebyl aktivován 910 Tento účet již existuje 911 Tento účet již existuje, ale je zablokován 912 Špatný typ obsahu 913 Tento kód neobsahuje žádná data 970 Uživatel nemá povoleno listování her Není vybrána kategorie pro výpis 972 Není vybrán typ pro výpis 995 Pro tuto akci musí být uživatel přihlášen 996 Neznámá akce 997 Chyba při identifikaci partnera 998 Služba není dostupná 999 Služba není dočasně dostupná

5 API pro JavaHry, mobilní obsah (loga, melodie, obrázky) Poznámka: Pro používání tohoto API musíte v každém požadavku uvést parametry CUST a HASH a musíte mít povoleno používání tohoto API u DCCI s.r.o. Poznámka: Vzhledem k tomu, že strom kategorií a položky v něm je relativně neměnný údaj, doporučujeme jej ukládat to lokální paměti cache (databáze) a aktualizovat jen cca 1x týdně, nebo po spuštění aplikace. 6. Typy obsahů Typ obsahu se určuje ve vybraných požadavcích na API. Jedná se o parametr contenttype. Pokud je možno upřesnit subtyp, pak se jedná o parametr contentsubtype. game melodie tapeta schemata animace zvuky Java hry Melodie - rozlišujeme dále na subtypy: poly nokiamel ems realtone Barevná tapeta Schémata na mobilní telefony. Rozlišujeme dále na subtypy: schemata101x80 schemata128x160 nokia_s60_176x208 nokia_s40_128x128 se_300_500_700_1010 Animovaný GIF obrázek Různé zvuky pískání, chrochtání, Podporované mobilní telefony (pouze pro hry) Parametry příkazu: action Hodnota gamedevices <items> <item> <id>2</id> <name>alcatel 715</name> <shortname /> <maker>alcatel</maker> <color>0</color> </item> </items> 8. Podporované mobilní telefony k obsahu Parametry příkazu:

6 action contenttype Hodnota subtypedevices Typ obsahu, který chcete zobrazit. Neuvedete-li tento parametr, vylistují se všechny kompatibility <device name="sonyericsson K500c"> <scheme type="schemata128x160" /> <scheme type="se_300_500_700_1010" /> <audio group="poly" type="midi" /> <audio group="real" type="mp4" /> <audio group="real" type="amr" /> <video type="3gpp" /> </device> Význam položek: scheme audio video Schéma na mobilní telefon. V parametru type je uveden název používaný v parametrech contentsubtype. V parametru group je uvedena kategorie podpory (polyfonní melodie, reálná melodie). V parametru type je pak její skutečný formát. V parametru type je skutečný formát video souboru. 9. Kategorie obsahů Parametry příkazu: action lang contenttype Hodnota listcat Jazyk, Parametr je povinný. Dostupné jazyky jsou: cz sk es en Typ obsahu, pro který chcete zobrazit kategorie. <items> <item> <id>1</id> <name>arcade Games</name> </item> <item> <id>2</id> <name>plošinovky</name> </item> </items> 10.Výpis obsahu Parametry příkazu:

7 action contenttype contentsubtype type msg device_id start count lang Hodnota listcontent Typ obsahu, který chcete zobrazit. Povinné SubTyp obsahu, který chcete zobrazit. Volitelné u typů kde má význam (melodie, schemata) Upřesnění požadovaného výpisu: top 10 nejoblíbenějších new 10 nových all veškerý obsah v dané kategorii Pro typ all je vhodné uvést kategorii.seznam kategorií a jejich ID je možné získat příkazem listcat. Bez uvedení kategorie se vylistuje veškerý obsah pozor, může se jednat až to tisíce položek. Omezení výpisu pro vybraný telefon. Seznam telefonů a jejich ID je možné získat příkazem gamedevices. Tento parametr má význam pouze u her. Není povinný. Při omezení výpisu pouze na daný počet položek je možné uvést počátek výpisu. Pro omezení výpisu na počet položek, uveďte počet. Doporučujeme pro tapety a další objemný obsah. Jazyk. Dostupné jazyky jsou: cz sk es en Obsah odpovědi je závislý na obsahu který listujete. Vždy jsou položky uzavřeny v elementu <items>. Detaily každé jednotlivé položky jsou uzavřeny v elementu <item>. Společné položky odpovědi <keywords> <keyword>content</keyword> </keywords> <psms_price>30</psms_price> <psms_count>1</psms_count> <psms_number> </psms_number> <psms>stahuj A </psms> Význam položek: keywords psms_price psms_count psms_number psms Seznam klíčových slov které má obsah přiřazen. Toto klíčové slovo zároveň definuje cenovou hladinu při koupi obsahu přes kredit. Cena jedné Premium SMS pro objednávku. Počet zasílaných Premium SMS. Telefonní číslo pro objednávku obsahu pomocí Premium SMS. Tvar SMS pro objednávku obsahu pomocí Premium SMS. Tato SMS zohledňuje identifikaci partnera pro vyplácení provizí (vlastnost na vyžádání)

8 Výpis telefonů podporujících listovaný obsah V případě výpisu her pro všechny telefony, nebo výpisu obsahu kde se sleduje kompatibilita telefonů (schémata, zvuky, barevná loga), je element <item> rozšířen ještě o element <devices>. <devices> <device>nokia 3650</device> <device>nokia 7650</device> <device>nokia N-Gage</device> <device>siemens SX1</device> <device>samsung E710</device> </devices> JavaHry contenttype game <id>230</ id> <name>air Traffic Control</name> <description>sedíš u radaru přetíženého letiště a další letadla se objevují na obrazovce. Musíš navést letadla na jejich dráhu a pomoci pilotům, aby bezpečně přistáli. Hra má íce než 100 úrovní, tréninkovou úrověň a interaktivní tutorial, který tipomůže zvládnout hektickou úlohu leteckého dispečera. Hodně štěstí - tisíce pasažérů na tebe spoléhá!</description> <img> <siximg> <wapimg> <url_suffix>air_traffic_control.htm</url_suffix> id name description img siximg wapimg img128x128s ID hry. Používejte pro objednání hry. Název hry. Popis hry ve zvoleném jazyce. Odkaz na malý obrázek animovaný gif. Odkaz na obrázek obsahující screenshoty ze hry (3x2 obrázky 128x128). Tato položka není povinná. Odkaz na obrázek pro mobilní telefony. Pole obsahující obrázky 128x128. U hry je přítomno toto pole, nebo položka <siximg>. Příklad: <img128x128s> <img128x128> </img128x128s> Melodie contenttype melodie <id>23610</id> <name>millenium</name> <interpret>robbie Williams</interpret> <subtype>nokiamel</subtype> id name interpret subtype ID melodie. Používejte pro objednání obsahu. Název melodie Interpret melodie Subtyp melodie.

9 Melodie contenttype tapeta <id>810</id> <name>tapeta </name> <img> <wapimg> id name img wapimg ID tapety. Používejte pro objednání obsahu. Název tapety. Odkaz na náhled. Odkaz na náhled pro mobilní telefony. 11.Zakoupení obsahu získání URL Pro tento příkaz musíte být přihlášeni. Do URL je tedy nutné zadat parametry pro autorizaci. Parametry příkazu: action Hodnota sendcontent msg ID obsahu number Telefonní číslo příjemce hry. (na toto číslo nebude obsah zaslán, je nutné pouze pro účely případných reklamací) send Pokud uvedete tento parametr a hodnotu 1, bude zároveň odeslána WapPush zpráva na uvedený mobilní telefon obsahující odkaz na obsah lang Jazyk, Parametr je povinný. Dostupné jazyky jsou: cz sk es en <wappush> <name>název hry</name> <url> <number> </number> </wappush> <credit> </credit> <keyword>premium</keyword> <operator>et</operator> <currency>czk</currency> <authcode>xdycq3zwxj</authcode> <price>45</price> V případě současného odesílání WapPush zprávy je odpověď navíc rozšířena o položku: <sended>1</sended> a cena je zatížena i cenou WapPush SMS zprávy. Kde odpovědi mají následující význam: wappush Struktura obsahující informace pro zaslání obsahu na mobilní telefon. Uporoznění: Toto URL není přístupné jinak než z mobilního telefonu který daný obsah podporuje. binary V případě binárního obsahu (loga, monotónní melodie, EMS zprávy)

10 není v odpovědi položka wappush, ale binary. Obsahuje telefonní číslo, typ obsahu a base64 zakódovaná data obsahu. <binary> <number> </number> <content-type>nokia/logo</content-type> <data>lsdfsdfasasdcas</data> </binary> credit Zbývající kredit na účtě mobilem.cz price Cena za zakoupení obsahu. sended Při posílání WapPush zprávy, je zde úspěšnost poslání: 0 nebo 1 keyword Klíčové slovo definující cenovu hladinu obsahu. operator Kód mobilního operátora (zatím pouze pro českou republiku) Informace o platnosti URL pro download obsahu URL získané tímto příkazem je platné neomezenou dobu. Po prvním přístupu na toto URL je zaznamenán typ telefonu. Po prvním úspěšném stažení JAD souboru a prvním POKUSU o stažení JAR souboru, nebo po prvním POKUSU o stažení obsahu (tapety, melodie, schématu) je započat 10ti minutový interval po který je URL platné. Pokud se nepodaří obsaj během této doby stáhnout, je nutné zahájit reklamační proces. Během reklamace je možné toto URL ještě celkově 5x povolit a to vždy na dobu 10ti minut. Poté je URL zcela zneplatněno. 12.Zaslání WapPush zprávy Pro tento příkaz musíte být přihlášeni. Do URL je tedy nutné zadat parametry pro autorizaci. Parametry příkazu: action msg url number Hodnota sendwappush Popisek k WapPush zprávě URL pro WapPush zprávu. Telefonní číslo příjemce. <credit> </credit> <price>45</price> Kde odpovědi mají následující význam: credit Zbývající kredit na účtě mobilem.cz price Cena za poslání SMS. 13.Nejstahovanější obsah Každý partner si může vyžádat statistiku svého nejstahovanějšího obsahu. Parametry kromě action nejsou povinné. action Hodnota topcontent contenttype Typ obsahu, který chcete zobrazit. keyword Na jaký feed chcete výpis omezit. from Datum od kdy se má statistika počítat a) datum ve formátu (rok, měsíc, den) b) 1d, 7d, (tedy počet dní + písmeno d ) c) 1w, 3w, (tedy počet týdnů + písmeno w ) d) 1m, 2m, (tedy počet měsíců + písmeno m ) to Do kdy se má statistika počítat. Není-li uvedeno, pak to je aktuální datum

11 count Počet listovaných položek <from> :00:00</from> <to> :59:59</to> <feed>game-m</feed> <items> <item> <count>102</count> <content_id>26549</content_id> <name>driv3r</name> </item> <item> <count>73</count> <content_id>464</content_id> <name>chcete být Milionářem</name> </item> </items> 14.HiScore U vybraných her je možné posílat nahrané HiScrore na internet. Toto HiScore pak lze získat pomocí následujícího příkazu. action Hodnota hiscore content_id ID hry, ke které chceme HiScore získat. from Datum od kdy HiScore vypsat to Datum do jakého dne se má HiScore vypsat count Počet listovaných položek Odpověď (pozor vzhledem k mezinárodnímu prodeji her je výstup tohoto API v kódování UTF-8): <groups> <group groupname="amsterdam lap time"> <items rank="1" player="koszter" score="00:11:050" datetime=" :24:23" country="hungary" /> <items rank="2" player=" " score="00:11:000" datetime=" :15:11" country="malaysia" /> </group> </groups> Význam položek v odpovědi: group Seznam výsledků podle speficiké vlasnosti hry kupříkladu obtížnost, závodní trať,.. rank Umístění

12 player score datetime country Jméno hráče Dosažený výsledek (specifický pro hru tedy čas, počet bodů,..) Datum a čas hry Země odkud hráč byl 15.Seznam objednávek mobilního čísla Pro potřeby helpdesku je možné vylistovat seznam objednávek vybraného telefonního čísla. action Hodnota helpdesk number Telefonní číslo <item> <content> <id>30079</id> <name>love generation</name> <content_type>ring/poly</content_type> <content_type_name>melodie</content_type_name> </content> <order> <date> :12:10</date> <number> </number> <code>efp59xzzp</code> <url> </order> <access> <last> :13:39</last> <browser>lg-f2400 MIC/WAP2.0 MIDP-2.0/CLDC-1.1</browser> <wapdevice_id>38277</wapdevice_id> </access> </item> Význam odpovědi: content Informace o objednaném obsahu ID, název, typ, název typu (pro zobrazení obsluze) order Informace o objednáv ce tedy především datum, číslo, kód objednávky (lze použít při výměně, nebo při sledování průběhu objednávky) a URL které lze zákazníkovi znovu přeposlat pro znovustažení obsahu. access Informace o posledním přístupu na wap. 16.Průběh stahování objednávky Pro potřeby helpdesku je možné získat průběh stahování (chování zákazníka na wapu) action Hodnota helpdesk_downloadprogress msg Kód objednávky (z příkazu helpdesk to je order->code) <log> <date> :13:10</date> <log>stažení OMA hlavičky</log> <browser>lg F2400</browser> <browser_id>38277</browser_id> </log>

13 17.Výměna nekompatibilního obsahu Pokud nelze již objednaný obsah doručit z důvodu nekompatibility na telefon, je možné jej vyměnit za jiný ze stejné kategorie / cenové hladiny. action Hodnota contentchange msg AuthCode kód z objednávky (<authcode>xdycq3zwxj</authcode>) newid ID nového obsahu za který se má provést výměna <new_content> <id>26505</id> <name>alpha Wing DEMO</name> </new_content> <old_content> <id>26507</id> <name>caveman DEMO</name> <buy_date> :58:53</buy_date> </old_content> <url> <number> </number> <keywords> <keyword>demo</keyword> </keywords> <result>ok</result> Význam odpovědi: new_content Informace o novém obsahu za který se bude vyměnovat old_content Starý obsah, který se bude nahrazovat url URL na které se po výměně má uživatel přesměrovat (wapové URL) number Telefonní číslo původní objednávky (pro případné zaslání WapPushe) keywords Seznam feedů ve kterých bylo možno provést výměnu her result Výsledek výměny obsahu. Možné varianty: ok Výměna proběhla v pořádku. denied Nelze provést výměnu jiná cenová hladina nového obsahu. locked URL je již uzamčeno, protože zákazník již zahájil stahování původního obsahu. 18.Skladby Vyzváněcí melodie jsou listovány podle subtypu pomocí funkce listcontent, ale pro lepší orientaci na pohodlí zákazníka jsou taktéž setříděny podle jednotlivých skladeb. Je pak tedy možné si nechat vylistovat k jedné skladbě (třeba Dan Bárta On My Head) všehny varianty melodií. Tedy kupříkladu NOKIA melodie, polyfonní melodie, reálná melodie, EMS,.. action Hodnota skladby start Od kolikáté skladby začít listovat. Tento parametr nemá bez parametru count význam count Kolik skladeb listovat.

14 <item> <id>2242</id> <name>boro Boro</name> <interpret_id>783</interpret_id> <zanr_id>10</zanr_id> <contents> <content id="27288" subtype="poly" /> <content id="27287" subtype="nokiamel" /> </contents> </item> Význam odpovědi: id ID skladby. Nelze použít ve funkci sendcontent. Pouze informativní charakter. name Název skladby interpret_id ID interpreta. Seznam interpretů lze získat příkazem skladby_interpret zandr_id ID žánru skladby. Seznam žánrů lze získat příkazem skladby_zanr contents Pole jednotlivých typů melodií pro tuto skladbu. ID lze použít pro objednání funkcí sendcontent a subtype je subtyp dle tabulky Typy obsahů na str Žánry skladeb Požadavek: action Hodnota skladby_zanr <item> <id>10</id> <name>různé</name> </item> 20.Interpreti skladeb Požadavek: Action start count Hodnota skladby_interpret Od kolikátého interpreta začít listovat. Tento parametr nemá bez parametru count význam Kolik interpretů listovat. <item> <id>783</id> <name>arash</name> </item>

15 21.Top skladeb Požadavek: action Hodnota skladby_top start Od kolikátého pořadí začít listovat (počítáno od nuly). Tento parametr nemá bez parametru count význam count Kolik skladeb listovat. <item>783</item>

16 Zaslání SMS 22.Zaslání SMS SMS lze zaslat pouze pokud byl uživatel předem přihlášen. Parametry pro zaslání SMS: action msisdn msg recack recackaddr delay waitfordelivery nosave split nick Hodnota send Telefonní číslo volajícího, kam bude SMS zaslána. Telefonní číslo může být v mezinádordním formátu (tedy +420xxxxxxxxx) nebo v národním formátu (xxxxxxxxx). Akceptovatelná je i stará nula na začátku. Pokud chcete zaslat na více telefonních čísel stejnou SMS zprávu, oddělte seznam čísel čárkou. Text SMS zprávy. Může být libovolně dlouhý, SMS je automaticky rozdělena. Doručenka. Pokud je zde nenulová hodnota, je SMS zaslána s doručenkou. Doručenka je zaslána na mail vyplněný v registraci, není li uvedeno jinak. Cíl doručenky. Pokud je vyžadována doručenka (hodnota recack musí být nenulová), je informace o ní zaslána na tuto adresu. Formát je v URI tvaru. Příklady: mailto: @ .com Nepovinný parametr s časem kdy se má SMS odeslat. Čas je ve formátu: RRRR-MM-DD hh:mm:ss Lze obecně použít všechny formáty podporované příkazem GNU date. Kupříkladu: +1 hour next Monday +1 week 2 days 4 hours 10 September 2003 Uživatel musí mít na svém kontě dostatek prostředků pro odeslání SMS. Tyto prostředky jsou však odečteny až v čase odeslání SMS. Pokud je mezitím vyčerpal, není SMS doručena. Pokud je uvedena adresa pro doručenku, je zaslána informace o nedoručitelnosti. Pokud chce uživatel přijmout i odpověď která nezačíná jeho přezdívkou, zvolte zde nenulovou hodnotu. Platnost SMS session je 24 hodin. Nenulová hodnota znamená, že se odeslaná SMS neuloží do složky odeslané SMS. Ovlivňuje způsob dělení SMS zprávy: concat SMS zpráva se rozdělí po 153 znacích a pošle se jako EMS zpráva (respektive NOKIA Smart Messaging) a pak se na telefonech podporujících EMS standard a na NOKIA telefonech spojí opět do jedné dlouhé SMS zprávy. Pokud chcete, aby SMS začínala přezdívkou uživatele, uveďte nenulovou hodnotu. Odpovědí jsou tyto hodnoty: <mobilem_api status="ok">

17 <sid>jyuynwtckqpmi4efav0</sid> <smsids> <smsid>27001</smsid> <smsid>27002</smsid> </smsids> <price>0</price> <credit>273</credit> <parts>1</parts> <recackaddr /> <gwref>-1</gwref> </mobilem_api> price credit parts recackaddr delay smsid Cena zaslaných SMS Zůstatek na účtě mobilem.cz Počet SMS na kolik byl TEXT rozdělen Cíl doručenky. Čas doručení SMS, pokud je spozděná. Jedinečné ID SMS zprávy která byla odeslána. Pokud je SMS zpráva rozdělena na části, nebo zasíláte na více telefonních čísel, je název parametrů ukončen ještě pořadovým číslem zaslané zprávy (smsid_0, smsid_1, smsid_2, ) Vzhled doručenky em == MOBILEM.CZ * <PARTNER> * SMS brána == Vase sms byla dorucena na cislo <MSISDN>. Zpráva: <msg> Formát předání doručenky na HTTP: Po přijetí doručenky SMS bránou, je vyvoláno uložené URL s následujícími parametry: msisdn msg queuetime deliveredtime Telefonní číslo na které byla SMS doručena Text SMS zprávy Čas kdy byla SMS zařazena do fronty Čas kdy byla SMS doručena na mobilní telefon 23.Zaslání libovolné binární a textové SMS SMS lze zaslat pouze pokud byl uživatel předem přihlášen, nebo v případě app_api současně s autorizací. SMS je účtována jako TEXTová SMS pouze v případě, že neobsahuje UDH a je 7mi bitová. V tomto případě je dlouhý text automaticky rozdělen metodou CONCAT do více SMS, pokud je nutné (tyto SMS se na mobilním přístroji zase spojí dohromady). Parametry pro zaslání SMS: action msisdn Hodnota binsend Telefonní číslo volajícího, kam bude SMS zaslána. Telefonní číslo může

18 být v mezinádordním formátu (tedy +420xxxxxxxxx) nebo v národním formátu (xxxxxxxxx). Akceptovatelná je i stará nula na začátku. msg (7bit, bez UDH) Text SMS zprávy. Může být libovolně dlouhý, SMS je automaticky rozdělena. (7bit, UDH) Text SMS zprávy do max velikosti 160 znaků (8bit, UDH) HEXA kódovaný obsah. Je nutné předat UDH. recack Doručenka. Pokud je zde nenulová hodnota, je SMS zaslána s doručenkou. Doručenka je zaslána na mail vyplněný v registraci, není li uvedeno jinak. recackaddr Cíl doručenky. Pokud je vyžadována doručenka (hodnota recack musí být nenulová), je informace o ní zaslána na tuto adresu. Formát je v URI tvaru. Příklady: mailto: @ .com udh Hlavička SMS zprávy. Vždy je HEXA kódovaná. Př.: FF0201 (toto je první část ze 2 pro dělené SMS) bits Počet bitů. Akceptovatelných je pouze 7 či 8 waitfordelivery Pokud chce uživatel přijmout i odpověď která nezačíná jeho přezdívkou, zvolte zde nenulovou hodnotu. Platnost SMS session je 24 hodin. Odpovědí jsou tyto hodnoty: <mobilem_api status="ok"> <sid>jyuynwtckqpmi4efav0</sid> <price>1.19</price> <credit>273</credit> <parts>1</parts> <recackaddr /> <smsid>27005</smsid> </mobilem_api> price credit parts recackaddr smsid Cena zaslaných SMS Zůstatek na účtě mobilem.cz Počet SMS na kolik byl TEXT rozdělen Cíl doručenky. Jedinečné ID SMS zprávy která byla odeslána. Pokud je SMS zpráva rozdělena na části, jsou jednotlivá ID oddělena čárkou.