ColourSMS Protokol definíció Version 1.2
1.1 HTTP request A ColourSMS(Westel/Pannon) alkalmazások által kiadott HTTP request formátuma a következő:
http://third_party_URL/path_to_application A third_party_URL a Third Party által megadott URL-t jelenti, míg a path_to_application a Third Party által megadott alkalmazás WEB elérési útvonalát jelenti. A kommunikáció során a HTTP protokoll 1.1-es verzióját támogatja a ColourSMS alkalmazás az alábbi megkötésekkel: · · ·
Nem támogatja az SSL/TLS feletti kommunikációt. A HTTP szintű kommunikációban csak a 2xx-es status code-ok értelmezettek. Minden mást – 1xx, 3xx, 4xx, 5xx – hibának vesz az alkalmazás és a továbbítani kívánt SMS “undeliverable” státuszú lesz. Nem támogatja azon WEB server-ekkel történő kommunikációt, mely nem ad vissza Content-Type és Content-Length header-eket, azaz chunked formátumban továbbítja a client fele a válasz üzenetet.
A POST request során használt paraméterek a következőek: Paraméter neve SessionID SrcAddr DestAddr ServiceID Dcs Data · ·
Paraméter jelentése Tranzakció azonosító. Funkciója az adott SMS továbbításának egyértelmű azonosítása. Kötelezően jelen van minden request-ben. Az SMS-t feladó MSIsdn-je. Meglété opcionális. Az alkalmazáshoz kirendelt fogadó MSIsdn. Megléte kötelező. Szolgáltatás média azonosító. Értéke ezen szolgáltatásmál kötelezően ’sms’. Megléte kötelező. GSM 03.38 szerinti data coding schema. Az üzenet HTTP encoded szövege.
Az SrcAddr és DestAddr formátuma 3630xxxxxxx, 3620xxxxxxx vagy 0630xxxxxxx, 0620xxxxxxx formátumú. Dcs értéke 0-255-ig terjedő értéket vehet fel. Szöveges üzenet esetén értéke 0, bináris üzenet (oplogó, csengőhang, stb…) esetén értéke 245.
1.2 XML response Minden HTTP request-re a TPWEB server XML formátumú üzenetben küldi vissza a mobile client számára továbbítandó válaszát mely egy vagy több SMS-t tartalmazhat. A response HTTP headerben a ColourSMS alkalmazás az alábbi paraméterek meglétét ellenőrzi: Paraméter neve Content-Type Content-Length
Paraméter jelentése Értéke kötelezően ‘text/xml’ Az aktuális XML válaszüzenet hossza
Ezen paraméterek hiánya hibás válasz üzenetet feltételez. A XML formátumú üzenet szerkezete a következő:
id = A HTTP kérésben kapott azonosító version = 1.0
::= <Sms> <parameters> <parameters>::= [] [] [] [] [] [] [] []
Tag neve
Leírása
Opcionális
<Sms>
Egy válasz SMS kezdetét jelöli, egy válaszon belül több üzenet is lehet. Egy SMS válasz végét jelöli Speciális SMS paraméter leírása a GSM 03.38 specifikációban
Nem
Bináris üzenetek típusa
Előfizetőknek küldendő üzenet
Formátum
Nem Igen
Igen Igen
Igen Igen
Értéke: 0-255 Jelentése a GSM 03.38ban leirtaknak megfelelő. Bináris SMS esetén értelmezett. Karakteresen ábrázolt hexadecimális érték. Hossza a mezővel együtt 280 karakter Szöveges üzenet esetén max. 160 karakter hosszú iso-8859-1 kódulású szöveg. Bináris üzenetek esetén max. 280 karakter hosszú (a mezővel együtt) karakteresen ábrázolt hexadecimális értékek.
A (megadott érték+1)*5 percig lesz érvényes az üzenet az SMSC-be érkezés pillanatától számítva. Az érvényességi idő lejárta után törlődik az SMSC-ből és a kiküldés sikertelen. A kiküldendő SMS eddig az időpontig lesz érvényes. Ezután az SMSC sikertelennek minősíti a kiküldést és törli az SMS-t. A maximális érvényességi idő 30 perc. Ha értéke –1, akkor az SMSC azonnal megpróbálja kikézbesíteni az SMS-t. Egyébként (megadott érték+1)*5 perc késleltetéssel próbálja küldeni az SMSC az üzenetet. Az SMS kiküldésének időpontja SMS ára
·
Igen Igen
Igen Igen
Értéke: 0-6 Default értéke: 6 (30 perc)
YYYYMMDDHH24MISS pl. 20020329235012 Default értéke: aktuális időpont + 30 perc
Igen Igen
Igen Igen Igen Igen Igen
(-1) – 6 Default: -1
YYYYMMDDHH24MISS pl. 20020329235223 forint.fillér
és egyidejű használata eseten az utolsó értéke a mérvadó. · és egyidejű használata eseten az utolsókent megadott időpont a mérvadó. · A használt XML protokoll verzió száma kötelezően 1.0. Minden ettől eltérő verziószámú XML struktúra használata hibát okoz. · Character encoding kötelezően ISO-8859-1. Ettől eltérő character set használata nem definiált működést eredményez. · A és tag-ek funkciója jelenleg a Westel irányban nem támogatott szolgáltatás. Az alkalmazás ezen tag-eket figyelmen kívül hagyja. · A tag használata esetén a rendszer figyelmen kívül hagyja annak értékét, mivel az értelmezéséhez szükséges Payment gateway jelen pillanatban hiányzik. Használata hibás működést nem okoz. Néhány példa XML üzenet: 1.
Egy két SMS-ből álló válasz üzenet:
<Sms> 2 2 Info válaszüzenet! 240 <Sms> Ez a második szöveg. 240 2.
Egy binary válasz üzenet:
<Sms> 245 060504158200 0012F60300480E018000000000000000010000000000000000000 00000000000000000000000000000000000000000000000000000000000 00000000000000000000000000000000000000000000000000000000000 00000000000000000000000000000000000000000000000000000000000 00000000000000000000800000000000000001
