Ho kenya ts'ebetsong Melaetsa ea SMS 1.0
Litlhaloso
- Lebitso la Sehlahiswa: LINKMobility Mobility Kemplementation Guide Melaetsa ea SMS
1.0 - Mofani: LINK Mobility
- Mosebetsi: Ho fana ka melaetsa, litefo tse nyane, ho ipapisitsoe le sebaka
ditshebeletso - Tšebelisano: PC, mohala oa thekeng, PDA
- Litaba tsa Molao: Thepa e le 'ngoe le litokelo tsa molao tsa Netsize
Litaelo tsa Tšebeliso ea Sehlahisoa
E sebetsa hapeview
Sistimi ea LINK Mobility e fana ka ts'ebetso ea mantlha bakeng sa SMS
melaetsa. SMS Messaging API e etselitsoe ho romella maemo
lekanya melaetsa ea MT SMS ka mokhoa o tšoanang.
Ho romella molaetsa oa SMS
Ho romella molaetsa oa SMS o sebelisa LINK Mobility system, latela
mehato ena:
- Hokela litšebeletso u sebelisa API e fanoeng.
- Ngola molaetsa oa hau ho latela litafole tsa litlhaku tsa GSM
faneng ka. - Romella molaetsa ka mokhoa o ts'oanang ka API.
Ho romella molaetsa oa SMS ho Baamoheli ba Bangata
Haeba o hloka ho romella molaetsa oa SMS ho batho ba bangata ba o amohelang:
- Sebelisa tšebetso ea API ho romella melaetsa ho
dinomoro tse ngata ka nako e le nngwe. - Netefatsa hore nomoro ea moamoheli e hlophisitsoe hantle.
- Romela molaetsa ho baamohedi bohle ka tsela e tshwanang.
LBH
P: Mosebetsi oa mantlha oa LINK Mobility ke ofe
tsamaiso?
A: Ts'ebetso ea mantlha e kenyelletsa ho romella sekhahla se tloaelehileng sa MT SMS
melaetsa ka tsela e tšoanang.
P: Nka romela molaetsa oa SMS joang ke sebelisa LINK Mobility
tsamaiso?
A: O ka romela molaetsa wa SMS ka ho hokela tshebeletsong
sebelisa API e fanoeng, ho ngola molaetsa oa hau, le ho o romella
asynchronously.
LINK Tataiso ea Ts'ebetso ea Mobility Melaetsa ea SMS 1.0
LINK Mobility e fana ka ts'ebeletso ea phano ea melaetsa, litefo tse nyane le lits'ebeletso tse thehiloeng sebakeng. Sethala se sebetsa e le ntho e fumanehang pepeneneng, e nang le li-label tse tšoeu le router ea transaction pakeng tsa Bafani ba Litšebeletso le Basebelisi. Bafani ba Litšebeletso ba hokahana le lits'ebeletso ba sebelisa API e kengoang habonolo mme LINK Mobility e sebetsana le likhokahano tsohle le Basebelisi. Khokahano e ikemetse ho mofuta oa sesebelisoa sa Consumer. Har'a tse ling, sesebelisoa e ka ba PC, mohala oa thekeng kapa PDA.
© LINK Mobility, la 10 Hlakubele 2021
Litaba tsa Molao
Lintlha tse fanoeng tokomaneng ena ke eona feela thepa le litokelo tsa molao tsa Netsize. Ke lekunutu 'me e reretsoe ho sebelisoa ka mokhoa o tiileng oa litaba. Ha e tlame 'me e ka fetoha ntle le tsebiso. Phatlalatso efe kapa efe e sa dumellwang kapa tshebediso e tla nkuwa e le e seng molaong.
Netize TM le linkmobility TM li sirelelitsoe ke melao ea Mafora, EEC le ea machaba ea thepa ea mahlale.
Matshwao a mang kaofela a qotsitsweng ke thepa ya beng ba ona feela.
Ha ho letho le ka har'a mona le tla nkuoa e le ho fana ka laesense kapa tokelo efe kapa efe tlasa patent ea Netsize, copyright, kapa lets'oao la khoebo.
NETSIZE Société anonyme au capital de 5 478 070 euros Siège social :62, avenue Emile Zola92100 Boulogne France 418 712 477 RCS Nanterre http://www.Link Mobility.com http://www.linkmobility.com
Ho Fetola Lipuisano tsa Motho
1
Tafole ea likateng
Sekhahla sa Tokomane…………………………………………………………….. 3
1. Functional Overview ………………………………………………………………………………… 4 1.1 Ho romella molaetsa oa SMS ………………………………………………… ………………………………………. 4 1.2 Ho romela molaetsa wa SMS ho batho ba bangata ba o amohelang ………………………………………………… 6
2. Ho kenngwa ………………………………………………………………………………………………………………………… …………………………………………………………………….. 7 2.1 Web tshebeletso ……………………………………………………………………………………………………… 7 2.3 Tshireletso……………………………………………………………………………………………………………….
3. Ho kopanya molaetsa wa SMS le LINK Mobility……………………………………………………………………………………………………………………………… …………………………. 8 3.1 Papiso ya tshebetso …………………………………………………………………………………………………………………………… ……………………………………………………. 9 3.1.1 Likarolo tseo u ka li khethang ……………………………………………………………………………………………. 9 3.1.2 Tokiso ya MSISDN …………………………………………………………………………………… 9 3.2 Phetoho ea Litlhaku ………………… …………………………………………………………….. 10 3.2.1 Romela kopo ………………………………………………………………… ……………………………………… 10 3.2.2 Romela kopo ea mongolo ……………………………………………………………………………………… …. 11 3.3 Romela karabo …………………………………………………………………………………………………… 11 3.4 Dikhoutu tsa dikarabo …………………… ……………………………………………………………………………… 15 3.5 Nako ea ho bala………………………………………………………… ………………………………………………… 18 3.6 Ho amohela tlaleho ea thomello…………………………………………………………………………… ….. 19 3.7 Kananelo ya Mofani wa Tshebeletso………………………………………………………….. 20 3.8 Leka hape ………………………………………… ……………………………………………………………………………………………………………………………………………… 20 3.9 Maikutlo mabapi le litaba tsa molaetsa oa SMS ……………………………………………… ……… 23
4. Ho kenngwa tshebetsong mohlalaamples………………………………………………………………….. 27 5. Litafole tsa litlhaku tsa GSM …………………………………………………… …………………….. 28
5.1 Tafole ea kamehla ea alfabeta ea GSM (7-bit) ……………………………………………………………………. 28 5.2 Tafole ya katoloso ya dialfabeta tsa kamehla tsa GSM (7-bit)………………………………………………….. 29 6. Acronyms le khutsufatso …………………………………. 30 7. Litšupiso ……………………………………………………………………………………… 30
Ho Fetola Lipuisano tsa Motho
2
Boholo ba Tokomane
Tokomane ena e hlalosa kamoo Mofani oa Litšebeletso a romellang melaetsa ea SMS ka LINK Mobility. E etselitsoe litsebi tsa meralo ea meralo le baqapi ba sebelisang litšebeletso tsa Mofani oa Litšebeletso.
Ho Fetola Lipuisano tsa Motho
3
1. Functional Overview
Sistimi ea LINK Mobility e fana ka ts'ebetso e latelang ea mantlha bakeng sa melaetsa ea SMS:
· Ho romela melaetsa ea SMS ea Mobile Terminated (MT), joalo ka mongolo kapa binary (mohlala, WAP Push) le melaetsa ea maemo a tloaelehileng.
· Ho fumana litlaleho tsa thomello bakeng sa melaetsa e rometsoeng ea MT. · Ho Fumana melaetsa ea SMS ea Mobile Originated (MO), premium le maemo
sekhahla.
SMS Messaging API e ikemiseditse ho romela molaetsa o tlwaelehileng wa MT SMS. API e romella melaetsa eohle ea SMS ka mokhoa o lumellanang, e nolofalletsa likarolo tse kang:
· "Mollo-le-ho lebala" Mofani oa Ts'ebeletso o batla ho ba le linako tse ling tse lebelloang tsa karabo mme ha a batle ho emela sephetho ho tsoa ho Opereishene.
· Leka hape tšebetso LINK Mobility e tla romella molaetsa hape haeba Opereishene e na le mathata a nakoana.
Lintlha tse ling mabapi le ho amohela melaetsa ea MO SMS kapa ho romella melaetsa ea pele ea MT SMS e ka fumanoa mona. Utility SMS API e boetse e fumaneha, e nang le mekhoa e mengata e nolofalitsoeng ea ho romela melaetsa ea SMS, mohlala, WAP push.
Lintlha tse ling mabapi le li-API tsena li fanoe ke LINK Mobility support ha u e kopa.
1.1 Ho romella molaetsa oa SMS
Mofani oa Litšebeletso
Netsize
1. Romela molaetsa oa MT
Moreki
2. Khutlisetsa ID ea molaetsa
3. Kenya molaetsa oa SMS
4. Fana ka tlaleho ea thomello
5. Romela tlaleho ea thomello
Ho Fetola Lipuisano tsa Motho
4
Mokhoa oa mantlha oa ho romella melaetsa ea SMS o hlalosoa ka tsela e latelang:
1. Mofani oa Litšebeletso o etsa kopo ea ho romella moamoheli molaetsa oa SMS ka LINK Mobility system.
2. ID ea molaetsa e khutlisetsoa ho Mofani oa Tšebeletso. ID ena e ka sebelisoa, mohlala, ho hokahanya molaetsa le tlaleho e nepahetseng ea thomello.
3. LINK Mobility e sebetsana le ho tsamaisa le ho fana ka molaetsa oa SMS ho Moreki ea ngotsweng.
Mohato 4 le 5 li etsoa haeba Mofani oa Litšebeletso a kopile tlaleho ea thomello mohatong oa 1.
4. Tlaleho ea thomello e ea hlahisoa, mohlala, ha molaetsa oa SMS o romelloa sesebelisoa sa Moreki.
5. Tlaleho ea phano e romelloa ho Mofani oa Tšebeletso. Tlaleho e na le ID ea molaetsa e ts'oanang le e khutlisitsoeng mohatong oa 2.
Phallo e 'ngoe: Kopo e fosahetseng
Haeba litekanyetso tse fanoeng kapa lintlha tsa mosebelisi kopong (mohato oa 1) li fosahetse, phoso e khutlisetsoa ho Mofani oa Litšebeletso. Phoso e bontša lebaka la ho hana le ho phalla ho fela. Ha ho na ID ea molaetsa e khutlisitsoeng.
Ho Fetola Lipuisano tsa Motho
5
1.2 Ho romella molaetsa oa SMS ho batho ba bangata ba o amohelang
Mofani oa Litšebeletso
Netsize
1. Romela molaetsa oa MT
Moreki
2. Khutlisetsa li-ID tsa melaetsa
3.1. Kenya molaetsa oa SMS #1
3.2. Kenya molaetsa oa SMS #2
3.n. Kenya molaetsa oa SMS #n
5.1. Romela tlaleho ea thomello #1 5.2. Romela tlaleho ea thomello #2 5.n. Romela tlaleho ea delibari #n
4.1. Fana ka tlaleho ea thomello #1 4.2. Fana ka tlaleho ea thomello #2 4.n. Fana ka tlaleho ea delibari #n
LINK Mobility system e ts'ehetsa ho romelloa ha molaetsa oa SMS oa sekhahla se tloaelehileng ho baamoheli ba bangata lethathamong la kabo. Phallo ea motheo e hlalosoa ka tsela e latelang:
1. Mofani oa Litšebeletso o etsa kopo ea ho romela molaetsa o tloaelehileng oa SMS ho batho ba bangata ba o amohelang ka LINK Mobility system.
2. Sistimi ea LINK Mobility e netefatsa syntax ea molaetsa oa SMS, baamoheli le ho tsamaisa molaetsa o mong le o mong oa SMS pele o khutlisetsa li-ID tsa molaetsa ho Mofani oa Ts'ebeletso.
3. LINK Mobility e fana ka molaetsa o le mong oa SMS ho e mong le e mong oa Bareki ba ngolisitsoeng. Sistimi ea LINK Mobility e tla leka ho romella molaetsa oa SMS hape ha o fumana karabo ea phoso e hlalosoang e le ea nakoana. LINK Mobility e tla leka ho romela molaetsa oa SMS hape ho fihlela o felloa ke nako kapa ho fihletsoe moeli oa ho leka hape oa LINK Mobility.
Mohato 4 le 5 li etsoa haeba Mofani oa Litšebeletso a kopile tlaleho ea thomello mohatong oa 1.
4. Tlaleho ea thomello e ea hlahisoa, mohlala, ha molaetsa oa SMS o romelloa seteisheneng sa mobile sa Moreki.
Ho Fetola Lipuisano tsa Motho
6
5. Tlaleho ea thomello e romelloa ho Mofani oa Ts'ebeletso, e nang le ID ea molaetsa e ts'oanang le e khutlisitsoeng mohatong oa 2.
Ho khothaletsoa haholo ho kopa litlaleho tsa thomello ho netefatsa hore Bareki ba fumane molaetsa oa bona oa SMS ka katleho.
2. Ho kenya
LINK Mobility e fana ka API e pepesitsoeng joalo ka web tšebeletso e nang le sebopeho sa SEPAii. Protocol ea SOAP le seva sa Link Mobility li ikemetse ho sethaleng se sebelisoang ke Mofani oa Tšebeletso, le hoja ho kenngoa ha lisebelisoa tsa SOAP ho ka fapana. The web service API e hlalosoa ho WSDLiii.
Bakeng sa ba sa e tsebeng web lits'ebeletso, LINK Mobility e boetse e fana ka sehlopha sa litlelase tsa Java tse hlahisoang ho tsoa ho web tšebeletso WSDL tlhaloso. Litlelase tsena li fanoa ke tšehetso ea Link Mobility ha u e kopa.
2.1 Tšebelisano
Leha ho le joalo web Litšebeletso li sebelisana ho pholletsa le li-platform tse fapaneng ka khopolo, ka linako tse ling ho etsahala hore moralo oa seva le moralo oa bareki ha o lumellane. Ho netefatsa ts'ebelisano 'moho ho li-platform, LINK Mobility web litšebeletso li hahoa le ho netefatsoa ho latela likhothaletso tsa Web Tšebelisano 'moho ea Litšebeletso, WS-Iiv.
WS-I e hloka a web tšebeletso ea ho tšehetsa UTF-8 le UTF-16-sete tsa litlhaku. Link Mobility e tšehetsa ka bobeli, empa ho khothaletsoa ho sebelisa UTF-8.
Tsohle LINK Mobility web litšebeletso li netefalitsoe ka li-platform tse latelang:
· Java · .NET · PHP · Perl · ASP · Ruby · Python
2.2 Web tshebeletso
Ho Fetola Lipuisano tsa Motho
7
The web tshebeletso URL le sebaka sa WSDL file e fanoa ke LINK Mobility support ha e kopa.
2.3 Tshireletso
Ho romela likopo
Bakeng sa netefatso, ID ea mosebelisi le phasewete ea Mofani oa Ts'ebeletso li romelloa sebakeng se seng le se seng web tlhahiso ea litšebeletso. Ke boikarabello ba Mofani oa Litšebeletso ho boloka ID ea mosebelisi le password li sirelelitsoe.
Bakeng sa ts'ireletso ea khokahanyo, LINK Mobility e khothaletsa ka matla tšebeliso ea HTTPS ha o fihlella LINL Mobility web ditshebeletso. Setifikeiti sa seva sa LINK Mobility se saennoe ke Thawte Server CA.
Ho feta moo, ho khothaletsoa ho sebelisa LINK Mobility firewall bakeng sa ho thibela liaterese tse sa tsejoeng tsa IP ho kena akhaonteng ea Mofani oa Litšebeletso. Ikopanye le LINK Mobility support bakeng sa lintlha tse ling.
Ka kopo hlokomela hore HTTP e ts'ehelitsoe ka mabaka a ho lumellana ha morao feela 'me e tla tlosoa nakong e tlang.
Ho fumana litlaleho tsa thomello
Bakeng sa netefatso, ho kgothaletswa hore Mofani wa Tshebeletso a sebedise: · Netefatso ya motheo bakeng sa phihlello mabapi le bona web seva. · Setsi sa mollo, se netefatsang hore ke likopo feela tse tsoang ho LINK Mobility tse lumelletsoeng.
Bakeng sa tshireletso ya kgokelo, ho kgothaletswa hore Mofani wa Tshebeletso a sebedise: · HTTPS bakeng sa phihlello ho bona web seva.
HTTPS sebakeng sa Mofani oa Litšebeletso e ka sebelisoa ka mokhoa o se nang moeli, ha feela setifikeiti sa web seva e saennoe ke setifikeiti sa motso sa CA se kenyellelitsoeng lenaneng la litifikeiti tsa CA tse tšepahalangv.
3. Khokahano ea molaetsa oa SMS le LINK Mobility
Ho Fetola Lipuisano tsa Motho
8
3.1 Ho romella melaetsa ea SMS
Mofani oa Litšebeletso a ka romela melaetsa ea SMS ho Basebelisi ba bona ka LINK Mobility, a sebelisa SMS web tšebeletso API joalokaha ho hlalositsoe khaolong ena.
Phethahatso exampmabapi le mokhoa oa ho ikopanya le LINK Mobility ka lipuo tse fapaneng tsa lenaneo li ka fumanoa khaolong ea 4.
3.1.1Papiso ea ts'ebetso
SMS Messaging API e hlalosa lits'ebetso tse peli tse fapaneng: kopo ea ho romella le kopo ea mongolo. Karolo ena e fana ka tlhalosoview ea ts'ebetso e fanoeng ke ts'ebetso e 'meli le liphapang tsa bohlokoa tsa mabone a phahameng.
Kopo ea ho romela e lebisitsoe maemong a ts'ebeliso e tsoetseng pele haholo moo Mofani oa Ts'ebeletso a nang le taolo e felletseng ea ho fometa melaetsa ho kenyeletsoa le hlooho ea data ea mosebelisi. E tšehetsa GSM Default, Unicode, le binary Data Coding Schemes. Mofani oa Ts'ebeletso a ka romella melaetsa e kopaneng, empa tokiso ea data ea mosebelisi le hlooho ea data ea mosebelisi e tlameha ho etsoa ke Mofani oa Ts'ebeletso mme molaetsa o tlameha ho romelloa ka likopo tse ngata tsa ho romella ho LINK Mobility.
Kopo ea mongolo e nka hore mongolo oa molaetsa o na le litlhaku tse tsoang ho alfabeta ea kamehla ea GSM ho kenyelletsa tafole ea katoloso kapa alfabeta ea Unicode. The Data Coding Scheme e lemohuoa ka bo eona ke LINK Mobility ka ho hlahloba litaba tsa mongolo oa molaetsa. Khokahano e iketsang ea molaetsa melaetsang e mengata e tšehetsoa ho isa tekanyong e behiloeng ke Mofani oa Litšebeletso.
Khokahano e ka 'na ea hlokahala haeba bolelele ba mongolo bo feta bolelele ba bolelele bo tšehetsoeng ke Data Coding Scheme e sebelisoang ke mongolo oa molaetsa.
3.1.2Ho sebetsana le boleng ba lintho tseo motho a ka li khethang
Ka kopo hlokomela hore molemong oa ho sebelisana, likarolo tsohle tsa XML ho likopo le likarabo li tlamehile ho latela tlhaloso ea XML, ke hore, li tlameha ho ba teng. Mantsoe a ho hlakisa boleng ba boikhethelo ke:
· Bakeng sa boleng bo felletseng: -1
Ho Fetola Lipuisano tsa Motho
9
· Bakeng sa boleng ba likhoele: #NULL#
Ke habohlokoa ho hlokomela hore litekanyetso tsa likarolo tse hlokomolohuoang li tlameha ho behoa ho litekanyetso tse boletsoeng tlhalosong e tsamaellanang ho fihlela element e tšehetsoa. Sena ke ho etsa bonnete ba hore e tsamaellana le LINK Mobility.
3.2 Likarolo tsa Boikhethelo 3.2.1Tokiso ea MSISDN
Tokiso ea MSISDN ke karolo ea boikhethelo e ka sebelisoang ke LINK Mobility support ha e koptjoa.
Karolo ena e tla lokisa liaterese tsa moo u eang teng le ho li tsamaisana le mokhoa o hlokahalang oa E.164. Ntle le tokiso ea sebopeho, sistimi e ka boela ea etsa ts'ebetso e ikhethileng ea 'maraka joalo ka ho fetolela linomoro tsa machaba tsa Sefora ho lokisa linomoro tsa DOM-TOM (départements et territoires d'outre-mer) ha ho hlokahala.
Ka tlase ke tse 'maloa tsa examplintlha tsa litokiso:
Aterese e Fanoeng +46(0)702233445 (0046)72233445 +460702233445 46(0)702233445 46070-2233445 0046702233445 +46 0(702233445)336005199999 XNUMX-XNUMX XNUMX +XNUMX +XNUMX XNUMX XNUMX XNUMX XNUMX
Aterese ea Sebaka e Lokisitsoeng 46702233445 46702233445 46702233445 46702233445 46702233445 46702233445 46702233445 2626005199999 XNUMX XNUMX XNUMX XNUMX XNUMX XNUMXTOMXNUMX nomoro ea D.
Ho phaella moo, hoa khoneha ho lumella linomoro tsa fono tsa naha bakeng sa 'maraka o khethiloeng. Ha tšobotsi ena e lumelletsoe linomoro life kapa life tsa machaba bakeng sa limmaraka tse ling li tlameha ho romelloa ka letšoao la pele la `+' ho li khetholla ho 'maraka o khethiloeng.
Ka tlase ke tse 'maloa tsa examplitokiso tse entsoeng ha ho sebelisoa Sweden (khoutu ea naha 46) joalo ka 'maraka oa kamehla oa linomoro tsa naha.
Aterese ea moo e eang teng 0702233445 070-2233 445 070.2233.4455 460702233445 +460702233445 +458022334455 45802233445
Aterese e Lokisitsoeng ea Sebaka 46702233445 46702233445 46702233445 46702233445 46702233445 458022334455 Ha e sebetse ho tloha ha lets'oao la `+' le le sieo.
Ho Fetola Lipuisano tsa Motho
10
Hlokomela hore MSISDN e lokisitsoeng e tla sebelisoa ke LINK Mobility mme e tla khutlisetsoa litlalehong tsa thomello.
Ka kopo, ikopanye le LINK Mobility support bakeng sa lintlha tse ling.
3.2.2 Phetoho ea Litlhaku
Phetoho ea litlhaku ke karolo ea boikhethelo e ka sebelisoang ke LINK Mobility support ha e koptjoa.
Karolo ena e tla fetolela litlhaku tsa alfabeta tseo e seng tsa GSM ho data ea mosebelisi (mongolo oa SMS) ho ea ho litlhaku tse lekanang tsa alfabeta ea GSM ha DCS e setetsoe ho "GSM" (17). Bakeng sa mohlalaample "Seqüência de teste em Português" e tla fetoleloa ho "Seqüencia de teste em Portugues".
Ka kopo, ikopanye le LINK Mobility support bakeng sa lintlha tse ling.
3.3 Romela kopo
Karolo ea kopo ea ho romela e hlophisitsoe ka tsela e latelang:
Ho Fetola Lipuisano tsa Motho
11
Likarolo tsa kopo ea ngoana li sebetsoa ke LINK Mobility ka tsela e latelang:
Khokahano ea lintlhaId
originatingAdress
Mofuta oa Khoele
Khoele
M/O/I* Boleng ba kamehla^
O
O
Sistimi e tla beha
boleng haeba
hlophisitsoe le
tshehelitsoe.
Boholo ba bolelele ba 100
16
Tlhaloso
Correlation ID ho boloka tlaleho ea likopo le likarabo tsa SEAP, ho latela khothaletso ea WS-I. Seva e lumellana le boleng bo fanoeng. Ho feta moo, ID ea khokahano e ka sebelisoa e le ID ea kantle kaha e tla kenyelletsoa ho DR mme e bolokoe ka data ea transaction. Hlokomela hore thibelo mabapi le litlhaku tse lumelletsoeng e ka sebetsa. Aterese ea ho qala molaetsa oa SMS o tsoang. Mofuta oa aterese ea ho qala o hlalosoa ke parameter ea orginatorTON. Bolelele ba palo e khuts'oane ke 16. Motho ea romellang linomoro o lekanyelitsoe ho Alfabeta ea kamehla ea GSM e nang le litlhaku tse 11.
Ho Fetola Lipuisano tsa Motho
12
moqapiTON
Lenane O
DestinationAdress String
M
userData userDataHeader
Khoele
O
Khoele
O
DCS
palo yohle O
PID
palo yohle O
jamaaValidityTime palo yohle O
nako ea thomello
Khoele
O
Sistimi e tla beha boleng haeba e hlophisitsoe ebile e tšehetsoa.
Molaetsa o se nang letho Ha ho hlooho ea data ea mosebelisi 17 0 172800 (lihora tse 48) Hanghang
1
40(*)
280 280 3 3 9 25
Bolelele bo phahameng ba baromeli ba MSISDN ke 15 (ho sebelisoa sebopeho se tšoanang le sa elemental Address Address). E ka behoa ho #NULL# ha e qalaAdresse le originatingTON e khethoa ke tsamaiso. Ts'ebetso ena e itšetlehile ka 'maraka le litlhophiso. Ho fumana lintlha tse ling, ka kopo ikopanye le LINK Mobility support. Boitšoaro bo ka fapana ho latela likhokahanyo tsa Opereishene. Aterese e qalang 'mofuta oa nomoro (TON): 0 Nomoro e khutšoanyane ea 1 Alpha number (bolelele bo boholo 11) 2 MSISDN E ka behoa ho -1 ha ho qalaAdresse le originatingTON e tla khethoa ke tsamaiso. Ts'ebetso ena e itšetlehile ka 'maraka le litlhophiso. Ho fumana lintlha tse ling, ka kopo ikopanye le LINK Mobility support. Boitšoaro bo ka fapana ho latela likhokahanyo tsa Opereishene. MSISDN eo molaetsa wa SMS o lokelang ho romelwa ho yona, ho qala ka khoutu ya naha. Example: 46762050312. Bakeng sa limmaraka tse ling (moo Moreki MSISDN e tlamehang ho hlakoloa) boleng bona e ka boela ea e-ba lebitso la alphanumeric, le hlongoang pele ka”#”.
Ho romella molaetsa oa SMS ho baamoheli ba bangata ho tšehetsoa ka ho fana ka lenane la kabo ea li-MSISDN tse arohaneng tsa halofo ea kholo (mohlala 46762050312;46762050313). Baamoheli ba tlameha ho ikhetha ka har'a lethathamo mme lenane la kabo le lekanyelitsoe ho tse 1000 feela. (*) Bolelele ba boleng bo phahameng ha bo sebetse mananeng a kabo. Litaba tsa molaetsa oa SMS. Hlooho ea Lintlha tsa Mosebelisi mmoho le Lintlha tsa Mosebelisi li ka ba le ho fihla ho 140, ke hore, 280 ha e kentsoe hex, octet. Paramethara ena e lula e kentsoe hex. Sekema sa ho khouta data. Boitšoaro bo ka fapana ho latela likhokahanyo tsa Opereishene. Protocol ID. Boitšoaro bo ka fapana ho latela likhokahanyo tsa Opereishene. Nako e nepahetseng ka metsotsoana (e tsamaellanang le nako ea ho romella ho LINK Mobility). Boitšoaro bo ka fapana ho latela likhokahanyo tsa Opereishene. Molaetsa oa SMS o ka romelloa ka nako e liehang ho fihla. Sebopeho: yyyy-MM-dd HH:mm:ss Z, mohlalaample: 2000-01-01 01:01:01 0000.
Ho Fetola Lipuisano tsa Motho
13
boemoReportFlags
palo yohle O
0
lebitso la ak'haonte
Khoele
O
Ho latela
akhaonte
tlhophiso
referenceId serviceMetaData
Khoele
O
Khoele
O
Ha ho boleng bo behiloeng
campaignName
Khoele
O
lebitso la mosebedisi
Khoele
M
password
Khoele
M
* M = E tlamang, O = Ho ikhethela, ke = Ho hlokomolohuoa.
1
50
150 1000 50 64 64
Boitšoaro bo ka fapana ho latela likhokahanyo tsa Opereishene. Kopo ea ho fana ka tlaleho: 0 Ha ho tlaleho ea thomello 1 Tlaleho ea thomello e kopiloeng 9 Tlaleho ea phepelo ea seva e kopiloeng (LINK Mobility ha e fetise tlaleho ho Mofani oa Litšebeletso empa e etsa hore e fumanehe ka litlaleho joalo-joalo) Sebaka sena se lumella LINK Mobility ho tsamaisa melaetsa ea SMS ka mokhoa o bonolo. mokhoa, oo e ka bang kapa ho se be Mofani oa Litšebeletso ka ho khetheha. Bakeng sa ts'ebeliso e tloaelehileng, #NULL# e lokela ho fanoa. Tlhokomeliso: Tšebeliso ea sebaka sena e tlameha ho fanoa ke LINK Mobility. Bakeng sa API ena hangata molaetsa oa ID oa a web khetha ho kena ho odara MO SMS molaetsa. Litšebeletso tsa meta data. E behe ho #NULL# haeba e sa sebelisoe kapa e sa tšehetsoe ke 'maraka. Ena ke lintlha tse khethehileng tsa 'maraka. Ho fumana lintlha tse ling, ka kopo ikopanye le LINK Mobility support. The LINK Mobility transactions ke tagtsoetsoeng ka lebitso lena. E sebelisoa ho hlophisa mesebetsi ka lihlopha ho LINK Mobility litlaleho. Beha #NULL# haeba e sa sebelisoe. Lebitso la mosebelisi la Mofani oa Litšebeletso, le fanoe ke LINK Mobility. Lekunutu la Mofani oa Litšebeletso, le fanoe ke LINK Mobility.
^ Boleng ba kamehla bo sebelisoa haeba boleng ba element bo behiloe lefeela.
Ho Fetola Lipuisano tsa Motho
14
3.4 Romela kopo ea mongolo
Karolo ea kopo ea ho romela e hlophisitsoe ka tsela e latelang:
Likarolo tsa "Send text request" li sebetsa ke LINK Mobility ka tsela e latelang:
Khokahano ea lintlhaId
Mofuta oa Khoele
originatingAdress String
M/O/I* Boleng ba kamehla^
O
O
Sistimi e tla beha
boleng haeba
hlophisitsoe le
tshehelitsoe.
Boholo ba bolelele ba 100
16
Tlhaloso
Correlation ID ho boloka tlaleho ea likopo le likarabo tsa SEAP, ho latela khothaletso ea WS-I. Seva e lumellana le boleng bo fanoeng. Ho feta moo, ID ea khokahano e ka sebelisoa e le ID ea kantle kaha e tla kenyelletsoa ho DR mme e bolokoe ka data ea transaction. Hlokomela hore thibelo mabapi le litlhaku tse lumelletsoeng e ka sebetsa. Aterese ea ho qala molaetsa oa SMS o tsoang. Mofuta oa aterese ea ho qala o hlalosoa ke parameter ea orginatorTON.
Ho Fetola Lipuisano tsa Motho
15
moqapiTON
Lenane O
DestinationAdress String
M
molaetsaText
Khoele
M
maxConcatenatedM integer O melawana
PID
palo yohle O
jamaaValidityTime palo yohle O
Sistimi e tla beha boleng haeba e hlophisitsoe ebile e tšehetsoa.
Molaetsa o se nang letho 3 0 172800 (lihora tse 48)
1
40(*)
39015 3 3 9
Bolelele ba palo e khuts'oane ke 16. Motho ea romellang linomoro o lekanyelitsoe ho Alfabeta ea kamehla ea GSM e nang le litlhaku tse 11. Bolelele bo phahameng ba baromeli ba MSISDN ke 15 (ho sebelisoa sebopeho se tšoanang le sa elemental Address Address). E ka behoa ho #NULL# ha e qalaAdresse le originatingTON e khethoa ke tsamaiso. Ts'ebetso ena e itšetlehile ka 'maraka le litlhophiso. Ho fumana lintlha tse ling, ka kopo ikopanye le LINK Mobility support. Boitšoaro bo ka fapana ho latela likhokahanyo tsa Opereishene. Aterese e qalang 'mofuta oa nomoro (TON): 0 Nomoro e khutšoanyane ea 1 Alpha number (bolelele bo boholo 11) 2 MSISDN E ka behoa ho -1 ha ho qalaAdresse le originatingTON e tla khethoa ke tsamaiso. Ts'ebetso ena e itšetlehile ka 'maraka le litlhophiso. Ho fumana lintlha tse ling, ka kopo ikopanye le LINK Mobility support. Boitšoaro bo ka fapana ho latela likhokahanyo tsa Opereishene. MSISDN eo molaetsa wa SMS o lokelang ho romelwa ho yona, ho qala ka khoutu ya naha. Example: 46762050312. Bakeng sa limmaraka tse ling (moo Moreki MSISDN e tlamehang ho hlakoloa) boleng bona e ka boela ea e-ba lebitso la alphanumeric, le hlongoang pele ka”#”.
Ho romella molaetsa oa SMS ho baamoheli ba bangata ho tšehetsoa ka ho fana ka lenane la kabo ea li-MSISDN tse arohaneng tsa halofo ea kholo (mohlala 46762050312;46762050313). Baamoheli ba tlameha ho ikhetha ka har'a lethathamo mme lenane la kabo le lekanyelitsoe ho tse 1000 feela. (*) Bolelele ba boleng bo phahameng ha bo sebetse mananeng a kabo. Litaba tsa molaetsa oa SMS. The Data Coding Scheme e iphumanela ka bo eona. Merero e tšehelitsoeng ke GSM 7-bit, kapa UCS-2. Theko e lipakeng tsa 1 le 255 moo boleng bo hlalosang hore na ke melaetsa e kae e khokahaneng e amohelehang. Haeba palo ea melaetsa e khokahaneng e feta boleng bona kopo e hloleha. Protocol ID. Boitšoaro bo ka fapana ho latela likhokahanyo tsa Opereishene. Nako e nepahetseng ka metsotsoana (e tsamaellanang le nako ea ho romella ho LINK Mobility).
Ho Fetola Lipuisano tsa Motho
16
nako ea thomello
Khoele
O
Hanghang
boemoReportFlags
Lenane O
0
lebitso la ak'haonte
Khoele
O
Ho latela tlhophiso ea akhaonto
referenceId serviceMetaData
Khoele
O
Khoele
O
Ha ho boleng bo behiloeng
campaignName
Khoele
O
lebitso la mosebedisi
Khoele
M
password
Khoele
M
* M = E tlamang, O = Ho ikhethela, ke = Ho hlokomolohuoa.
25
1
50
150 1000 50 64 64
Boitšoaro bo ka fapana ho latela likhokahanyo tsa Opereishene. Molaetsa oa SMS o ka romelloa ka nako e liehang ho fihla. Sebopeho: yyyy-MM-dd HH:mm:ss Z, mohlalaample: 2000-01-01 01:01:01 0000. Boitšoaro bo ka 'na ba fapana le ho kopanya ha Opereishene. Kopo ea ho fana ka tlaleho: 0 Ha ho tlaleho ea thomello 1 Tlaleho ea thomello e kopiloeng 9 Tlaleho ea phepelo ea seva e kopiloeng (LINK Mobility ha e fetise tlaleho ho Mofani oa Litšebeletso empa e etsa hore e fumanehe ka litlaleho joalo-joalo) Sebaka sena se lumella LINK Mobility ho tsamaisa melaetsa ea SMS ka mokhoa o bonolo. mokhoa, oo e ka 'nang eaba o se ke oa bua ka Mofani oa Litšebeletso ka ho khetheha. Bakeng sa ts'ebeliso e tloaelehileng, #NULL# e lokela ho fanoa. Tlhokomeliso: Tšebeliso ea sebaka sena e tlameha ho fanoa ke LINK Mobility. Bakeng sa API ena hangata molaetsa oa ID oa a web khetha ho kena ho odara MO SMS molaetsa. Litšebeletso tsa meta data. E behe ho #NULL# haeba e sa sebelisoe kapa e sa tšehetsoe ke 'maraka. Ena ke lintlha tse khethehileng tsa 'maraka. Ho fumana lintlha tse ling, ka kopo ikopanye le LINK Mobility support. The LINK Mobility transactions ke tagtsoetsoeng ka lebitso lena. E sebelisetsoa ho hlophisa litšebelisano tsa lihlopha litlalehong tsa Link Mobility. Beha #NULL# haeba e sa sebelisoe. Lebitso la mosebelisi la Mofani oa Litšebeletso, le fanoe ke LINK Mobility. Lekunutu la Mofani oa Litšebeletso, le fanoe ke LINK Mobility.
^ Boleng ba kamehla bo sebelisoa haeba boleng ba element bo behiloe lefeela.
Ho Fetola Lipuisano tsa Motho
17
3.5 Romela karabo
Karolo ea karabo ea ho romela e hlophisitsoe ka tsela e latelang:
Karabo ea ho romella e sebelisoa bakeng sa kopo ea ho romella le ho romella kopo ea mongolo.
Likarolo tsa ngoana karabelo e tsamaisoa ke LINK Mobility ka tsela e latelang:
Element correlationId messageDetails
responseCode
Mofuta
lethathamo la likhoele tsa messa geDetai l palo e felletseng
M/O/I* OM
M
Boleng ba kamehla^
Bolelele bo fetelletseng 100 1000 elements
5
karaboMolaetsa khoele M
200
* M = E tlamang, O = Ho ikhethela, ke = Ho hlokomolohuoa. ^ Boleng ba kamehla bo sebelisoa haeba boleng ba element bo behiloe lefeela.
Tlhaloso
ID e lumellanang ea kopo ea khokahano. Lethathamo la li-ID tsa melaetsa e ikhethang ea LINK Mobility le khoutu ea karabo bakeng sa khoebo e atlehileng kapa e sa fellang, lethathamo le se nang letho le hlolehileng. LINK Khoutu ea karabo ea Mobility 0 e bonts'a tšebetso e atlehileng. Khoutu ea karabelo 50 e supa khoebo e atlehileng hanyane; bonyane molaetsa o le mong o rometsoe ho moamoheli, bona molaetsaDetails bakeng sa likhoutu tsa karabo ea motho ka mong. Khoutu efe kapa efe ea phoso e bontša ho hloleha ho romella. Sheba tafole e arohaneng bakeng sa lethathamo le felletseng la likhoutu tsa likarabo. Tlhaloso ea mongolo oa karabo, mohlala, mongolo oa phoso.
Ho Fetola Lipuisano tsa Motho
18
The messageDetail child elements e sebetsoa ke LINK Mobility ka tsela e latelang:
Element
moo u eang tengAterese ea molaetsaIds
Mofuta
khoele ea khoele
M/O/I*
MM
Boleng ba kamehla^
responseCode
palo e feletseng M
responseMessage
Khoele
M
* M = E tlamang, O = Ho ikhethela, ke = Ho hlokomolohuoa.
Boholo ba bolelele 40 5864
5
200
Tlhaloso
Aterese ea kopo ea sebaka. LINK ID ea molaetsa oa Mobility e ikhethang bakeng sa khoebo e atlehileng, thapo e se nang letho ha e hloleha. Li-ID tsa melaetsa tse 'maloa li khutlisoa haeba molaetsa o hokahantsoe. Li-ID tsa melaetsa li arohane ka halofo ea kholo. Bakeng sa maemo a itseng a phoso ho khutlisetsoa lenane le se nang letho. LINK Khoutu ea karabo ea Mobility 0 e bonts'a tšebetso e atlehileng. Sheba tafole e arohaneng bakeng sa lethathamo le felletseng la likhoutu tsa likarabo. ELA HLOKO: Khoutu ea karabelo 0 e bontša hore molaetsa o reriloe ho tlisoa, eseng hore thomello e atlehileng e entsoe. Tlhaloso ea mongolo oa karabo, mohlala, mongolo oa phoso.
^ Boleng ba kamehla bo sebelisoa haeba boleng ba element bo behiloe lefeela.
3.6 Dikhoutu tsa dikarabo
Likhoutu tse latelang tsa karabo li ka khutlisoa karabong e rometsoeng:
Khoutu 0 1 2 3 4 5 6 7 8 9
Text Success Ho kena ka mokhoa o fosahetseng kapa tšebeliso e sa lumelloeng ea API Consumer e thibetsoe ke Link Mobility Operation ha e fanoe ke Link Mobility Moreki ha a tsejoe ka Link Mobility Consumer e thibetse tšebeletso ena ho Link Mobility Aterese ea ho tloha ha e tšehetsoe ke aterese ea Alpha e sa tšehetsoeng ke Ak'haonte MSISDN aterese ea ho qala ha e tšehetsoe GSM e atolositsoeng ha e tšehetsoe
Tlhaloso E phethiloe ka katleho. Lebitso la mosebelisi kapa password e fosahetseng kapa Mofani oa Litšebeletso o thibetsoe ke LINK Mobility. Moreki o thibetsoe ke LINK Mobility.
Ts'ebetso e koetsoe bakeng sa Mofani oa Litšebeletso.
Moreki ha a tsejoe ke LINK Mobility. Kapa haeba alias e ne e sebelisoa kopong; lebitso ha le fumanehe. Moreki o thibetse tšebeletso ena ho Link Mobility.
Aterese ea ho qala ha e sebetse.
Aterese e tsoang ho alpha ha e tšehetsoe ke akhaonto.
Aterese ea ho qala ea MSISDN ha e tšehetsoe.
GSM e atolositsoeng ha e tšehetsoe.
Ho Fetola Lipuisano tsa Motho
19
10
Unicode ha e tšehetsoe
Unicode ha e tšehetsoe.
11
Tlaleho ea boemo ha e tšehetsoe
Tlaleho ea boemo ha e tšehetsoe.
12
Bokhoni bo hlokahalang ha ho joalo
Bokhoni bo hlokahalang (ntle le bo kaholimo) ba ho romella molaetsa
tshehelitsoe
ha e tšehetsoe.
13
The content provider max
Mofani oa Litšebeletso o romela melaetsa ea SMS ho LINK Mobility le eena
sekhahla sa throttling se feteletsoe
ka potlako.
14
Protocol ID ha e tšehetsoe ke
Protocol ID ha e tšehetsoe.
akhaonte
15
Moeli oa khokahanyo ea melaetsa
Nomoro ea melaetsa e khokahaneng e feta palo e kholo
feteletsoe
kopile.
16
Ha e khone ho tsamaisa molaetsa
LINK Mobility ha e khone ho tsamaisa molaetsa.
17
Nako e thibetsoeng
Ha ea lumelloa ho romella molaetsa ka nako
18
Ts'ebeletso e tlase haholo
Mofani oa litšebeletso o koetsoe ka lebaka la tekanyo e tlase haholo
akhaonto ea mofani
50
Katleho e sa fellang
Katleho e sa fellang ha o romela molaetsa oa SMS ho batho ba bangata ba o amohelang.
99
Phoso ea Kahare ea Seva
Phoso e 'ngoe ea LINK Mobility, ikopanye le LINK Mobility support bakeng sa tse ling
tlhahisoleseding.
100
Aterese ea moo e eang teng e fosahetseng
Aterese ea moo e eang teng (MSISDN, kapa alias) ha e sebetse.
102
ID e fosahetseng (e hokahantsoeng) e sa sebetseng
ID ea boitsebiso ha e sebetse, mohlomong ID ea boitsebiso e se e sebelisoa, le eona
e tsofetseng kapa e sa tsejoeng.
103
Lebitso la ak'haonte le fosahetseng
Lebitso la ak'haonte ha le sebetse.
105
Lintlha tse fosahetseng tsa litšebeletso tsa meta
Lintlha tsa litšebeletso tsa meta ha li sebetse.
106
Aterese ea ho qala e fosahetseng
Aterese ea ho qala ha e sebetse.
107
Moqapi o fosahetseng oa alphanumeric Aterese ea ho qala ka alphanumeric ha e sebetse.
aterese
108
Nako e fosahetseng
Nako ea ho sebetsa ha e sebetse.
109
Nako e fosahetseng ea ho fihla
Nako ea ho fihla ha e ea nepahala.
110
Litaba tse fosahetseng tsa molaetsa/mosebelisi
Lintlha tsa mosebelisi, ke hore, molaetsa oa SMS, ha li sebetse.
data
111
Bolelele ba molaetsa bo fosahetseng
Bolelele ba molaetsa oa SMS ha bo sebetse.
112
Sehlooho se fosahetseng sa lintlha tsa mosebelisi
Sehlooho sa lintlha tsa mosebelisi ha se sebetse.
113
Sekema sa khouto sa data se fosahetseng
DCS ha e sebetse.
114
ID e fosahetseng
PID ha e sebetse.
115
Lifolakha tse fosahetseng tsa tlaleho ea boemo
Litlaleho tsa tlaleho ea boemo ha li sebetse.
116
TON e sa sebetseng
Moqapi TON ha a sebetse.
117
E sa sebetseng camplebitso la aign
The camplebitso la aign ha le sebetse.
120
Moeli o fosahetseng oa boholo
Boholo ba melaetsa e khokahaneng ha bo sebetse.
palo ea khokahanyo
melaetsa
121
Msisdn e fosahetseng
Aterese ea ho qala ea MSISDN ha e sebetse.
aterese
122
ID e fosahetseng ea khokahano
ID ea khokahano ha e sebetse.
3.7 Bala nako ea ho qetela
Kaha lithapeli ho Link Mobility APIs hangata li etsa hore LINK Mobility e hohele lits'ebetso tse ling tsa kantle, joalo ka sistimi ea tefo ea Opereishene le li-SMSC, ho khothaletsoa hore Mofani oa Ts'ebeletso a sebelise nako ea ho bala haholo. Ho eletsoa ho bala nako ea metsotso e 10 bakeng sa likopo tsa HTTP. Ho sebelisa nako ena ea ho qeta nako ho tla sebetsana le linyeoe tse ngata haholo tsa ho qeta nako ea ho bala.
3.8 Ho amohela tlaleho ea phano
Mofani oa Litšebeletso, haeba a lokiselitsoe, a ka kopa litlaleho tsa ho fana ka melaetsa ea SMS kapa litsebiso tsa thomello bakeng sa melaetsa ea MT e rometsoeng. Litlaleho tsena li hlahisoa ho
Ho Fetola Lipuisano tsa Motho
20
Operator SMSC ha molaetsa oa MT o romelloa ho Moreki eo a lokiselitsoeng kapa o hlakotsoe, mohlala, o feletsoe ke nako kapa, ka lebaka le itseng, ha o khone ho tsamaisoa. Ke boemo ba ho qetela ba molaetsa oa SMS feela bo tlaleheloang ho Mofani oa Ts'ebeletso, ke hore, ho tlisoa kapa ho hlakoloa. Tlaleho e le 'ngoe feela ka molaetsa oa MT e hlahisoa. Ha boemo bo hlakotsoe, khoutu ea lebaka e ka sebetsa. Lebaka lena khoutu e bolela lebaka la hore molaetsa oa SMS o se ke oa tlisoa.
Litlaleho li tsamaisoa ka Link Mobility 'me li romelloa ho Mofani oa Litšebeletso ho sebelisoa protocol ea HTTP.
Ho fumana litlaleho, Mofani oa Litšebeletso o hloka ho kenya tšebetsong mohlalaample Java Servlet kapa leqephe la ASP.NET. Ka bobeli li fumana likopo tsa HTTP GET kapa POST.
Mekhahlelo
Kopo e kenyelletsa lintlha tse latelang:
Paramethara MessageId DestinationAddress StatusCode
NakoStamp
Mokhanni
LebakaCode
Tlanya nomoro ea khoele ea khoele
khoele
khoele
palo yohle
M/O /I*
Boleng ba kamehla
Boholo ba bolelele
Tlhaloso
M
22
ID ea molaetsa oa molaetsa oa MT
hore tlaleho ena e lumellana le.
M
40
MSISDN ea Moreki, ke hore
aterese ea moo e eang teng ea MT ea mantlha
molaetsa.
M
1
Boemo ba khoutu bo bontša boemo ba
Molaetsa oa MT.
Likhoutu tsa maemo tse sebetsang ke:
0 e filwe
2 - E hlakotsoe (ho sebetsa khoutu ea mabaka)
M
20
Nako e bontshang nako ya ho beleha
tlaleho e amohetsoe ke LINK Mobility.
Sebaka sa nako sa nakoamp ke CET
kapa CEST (ka nako ea lehlabula joalo ka ha e hlalositsoe
bakeng sa EU).
Sebopeho: yyyyMMdd HH:mm:ss.
M
100
Lebitso la Opereishene le sebelisitsoeng ha
ho romella molaetsa oa SMS kapa ho
lebitso la akhaonto le sebelisitsoeng ha ho romelloa
Molaetsa oa SMS.
Ho fanoe ka lethathamo la li-Operators tse fumanehang
ka LINK Tšehetso ea Mobility.
O
3
Khoutu ea mabaka e bontša hore na ke hobane'ng ha
molaetsa o ile oa fella boemong
hlakotsoe.
Melao ea mabaka e sebetsang ke:
100 E feletsoe ke Nako 101 E Hanne 102 Fomete phoso 103 Phoso e 'ngoe 110 Subscriber tsejoa 111 Subscriber thibetsoe 112 Subscriber ha e fanoa 113 Subscriber ha e fumanehe 120 SMSC hloleha.
Ho Fetola Lipuisano tsa Motho
21
OperatorTimeStamp
khoele
O
Mongolo wa Boemo
khoele
O
CorrelationId
khoele
O
OperatorNetworkCode
palo yohle O
* M = E tlamang, O = Ho ikhethela, ke = Ho hlokomolohuoa.
121 SMSC tšubuhlellano
122 SMSC e sollang
130 Phoso ea mohala
131 Mohopolo wa sediriswa sa letsoho o fedile
Boitšoaro bo ka fapana ho ea ka Opereishene
kopanelo.
20
Nako e bontšang hore na tlaleho e ne e le neng
e qalile ho SMSC ea Opereishene
(haeba e fanoe ke Opereishene).
Sebaka sa nako sa nakoamp ke CET
kapa CEST (ka nako ea lehlabula joalo ka ha e hlalositsoe
bakeng sa EU).
Sebopeho: yyyyMMdd HH:mm:ss.
255
Sebapali bakeng sa lintlha tse ling
ho tsoa ho Opereishene, mohlala, mongolo o hlakileng
tlhaloso ya boemo/lebaka.
Boitšoaro bo ka fapana ho ea ka Opereishene
kopanelo.
100
ID ea khokahano e fanoeng ho
SendRequest kapa SendTextRequest.
6
Khoutu ea Network Network (MCC +
MNC) ea Opereishene.
Mofani oa Litšebeletso o tlameha ho fana ka LINK Mobility ka sepheo URL bakeng sa litlaleho tsa delibari (ka boikhethelo ho kenyelletsa mangolo a netefatso bakeng sa netefatso ea mantlha ea HTTP).
Mofani oa Litšebeletso a ka khetha hore na o sebelisa mokhoa ofe oa HTTP:
· HTTP POST (e khothalelitsoe) · HTTP GET.
Example sebelisa HTTP GET (e rometsoe ka katleho):
https://user:password@www.serviceprovider.com/receivereport? MessageId=122&DestinationAddress=46762050312&Operator=Vodafone&TimeSt amp=20100401%2007%3A47%3A44&StatusCode=0
Example sebelisa HTTP GET (ha e fanoe, Opereishene e fane ka linako tse lingamp bakeng sa ketsahalo):
https://user:password@www.serviceprovider.com/receivereport?MessageId=123 &DestinationAddress=46762050312&Operator=Vodafone&OperatorTimeStamp=2 0100401%2007%3A47%3A59&TimeStamp=20100401%2007%3A47%3A51&Status Code=2&StatusText=Delivery%20failed&ReasonCode=10
Ho Fetola Lipuisano tsa Motho
22
Li-parameter li URL encodedvi.
Khouto ea litlhaku:
Mofani oa Litšebeletso a ka khetha hore na o ka sebelisa khouto ea litlhaku life: · UTF-8 (e khothalelitsoe) · ISO-8859-1.
3.9 Kananelo ya Mofani wa Tshebeletso
Mofani oa Litšebeletso o lokela ho ananela tlaleho e 'ngoe le e 'ngoe ea phano. Kananelo e ka ba e ntle, ke hore, tlaleho e amohetsoeng ka katleho, kapa e mpe, ke hore, ho hloleha.
Ka kopo hlokomela: LINK Mobility e na le nako ea ho bala bakeng sa tumello ea metsotsoana e 30 bakeng sa litlaleho tsa thomello. Nako ea ho felloa ke nako e tla etsa hore thomello e leke hape (haeba leka hape e lumelletsoe) kapa ho hlakoloa ha delibari (haeba leka hape e koetsoe). Sena se bolela hore kopo ea Mofani oa Litšebeletso e tlameha ho netefatsa linako tsa karabo e potlakileng, haholo-holo nakong ea mojaro o phahameng.
Ho khothaletsoa haholo ho ananela tlaleho ea delibari ho LINK Mobility pele o e sebetsa.
Molao oa ho amohela lintho tse ntle le tse mpe o hlalosoa ka tsela e latelang:
Kamohelo e ntle, ACK, tlaleho ea phano e fanoeng: Khoutu ea karabelo e fapaneng ea HTTP 200 hammoho le litaba tse hlophisitsoeng tse latelang tsa XML:
Kamohelo e mpe, NAK, tlaleho ea phano ha e ea fanoa: Karabo efe kapa efe ntle le kananelo e ntle, bakeng sa khale.ampLeha ho le joalo, kananelo e mpe e hlahisoa ke khoutu efe kapa efe ea phoso ea HTTP kapa litaba tse latelang tsa XML:
Litaba tsa XML li ka sebelisoa ho laola mokhoa oa ho leka hape oa Link Mobility. NAK e tla etsa hore motho a leke hape, haeba e nolofalitsoe. Bakeng sa Bafani ba Litšebeletso ba sa hlophisoang bakeng sa mokhoa oa ho leka hape, litaba tsa XML ke tsa boikhethelo.
Ka tlase ke kopo ea HTTP POST le mohlala oa karaboamptlaleho ea phano e romelloang ho Mofani oa Litšebeletso:
Ho Fetola Lipuisano tsa Motho
23
Kopo ea HTTP: POST /context/app HTTP/1.1 Content-Type: application/x-www-form-urlencoded;charset=utf-8 Moamoheli: seva:port Bolelele ba Bolelele: xx
MessageId=213123213&DestinationAddress=46762050312&Operator=Telia & OperatorTimeStamp=20130607%2010%3A45%3A00&TimeStamp=20130607 %2010%3A45%3A02&StatusCode=0
HTTP Response: HTTP/1.1 200 OK Content-Mofuta: text/plain
3.10 Leka hape
Sistimi ea LINK Mobility e ka leka hape ho leka ho hloleha, ke hore, ho sa amoheloe, ho tlisa tlaleho ea delibari. Mofani oa Litšebeletso a ka khetha mokhoa oo u o ratang oa ho leka hape:
· Ha ho na ho leka hape (kamehla) - molaetsa o tla lahloa haeba boiteko ba ho hokahanya bo hloleha, bala nako ea ho tsoa kapa khoutu efe kapa efe ea phoso ea HTTP.
· Leka hape - molaetsa o tla romelloa bakeng sa bothata ba mofuta o mong le o mong oa khokahanyo, ho baloa ha nako e felile, kapa ho hana ho hana.
Ha ho leka hape bakeng sa NAK ho lumelletsoe, ho bohlokoa ho utloisisa hore na ke maemo afe a tla hlahisa teko hape ho tsoa ho LINK Mobility le hore na teko hape e sebetsa joang.
Mofani e mong le e mong oa Tšebeletso o na le lethathamo la hae la ho leka hape, moo melaetsa e laeloang ho latela linako tsa molaetsaamp. LINK Mobility e lula e leka ho fana ka melaetsa ea khale pele, le hoja taelo ea motho ka mong ea melaetsa e romelloang ho Mofani oa Litšebeletso e sa tiisetsoe.
Lebaka le ka sehloohong la hore melaetsa e lahliloe lethathamong la ho leka hape ke le leng la mabaka a mabeli: ebang molaetsa oa TTL o felloa ke nako kapa (ka khopolo) lethathamo la ho leka hape le tlala. TTL ke Opereishene 'me e itšetlehile ka akhaonto, ke hore, e ka fapana ho itšetlehile ka Opereishene le kapa mofuta oa molaetsa, mohlala, premium SMS kapa molaetsa o tloaelehileng oa SMS.
Ho Fetola Lipuisano tsa Motho
24
Bafani ba Litšebeletso ba lumelletsoeng ho leka hape ba tlameha ho hlahloba ID e ikhethileng ea molaetsa oa MT ho netefatsa hore molaetsa ha o so amoheloe.
Ho Fetola Lipuisano tsa Motho
25
Ho bohlokoa hore Mofani oa Litšebeletso a ikamahanye le melao ena e bonolo ha phoso e etsahala nakong ea ts'ebetso ea tlaleho ea phano haeba lebaka la phoso e le:
1. Nakoana, mohlala, database ha e fumanehe, NAK e lokela ho khutlisoa. LINK Mobility e tla romella molaetsa hape.
2. Boiteko bo sa feleng le bo lekang hape bo ka baka mofuta o tšoanang oa bothata, ACK e lokela ho khutlisoa. Bakeng sa mohlalaample, ha molaetsa o ne o sa khone ho aroloa ka nepo kapa o bakile phoso e neng e sa lebelloa ea nako ea ho sebetsa.
Ho sebetsa ka tsela e nepahetseng ho tla etsa bonnete ba hore ha ho na ho thibela kapa ho senyeha ha lihlahisoa ka lebaka la tlaleho ea pelehi e ntse e halefisoa khafetsa.
3.11 Maikutlo mabapi le litaba tsa molaetsa oa SMS
Litaba tsa molaetsa oa SMS, ke hore, paramethara ea data ea mosebelisi, e emeloa ka lialfabeta tse fapaneng ho latela boleng ba DCS. Lintlha tsa motheo li hlalositsoe tafoleng e ka tlase. Lintlha tse ling mabapi le li-alphabets tsa SMS li ka fumanoa ho litlhaloso tsa ETSI bakeng sa SMSvii.
Alfabeta
Lialfabeta tsa kamehla tsa GSM GSM alfabeta e atolositsoeng
Example (DCS / Lintlha tsa mosebelisi) 17 / abc@()/
17 / {}[]
Binary ea UCS2
25 / ©¼ë® 21 / 42696e61727921
Boholo ba bolelele ba 160 <160
70 280
Tlhaloso
Molaetsa o tloaelehileng oa mongolo o sebelisang alfabeta ea kamehla ea GSM, bona khaolo ea 5.1. Molaetsa oa mongolo o sebelisang alfabeta ea kamehla ea GSM le tafole ea katoloso, bona khaolo ea 5.2. Kaha tlhaku e 'ngoe le e' ngoe e tsoang tafoleng ea katoloso e emeloa ke litlhaku tse peli, bolelele ba 'nete bo baloa joalo ka: 160 k, moo k e leng palo ea litlhaku tse atolositsoeng tse sebelisitsoeng molaetseng. Unicode (16 bit), tafole ea litlhaku tsa ISO/IEC 10646. 8-bit data binary molaetsa. Byte e 'ngoe le e' ngoe e emeloa e le boleng ba hex e sebelisang litlhaku tse peli ka byte. Bolelele ba molaetsa o ka holimo ke 140 byte, ke hore litlhaku tse 280 ha li hexencoded.
Bolelele bo boholo ba molaetsa oa SMS bo fokotseha ha bolelele ba hlooho bo ntse bo eketseha ha o romella melaetsa ea SMS ka hlooho ea data ea mosebelisi e boletsoeng.
Ts'ehetso ea lialfabeta tse fapaneng e ka fapana le likhokahanyo tsa Opereishene.
Ho Fetola Lipuisano tsa Motho
26
Ka kopo, hlokomela hore litlhaku tse ling tsa mofuta oa C0 (litlhaku tse laolang nako ea 0x00000x001F) li ke ke tsa emeloa ho XML ka lebaka la moeli ho XML 1.0. E 'ngoe ea litlhaku tsena tse sa tšehetsoeng ke , e kenyellelitsoeng tafoleng ea katoloso ea alfabeta ea GSM. Ho etsa hore ho khonehe ho romella likahare tsa molaetsa ho kenyelletsa le litlhaku tse joalo, mohlala, vCards, LINK Mobility e tšehetsa Unicode escape syntax.
LINK Mobility Unicode escape syntax e ts'oana le polelo ea ho baleha e sebelisoang ke Java Language Specificationviii. Ho latela litlhaku tse phonyohang u tse lateloang ke linomoro tse 'ne tsa hexadecimal tse emelang boleng ba UTF-16 ba sebopeho, uxxxx.
Ba bang ba phonyoha examphanyane:
· u000a – Line feed · u000c – Form feed · u000d – Carriage return · u2603 Snowman
4. Ho kenngwa tshebetsong mohlalaamples
SEAP e etsa hore tharollo e ikemele holima puo ea lenaneo e sebelisoang lehlakoreng la bareki ba Bafani ba Litšebeletso.
The web tšebeletso ea SMS Messaging API e tšoana haholo le web tšebeletso e sebelisoang ho SMS API. Khoutu examptse fumanehang ho tataiso ea SMS API li ka fetoloa habonolo hore li sebelisoe ka API ena.
Ho Fetola Lipuisano tsa Motho
27
5. litafole tsa litlhaku tsa GSM
5.1 Tafole ea kamehla ea alfabeta ea GSM (7-bit)
Tafole ena e bonts'a litlhaku tse ka hlahisoang mehalang eohle ea mehala ea GSM.
b7 0
Binary
b6 0
b5 0
Dec
0
b4 b3 b2 b1
Hex 0
0 0 0 0 0 0 0 0 0 1 0 1 0 1 0 1 1 0
0
0
0
0
@
0
1
1
1
£
1
0
2
2
$
1
1
3
3
¥
0
0
4
4
è
0
1
5
5
é
1
0
6
6
ù
1
1
7
7
ì
0
0
8
8
ò
1 0
0
1
9
9
Ç
1 0
1
0
10 A
LF
1 0
1
1
11 B
Ø
1 1
0
0
12C
ø
1 1
0
1
13 D
CR
1 1
1
0
14 E
Å
1 1
1
1
15 F
å
Bakeng sa mohlalaample, tlhaku “A” e na le tse latelang
boleng:
1) Khoutu ena ke ho phonyoha ho katoloso ea
alfabeta ea kamehla ea 7-bit.
0
0
0
1
1
1
1
0
1
1
0
0
1
1
1
0
1
0
1
0
1
16 32 48 64 80 96 112
10 20 30 40 50 60 70
EA-0-SP
¡
P ¿ leq
_
!
1 AQa q
”
2
BR b
r
#
3
C
S
c
s
¤
4
D
T
d
t
%5
E
U
e
u
&
6
F
V
f
v
‘
7G Wg w
(
8 HXh x
)
9I
Y ke
y
*
:
JZ j
z
1) +;
Ke ho
Æ ,
<L Ke
ö
æ -
= MÑ mñ
ß.
> NÜn ü
É /
?
O §
o
à
Nomoro motheo Decimal Hexadecimal Binary
Palo 64 + 1 40 + 1 b1–b7
Boleng 65 41 1000001
Ho Fetola Lipuisano tsa Motho
28
5.2 Tafole ea katoloso ea alfabeta ea kamehla ea GSM (7-bit)
Tafole ena e bonts'a litlhaku tse atolositsoeng ho alfabeta ea kamehla ea GSM.
b7 0
0
0
0
1
1
1
1
Binary
b6 0
0
1
1
0
0
1
1
b5 0
1
0
1
0
1
0
1
Dec
0
16 32 48 64 80 96 112
b4 b3 b2 b1
Hex 0
10 20 30 40 50 60 70
0 0
0
0
0
0
|
0 0
0
1
1
1
0 0
1
0
2
2
0 0
1
1
3
3
0 1
0
0
4
4
^
0 1
0
1
5
5
0 1
1
0
6
6
0 1
1
1
7
7
1 0
0
0
8
8
{
1 0
0
1
9
9
}
1 0
1
0
10 A
FF
1 0
1
1
11 B
1 1
0
0
12C
[1 1
0
1
13 D
~
1 1
1
0
14 E
]
1 1
1
1
15 F
Ho Fetola Lipuisano tsa Motho
29
6. Lipolelo le likhutsufatso
Likgutsufatso tsohle le likhutsufatso li thathamisitsoe ho Glossaryix.
7. Litšupiso
i LINK Mobility Implementation Guide, SMS 5.2, 22/155 19- FGC 101 0169 Uen ii SOAP, http://www.w3.org/TR/SOAP/ iii WSDL, http://www.w3.org/TR/ wsdl iv WS-I, http://www.ws-i.org/ v LINK Mobility Implementation Guide, Trusted CA Certificates, 11/155 19-FGC 101 0169 Uen vi Uniform Resource Identifiers, http://www.ietf. org/rfc/rfc2396.txt vii ETSI TS 100 900 V7.2.0 (GSM 03.38 version 7.2.0), Alfabeta le lintlha tse khethehileng tsa puo viii LINK Mobility Implementation Guide Sehlomathiso, Tsebiso ea ho Chaja, 10/155x19 101 LINK Mobility Kemplementation Guide Sehlomathiso, Glossary, 0169/36 155-FGC 19 101 Uen
Ho Fetola Lipuisano tsa Motho
30
Litokomane / Lisebelisoa
![]() |
khokahano ea motsamao Ho kenya tšebetsong melaetsa ea SMS 1.0 [pdf] Bukana ea Mosebelisi 1.0, Ho kenya tšebetsong Melaetsa ea SMS 1.0, Melaetsa ea SMS 1.0, Melaetsa 1.0 |