Cur an gnìomh Teachdaireachdan SMS 1.0
Sònrachaidhean
- Ainm Bathar: Teachdaireachd SMS Stiùireadh Gnìomh Gluasaid LINK
1.0 - Solaraiche: LINK Mobility
- Gnìomhachd: Lìbhrigeadh teachdaireachd, meanbh-phàighidhean, stèidhichte air àite
seirbhisean - Co-fhreagarrachd: PC, fòn-làimhe, PDA
- Fiosrachadh laghail: Seilbh a-mhàin agus dlighe-sgrìobhaidh Netsize
Stiùireadh airson cleachdadh bathar
Gnìomh thairisview
Tha siostam LINK Mobility a’ toirt seachad comas-gnìomh bunaiteach airson SMS
brathan. Tha an SMS Messaging API coisrigte airson inbhe a chuir
dèan measadh air teachdaireachdan SMS MT gu neo-chunbhalach.
A 'cur teachdaireachd SMS
Gus teachdaireachd SMS a chuir a’ cleachdadh an t-siostam LINK Mobility, lean
na ceumannan seo:
- Ceangail ris an t-seirbheis a’ cleachdadh an API a chaidh a thoirt seachad.
- Sgrìobh do theachdaireachd a rèir clàran caractar GSM
air a thoirt seachad. - Cuir an teachdaireachd gu neo-chinnteach tron API.
A’ cur teachdaireachd SMS gu ioma luchd-faighinn
Ma dh'fheumas tu teachdaireachd SMS a chuir gu grunn luchd-faighinn:
- Cleachd comas-gnìomh an API airson teachdaireachdan a chuir gu
ioma-àireamhan aig an aon àm. - Dèan cinnteach gu bheil àireamh gach neach a gheibh an cruth ceart.
- Cuir am brath chun a h-uile neach a gheibh e gun choimeas.
Ceistean Cumanta
C: Dè am prìomh fheart a tha aig LINK Mobility
siostam?
A: Tha am prìomh ghnìomhachd a’ toirt a-steach a bhith a’ cur SMS MT ìre àbhaisteach
teachdaireachdan gu neo-chunbhalach.
C: Ciamar a chuireas mi teachdaireachd SMS a’ cleachdadh an LINK Mobility
siostam?
A: Faodaidh tu teachdaireachd SMS a chuir le bhith a’ ceangal ris an t-seirbheis
a’ cleachdadh an API a chaidh a sholarachadh, a’ sgrìobhadh do theachdaireachd, agus ga chur
gu neo-chinnteach.
Teachdaireachdan SMS Stiùireadh Gnìomh Gluasaid LINK 1.0
Tha LINK Mobility a’ toirt seachad seirbheis airson lìbhrigeadh teachdaireachd, meanbh-phàighidhean agus seirbheisean stèidhichte air àite. Bidh an àrd-ùrlar ag obair mar neach-ceannach susbaint soilleir, leubail geal agus router malairt eadar Solaraichean Seirbheis agus Luchd-obrachaidh. Bidh na Solaraichean Seirbheis a’ ceangal ris an t-seirbheis a’ cleachdadh API a tha furasta a chuir an gnìomh agus bidh LINK Mobility a’ làimhseachadh gach aonachadh leis na Gnìomhaichean. Tha an eadar-aghaidh neo-eisimeileach bho sheòrsa inneal an neach-cleachdaidh. Faodaidh an inneal a bhith na PC, fòn-làimhe no PDA.
© LINK Mobility, 10 Màrt, 2021
Fiosrachadh laghail
Is ann le seilbh agus dlighe-sgrìobhaidh Netsize a-mhàin a tha am fiosrachadh a gheibhear san sgrìobhainn seo. Tha e dìomhair agus an dùil airson cleachdadh fiosrachaidh teann. Chan eil e ceangaltach agus dh’ fhaodadh gun tèid atharrachadh gun rabhadh. Bithear a’ meas gu bheil foillseachadh no cleachdadh gun chead sam bith mì-laghail.
Tha NetsizeTM agus linkmobilityTM air an dìon le laghan Frangach, EEC agus seilbh inntleachdail eadar-nàiseanta.
Is ann leis an luchd-seilbh aca a tha a h-uile comharra-malairt eile a chaidh ainmeachadh.
Cha tèid dad a tha an seo a mhìneachadh mar bhith a’ toirt seachad cead no còir fo peutant Netsize, dlighe-sgrìobhaidh no comharra-malairt.
NETSIZE Société anonyme au capital de 5 478 070 euros Siège social : 62, avenue Emile Zola92100 Boulogne An Fhraing 418 712 477 RCS Nanterre http://www.Link Mobility.com http://www.linkmobility.com
Ag atharrachadh Conaltradh Pearsanta
1
Clàr-innse
Farsaingeachd na sgrìobhainn ……………………………………………………….. 3
1. Functional Overview ………………………………………………………………… 4 1.1 A’ cur teachdaireachd SMS …………………………………………………………………………… …………………………. 4 1.2 A’ cur teachdaireachd SMS gu grunn luchd-faighinn …………………………………………………………………………… 6
2. Stàladh ……………………………………………………………………………………… 7 2.1 Eadar-obrachail …………………………… ……………………………………………………….. 7 2.2 Web seirbheis ………………………………………………………………………………………. 7 2.3 Tèarainteachd …………………………………………………………………………………………….. 8
3. Amalachadh teachdaireachdan SMS le Gluasad LINK………………………………………………………………………… 8 3.1 A’ cur teachdaireachdan SMS ………………………………………………………… ……………………………. 9 3.1.1 Coimeas obrachaidh ………………………………………………………………………… 9 3.1.2 A’ làimhseachadh luachan eileamaid roghainneil …………… ……………………………………………. 9 3.2 Feartan Roghainneil ………………………………………………………………………………………. 10 3.2.1 Ceartachadh MSISDN …………………………………………………………………………… 10 3.2.2 Caractaran ùr ………………… ……………………………………………………….. 11 3.3 Cuir iarrtas ……………………………………………………………………………………… …………………………… 11 3.4 Cuir iarrtas teacsa ……………………………………………………………………………… …. 15 3.5 Cuir freagairt ……………………………………………………………………………………… 18 3.6 Còdan freagairt ………………………… ………………………………………………………………… 19 3.7 Leugh an ùine-ama …………………………………………… 20 3.8 A’ faighinn aithisg lìbhrigidh ………………………………………………………………………… ….. 20 3.9 Aithneachadh an t-solaraiche seirbheis……………………………………………………………………………….. 23 3.10 Feuch a-rithist …………………………………… ………………………………………………………………… 24 3.11 Beachd air susbaint na teachdaireachd SMS …………………………………………………………………………… …… 26
4. Cur an gnìomh examples……………………………………………………………………………….. 27 5. Clàran charactaran GSM ……………………………………………… ………………… 28
5.1 Clàr na h-aibideil àbhaisteach GSM (7-bit) ………………………………………………………………. 28 5.2 Clàr leudachaidh na h-aibideil àbhaisteach GSM (7-bit)………………………………………………………………………….. 29 6. Acronyms agus giorrachaidhean ……………………………… …………………………. 30 7. Tùsan …………………………………………………………………………… 30
Ag atharrachadh Conaltradh Pearsanta
2
Farsaingeachd na Sgrìobhainn
Tha an sgrìobhainn seo ag innse mar a bhios an Solaraiche Seirbheis a’ cur teachdaireachdan SMS tro LINK Mobility. Tha e airson ailtirean teignigeach agus dealbhadairean a bhios a’ cur an gnìomh seirbheisean an t-Solaraiche Seirbheis.
Ag atharrachadh Conaltradh Pearsanta
3
1. Functional Overview
Tha siostam LINK Mobility a’ toirt seachad na feartan bunaiteach a leanas airson teachdaireachdan SMS:
· A’ cur teachdaireachdan SMS Crìochnaichte Fòn-làimhe (MT), leithid teachdaireachdan teacsa no binary (me WAP Push) agus teachdaireachdan ìre àbhaisteach.
· A’ faighinn aithisgean lìbhrigidh airson teachdaireachdan MT a chaidh a chuir a-steach. · A’ faighinn teachdaireachdan SMS bho thùs gluasadach (MO), àrd-ìre agus àbhaisteach
ìre.
Tha an SMS Messaging API gu sònraichte airson teachdaireachdan MT SMS aig ìre àbhaisteach a chuir. Bidh an API a’ cur a h-uile teachdaireachd SMS gu co-shìnte, a’ comasachadh feartan leithid:
· “Teine-is-dìochuimhnich” tha an Solaraiche Seirbheis ag iarraidh amannan freagairt nas ro-innseachail agus chan eil e airson feitheamh ri toradh bhon Ghnìomhaiche.
· Cuir a-rithist gnìomhachd LINK Mobility ath-chuireas an teachdaireachd ma tha duilgheadasan sealach aig a’ Ghnìomhaiche.
Gheibhear tuilleadh fiosrachaidh mu bhith a’ faighinn teachdaireachdan MO SMS no a’ cur prìomh theachdaireachdan MT SMS ini. Tha API SMS goireasach ri fhaighinn cuideachd, anns a bheil grunn obrachaidhean nas sìmplidhe airson teachdaireachdan SMS a chuir, me putadh WAP.
Tha tuilleadh fiosrachaidh mu na APIan sin air a thoirt seachad le taic LINK Mobility ma thèid iarraidh.
1.1 A’ cur teachdaireachd SMS
Solaraiche Seirbheis
Meud lìon
1. Cuir teachdaireachd MT
Luchd-cleachdaidh
2. Till teachdaireachd ID
3. Cuir a-steach SMS teachdaireachd
4. Lìbhrigeadh aithisg lìbhrigidh
5. Cuiribh aithisg lìbhrigidh
Ag atharrachadh Conaltradh Pearsanta
4
Tha an sruth bunaiteach airson teachdaireachdan SMS a chuir air a mhìneachadh mar a leanas:
1. Bidh an Solaraiche Seirbheis ag iarraidh teachdaireachd SMS a chuir gu neach a gheibh e tro shiostam LINK Mobility.
2. Thèid ID teachdaireachd a thilleadh chun t-Solaraiche Seirbheis. Faodar an ID seo a chleachdadh airson me an teachdaireachd a cho-cheangal ris an aithisg lìbhrigidh cheart.
3. Bidh LINK Mobility a’ làimhseachadh slighe agus a’ lìbhrigeadh an teachdaireachd SMS don neach-cleachdaidh ris an deach dèiligeadh.
Tha ceumannan 4 agus 5 air an cur an gnìomh ma dh’ iarr an Solaraiche Seirbheis aithisg lìbhrigidh ann an ceum 1.
4. Tha aithisg lìbhrigidh air a phiobrachadh, me nuair a thèid an teachdaireachd SMS a lìbhrigeadh gu inneal an Neach-cleachdaidh.
5. Thèid an aithisg lìbhrigidh a chuir chun t-Solaraiche Seirbheis. Tha an aon ID teachdaireachd san aithisg agus a chaidh a thilleadh ann an ceum 2.
Sruth eile: Iarrtas neo-dhligheach
Ma tha na paramadairean a chaidh a sholarachadh no na teisteanasan cleachdaiche san iarrtas (ceum 1) neo-dhligheach thèid mearachd a thilleadh chun t-Solaraiche Seirbheis. Tha am mearachd a’ nochdadh an adhbhar airson a dhiùltadh agus thig an sruth gu crìch. Chan eil ID teachdaireachd air a thilleadh.
Ag atharrachadh Conaltradh Pearsanta
5
1.2 A’ cur teachdaireachd SMS gu grunn luchd-faighinn
Solaraiche Seirbheis
Meud lìon
1. Cuir teachdaireachd MT
Luchd-cleachdaidh
2. Till IDan teachdaireachd
3.1. Cuir a-steach teachdaireachd SMS #1
3.2. Cuir a-steach teachdaireachd SMS #2
3.n. Cuir a-steach teachdaireachd SMS #n
5.1. Cuir aithisg lìbhrigidh #1 5.2. Cuir aithisg lìbhrigidh #2 5.n. Cuir an aithisg lìbhrigidh #n
4.1. Lìbhrig aithisg lìbhrigidh #1 4.2. Lìbhrigeadh aithisg lìbhrigidh #2 4.n. Lìbhrig aithisg lìbhrigidh #n
Tha siostam LINK Mobility a’ toirt taic do bhith a’ cur teachdaireachd SMS aig ìre àbhaisteach gu ioma-luchd-faighinn ann an liosta cuairteachaidh. Tha an sruth bunaiteach air a mhìneachadh mar a leanas:
1. Bidh an Solaraiche Seirbheis ag iarraidh teachdaireachd SMS ìre àbhaisteach a chuir gu ioma-luchd-faighinn tro shiostam LINK Mobility.
2. Bidh siostam Gluasaid LINK a 'dearbhadh co-chòrdadh teachdaireachd SMS, an luchd-faighinn agus slighean gach teachdaireachd SMS mus till iad na IDan teachdaireachd chun an t-Solaraiche Seirbheis.
3. Bidh LINK Mobility a’ cur a-steach aon teachdaireachd SMS gu gach neach-cleachdaidh ris an deach dèiligeadh. Feuchaidh siostam LINK Mobility ris an teachdaireachd SMS a chuir air ais nuair a gheibh e freagairt mearachd a tha air a chomharrachadh mar shealach. Feuchaidh LINK Mobility ris an teachdaireachd SMS a chuir air ais gus am bi e air tighinn gu crìch no gus an tèid crìoch ath-chuinge LINK Mobility a ruighinn.
Tha ceumannan 4 agus 5 air an cur an gnìomh ma dh’ iarr an Solaraiche Seirbheis aithisg lìbhrigidh ann an ceum 1.
4. Tha aithisg lìbhrigidh air a phiobrachadh, me nuair a thèid an teachdaireachd SMS a lìbhrigeadh gu stèisean gluasadach an neach-cleachdaidh.
Ag atharrachadh Conaltradh Pearsanta
6
5. Thèid an aithisg lìbhrigidh a chuir chun t-Solaraiche Seirbheis, anns a bheil an aon ID teachdaireachd mar a chaidh a thilleadh ann an ceum 2.
Thathas a’ moladh gu mòr aithisgean lìbhrigidh iarraidh gus dearbhadh gu bheil an Luchd-cleachdaidh air an teachdaireachd SMS aca fhaighinn gu soirbheachail.
2. Stàladh
Tha LINK Mobility a’ toirt seachad API fosgailte mar a web seirbheis le eadar-aghaidh SOAPii. Tha am protocol SOAP agus am frithealaiche Link Mobility neo-eisimeileach bhon àrd-ùrlar a chleachdas an t-Solaraiche Seirbheis, ged a dh’ fhaodadh stàladh innealan SOAP a bhith eadar-dhealaichte. Tha an web seirbheis API air a mhìneachadh ann an WSDLiii.
Dhaibhsan nach eil eòlach air web seirbheisean, tha LINK Mobility cuideachd a’ toirt seachad seata de chlasaichean Java air an gineadh bhon web tuairisgeul seirbheis WSDL. Tha na clasaichean sin air an toirt seachad le taic Link Mobility ma thèid iarraidh.
2.1 Eadar-obrachadh
A dh’ aindeoin sin web tha seirbheisean eadar-obrachail thar diofar àrd-ùrlaran ann an teòiridh, bidh e uaireannan a’ tachairt gu bheil frèam an fhrithealaiche agus frèam teachdaiche neo-fhreagarrach. Gus dèanamh cinnteach à eadar-obrachadh thar àrd-ùrlaran, LINK Mobility web tha seirbheisean air an togail agus air an dearbhadh a rèir molaidhean an Web Buidheann Eadar-obrachaidh Seirbheisean, WS-Iiv.
WS-Tha feum agam air a web seirbheis gus taic a thoirt do sheataichean caractar UTF-8 agus UTF-16. Tha Link Mobility a’ toirt taic don dà chuid, ach thathas a’ moladh UTF-8 a chleachdadh.
A h-uile gluasad LINK web tha seirbheisean air an dearbhadh air na h-àrd-ùrlaran a leanas:
· Java · .NET · PHP · Perl · ASP · Ruby · Python
2.2 Web seirbhis
Ag atharrachadh Conaltradh Pearsanta
7
Tha an web seirbhis URL agus suidheachadh an WSDL file air a thoirt seachad le taic LINK Mobility ma thèid iarraidh.
2.3 Tèarainteachd
A 'cur iarrtasan
Airson dearbhadh, tha ID neach-cleachdaidh agus facal-faire an t-Solaraiche Seirbheis air an cur a-steach anns gach web tagradh seirbheis. Tha e an urra ris an t-Solaraiche Seirbheis an ID cleachdaiche agus am facal-faire seo a dhìon.
Airson tèarainteachd ceangail, tha LINK Mobility a’ moladh gu làidir cleachdadh HTTPS nuair a gheibh thu cothrom air LINL Mobility web seirbhisean. Tha an teisteanas frithealaiche gluasad LINK air a shoidhnigeadh le Thawte Server CA.
A bharrachd air an sin, thathas a’ moladh balla-teine LINK Mobility a chleachdadh gus casg a chuir air seòlaidhean IP neo-aithnichte bho bhith faighinn gu cunntas an t-Solaraiche Seirbheis. Cuir fios gu taic LINK Mobility airson tuilleadh fiosrachaidh.
Thoir an aire gu bheil HTTP a’ faighinn taic airson adhbharan co-fhreagarrachd air ais a-mhàin agus gun tèid a thoirt air falbh san àm ri teachd.
A 'faighinn aithisgean lìbhrigidh
Airson dearbhadh, thathas a’ moladh gun cleachd an Solaraiche Seirbheis: · Dearbhadh bunaiteach airson faighinn a-steach don t-seirbheis aca web frithealaiche. · Balla-teine, a’ dèanamh cinnteach nach eil ach iarrtasan bho LINK Mobility ceadaichte.
Airson tèarainteachd ceangail, thathas a’ moladh gun cleachd an Solaraiche Seirbheis: · HTTPS airson faighinn a-steach don t-seirbheis aca web frithealaiche.
Faodar HTTPS air togalaichean an t-Solaraiche Seirbheis a chleachdadh gun fhiosta, fhad ‘s a tha teisteanas an web frithealaiche air a shoidhnigeadh le teisteanas root CA a tha air a ghabhail a-steach san liosta de theisteanasan CA earbsachv.
3. SMS teachdaireachd amalachadh le LINK Mobility
Ag atharrachadh Conaltradh Pearsanta
8
3.1 A’ cur teachdaireachdan SMS
Faodaidh an Solaraiche Seirbheis teachdaireachdan SMS a chuir chun Luchd-cleachdaidh aca tro LINK Mobility, a’ cleachdadh an SMS web API seirbheis mar a tha air a mhìneachadh sa chaibideil seo.
Cur an gnìomh examplorgar leasan air mar as urrainn dhut amalachadh le LINK Mobility ann an diofar chànanan prògramaidh ann an caibideil 4.
3.1.1 Coimeas obrachaidh
Tha an SMS Messaging API a’ mìneachadh dà ghnìomhachd eadar-dhealaichte: iarrtas cuir agus iarrtas teacsa cuir. Tha am fo-earrann seo a’ toirt seachadview den ghnìomhachd a bheir an dà ghnìomhachd seachad agus àrd-sholais eadar-dhealachaidhean cudromach.
Tha an t-iarrtas cuir a-steach ag amas air cùisean cleachdaidh nas adhartaiche far a bheil smachd iomlan aig an t-Solaraiche Seirbheis air cruth teachdaireachd a’ toirt a-steach bann dàta an neach-cleachdaidh. Bidh e a’ toirt taic do GSM Default, Unicode, agus sgeamaichean còdaidh dàta dà-chànanach. Faodaidh an t-Solaraiche Seirbheis teachdaireachdan dùmhlaichte a chuir, ach feumaidh an Solaraiche Seirbheis ullachadh an dàta neach-cleachdaidh agus bann dàta luchd-cleachdaidh agus feumaidh an teachdaireachd a bhith air a chuir tro iomadh iarrtas cuir gu LINK Mobility.
Tha an t-iarrtas teacsa cuir a’ gabhail ris gu bheil caractaran bhon aibideil àbhaisteach GSM a’ toirt a-steach an clàr leudachaidh no aibideil Unicode ann an teacsa na teachdaireachd. Tha an Sgeama Còdadh Dàta air a lorg gu fèin-ghluasadach le LINK Mobility le bhith a’ sgrùdadh susbaint teacsa na teachdaireachd. Tha co-chòrdadh fèin-ghluasadach de theachdaireachd gu grunn theachdaireachdan a’ faighinn taic suas gu crìoch as àirde ainmichte an t-Solaraiche Seirbheis.
Dh’ fhaodadh gum bi feum air concatenation ma tha fad teacsa na teachdaireachd nas àirde na an fhaid as motha a tha a’ faighinn taic bhon Sgeama Còdaidh Dàta a chleachdas teacsa na teachdaireachd.
3.1.2 Làimhseachadh luachan eileamaid roghainneil
Thoir an aire, airson adhbharan eadar-obrachaidh, gu bheil a h-uile eileamaid XML anns na h-iarrtasan agus na freagairtean riatanach a rèir mìneachadh XML, ie feumaidh a bhith an làthair. Is e an comharradh airson luach roghainneil a shònrachadh:
· Airson luachan iomlan: -1
Ag atharrachadh Conaltradh Pearsanta
9
· Airson luachan sreang: #NULL#
Tha e cudromach toirt fa-near gum feumar luachan nan eileamaidean nach deach an aire a shuidheachadh ris na luachan a tha air an ainmeachadh anns a’ bheachd fhreagarrach gus an tèid taic a thoirt don eileamaid. Tha seo gus dèanamh cinnteach à co-chòrdalachd air adhart a dh’ionnsaigh LINK Mobility.
3.2 Feartan Roghainneil 3.2.1MSISDN Ceartachadh
Tha ceartachadh MSISDN na fheart roghainneil a ghabhas a chomasachadh le taic LINK Mobility ma thèid iarraidh.
Ceartaichidh am feart seo seòlaidhean ceann-uidhe agus co-thaobhadh iad ris an fhòrmat E.164 a tha a dhìth. A bharrachd air ceartachadh cruth, faodaidh an siostam cuideachd gnìomhan sònraichte margaidh a choileanadh leithid eadar-theangachadh àireamhan Frangach eadar-nàiseanta gus àireamhan DOM-TOM (départements et territoires d’outre-mer) a cheartachadh nuair a bhios sin iomchaidh.
Gu h-ìosal tha grunn exampnas lugha de cheartachaidhean:
Submitted Destination Address +46(0)702233445 (0046)72233445 +460702233445 46(0)702233445 46070-2233445 0046702233445 +46(0)702233445aaa 336005199999
Seòladh Ceann-uidhe ceartaichte 46702233445 46702233445 46702233445 46702233445 46702233445 46702233445 46702233445 2626005199999 àireamh air eadar-theangachadh gu DOM a
A bharrachd air an sin, tha e comasach àireamhan fòn nàiseanta a cheadachadh airson margaidh taghte. Nuair a bhios am feart seo air a chomasachadh feumar àireamhan eadar-nàiseanta sam bith airson margaidhean eile a chuir le soidhne `+' tùsail gus an dealachadh bhon mhargaidh taghte.
Gu h-ìosal tha grunn exampnas lugha de cheartachaidhean a chaidh a dhèanamh nuair a thathar a’ cleachdadh an t-Suain (còd dùthcha 46) mar mhargaidh àbhaisteach airson àireamhan nàiseanta.
Seòladh Ceann-uidhe air a chuir a-steach 0702233445 070-2233 445 070.2233.4455 460702233445 +460702233445 +458022334455 45802233445
Seòladh Ceann-uidhe ceartaichte 46702233445 46702233445 46702233445 46702233445 46702233445 458022334455 Neo-dhligheach leis gu bheil an soidhne `+' a dhìth
Ag atharrachadh Conaltradh Pearsanta
10
Thoir an aire gum bi an MSISDN ceartaichte air a chleachdadh le LINK Mobility agus gun tèid a thilleadh anns na h-aithisgean lìbhrigidh.
Feuch an cuir thu fios gu taic LINK Mobility airson tuilleadh fiosrachaidh.
3.2.2 Ath-nuadhachadh Caractaran
Tha ath-chur charactaran na fheart roghainneil a dh’ fhaodar a chomasachadh le taic LINK Mobility ma thèid iarraidh.
Bidh am feart seo ag eadar-theangachadh caractaran aibideil neo-GSM ann an dàta an neach-cleachdaidh (teacsa SMS) gu caractaran aibideil GSM co-ionann nuair a tha an DCS air a shuidheachadh gu “GSM” (17). Airson example “Seqüência de teste em Português” eadar-theangachadh gu “Seqüencia de teste em Portugues”.
Feuch an cuir thu fios gu taic LINK Mobility airson tuilleadh fiosrachaidh.
3.3 Cuir iarrtas
Tha an eileamaid iarrtas cuir air a chruth mar a leanas:
Ag atharrachadh Conaltradh Pearsanta
11
Bidh na h-eileamaidean leanabh iarrtas air an làimhseachadh le LINK Mobility mar a leanas:
Id co-dhàimh eileamaid
Seòladh bho thùs
Seòrsa String
sreang
M/O/I* Luach bunaiteach^
O
O
Thèid an siostam a shuidheachadh
luach ma tha
rèiteachadh agus
taic.
Fad as motha 100
16
Tuairisgeul
ID co-dhàimh gus sùil a chumail air iarrtasan agus freagairtean SOAP, a rèir moladh WS-I. Bidh am frithealaiche a’ gabhail ris an luach a chaidh a thoirt seachad. A bharrachd air an sin, faodar an ID co-dhàimh a chleachdadh mar ID taobh a-muigh oir bidh e air a thoirt a-steach do DR agus air a stòradh leis an dàta malairt. Thoir an aire gum faodadh cuingealachadh a thaobh caractaran ceadaichte a bhith ann. An seòladh tùsail airson an teachdaireachd SMS a tha a’ dol a-mach. Tha an seòrsa seòladh tùsail air a mhìneachadh le paramadair orginatorTON. Àireamh ghoirid Is e an fhaid as motha 16. Tha an neach-cuiridh alpha-àireamhach cuingealaichte ri Aibidil bunaiteach GSM le 11 caractar aig a’ char as àirde.
Ag atharrachadh Conaltradh Pearsanta
12
tùsaireTON
Slànuighear O
ceann-uidheAddress String
M
userData userDataHeader
sreang
O
sreang
O
DCS
iomlan O
PID
iomlan O
dàimheilValidityTime integer O
àm lìbhrigidh
sreang
O
Suidhichidh an siostam luach ma tha e air a rèiteachadh agus a’ faighinn taic.
Teachdaireachd falamh Gun cheann dàta cleachdaiche 17 0 172800 (48 uairean) Sa bhad
1
40(*)
280 280 3 3 9 25
Is e 15 an fhad as motha a th’ aig neach-cuiridh MSISDN (a’ cleachdadh an aon chruth ris an eileamaid ceann-uidheAddress). Faodar a shuidheachadh gu #NULL# nuair a tha an siostam air a thaghadh leis an t-siostam originAddress and originatingTON. Tha an gnìomh seo an urra ri margaidh agus rèiteachadh. Airson tuilleadh fiosrachaidh, cuir fios gu taic LINK Mobility. Faodaidh giùlan atharrachadh a rèir aonachadh Gnìomhaiche. An seòladh tùsail’ seòrsa àireamh (TON): 0 Àireamh ghoirid 1 Alpha-àireamhach (fad as motha 11) 2 MSISDN Faodar a shuidheachadh gu -1 nuair a thèid an seòladh tùsail agus an tùsTON a thaghadh leis an t-siostam. Tha an gnìomh seo an urra ri margaidh agus rèiteachadh. Airson tuilleadh fiosrachaidh, cuir fios gu taic LINK Mobility. Faodaidh giùlan atharrachadh a rèir aonachadh Gnìomhaiche. An MSISDN ris am bu chòir an teachdaireachd SMS a chuir, a’ tòiseachadh le còd dùthcha. Mar eisimpleirample: 46762050312. Airson cuid de mhargaidhean (far am feumar an MSISDN Luchd-cleachdaidh a bhith air am bacadh) faodaidh an luach seo a bhith na alias alphanumeric, le ro-leasachan le “#”.
Tha a bhith a’ cur teachdaireachd SMS gu ioma-luchd-faighinn a’ faighinn taic le bhith a’ toirt seachad liosta cuairteachaidh de MSISDNs leth-choloin (me 46762050312; 46762050313). Feumaidh an luchd-faighinn a bhith gun samhail taobh a-staigh liosta agus tha an liosta sgaoilidh cuingealaichte ri 1000 inntrigeadh. (*) Chan eil an luach faid as motha a’ buntainn ri liostaichean cuairteachaidh. An t-susbaint teachdaireachd SMS. Faodaidh suas ri 140 a bhith ann an Ceann Dàta Cleachdaiche còmhla ris an Dàta Cleachdaiche, ie 280 nuair a tha e air a chòdachadh le hex, octets. Tha am paramadair seo an-còmhnaidh air a chòdachadh le hex. Sgeama còdaidh dàta. Faodaidh giùlan atharrachadh a rèir aonachadh Gnìomhaiche. ID protocol. Faodaidh giùlan atharrachadh a rèir aonachadh Gnìomhaiche. Ùine dligheachd coimeasach ann an diogan (an coimeas ris an ùine airson a chuir a-steach gu LINK Mobility). Faodaidh giùlan atharrachadh a rèir aonachadh Gnìomhaiche. Faodar an teachdaireachd SMS a lìbhrigeadh le ùine lìbhrigidh dàil. Cruth: yyyy-MM-dd HH: mm: ss Z, example: 2000-01-01 01:01:01 0000.
Ag atharrachadh Conaltradh Pearsanta
13
brataichean aithris inbhe
iomlan O
0
Ainm cunntais
sreang
O
A rèir
cunntas
rèiteachadh
seirbheis iomraidhMetaData
sreang
O
sreang
O
Gun luach air a shuidheachadh
campaignAinm
sreang
O
ainm neach-cleachdaidh
sreang
M
facal-faire
sreang
M
* M = Riatanach, O = Roghainneil, I = Air a leigeil seachad.
1
50
150 1000 50 64 64
Faodaidh giùlan atharrachadh a rèir aonachadh Gnìomhaiche. Lìbhrigeadh iarrtas aithisg: 0 Gun aithisg lìbhrigidh 1 Aithisg lìbhrigidh air iarraidh 9 Aithisg lìbhrigidh frithealaiche air iarraidh (Cha chuir LINK Mobility an aithisg air adhart chun t-Solaraiche Seirbheis ach bidh e ri fhaighinn ann an aithisgean msaa.) Leigidh an raon seo le LINK Mobility teachdaireachdan SMS a stiùireadh ann an sùbailte dòigh, a dh’ fhaodadh no nach eil a bhith sònraichte do sholaraiche seirbheis. Airson cleachdadh àbhaisteach, bu chòir #NULL# a thoirt seachad. Nota: Feumaidh cleachdadh an raoin seo a bhith air a sholarachadh le LINK Mobility. Airson an API seo mar as trice bidh ID teachdaireachd de a web roghnachadh a-steach òrdachadh MO SMS teachdaireachd. Meta-dàta seirbheis. Suidhich gu #NULL# mura cleachd thu e no mura cuir a’ mhargaidh taic ris. Is e seo fiosrachadh sònraichte margaidh. Airson tuilleadh fiosrachaidh, cuir fios gu taic LINK Mobility. Tha na gnothaichean gu lèir le roinn LINK Mobility tagged leis an ainm so. Tha e air a chleachdadh gus gnothaichean a chur còmhla ann an aithisgean LINK Mobility. Suidhich gu #NULL# mura tèid a chleachdadh. Ainm-cleachdaidh an t-Solaraiche Seirbheis, air a sholarachadh le LINK Mobility. Facal-faire an t-Solaraiche Seirbheis, air a thoirt seachad le LINK Mobility.
^ Thèid an luach bunaiteach a chleachdadh ma tha luach eileamaid air a shuidheachadh gu null.
Ag atharrachadh Conaltradh Pearsanta
14
3.4 Cuir iarrtas teacsa
Tha an eileamaid iarrtas cuir air a chruth mar a leanas:
Bidh na h-eileamaidean cloinne iarrtas teacsa Send air an làimhseachadh le LINK Mobility mar a leanas:
Id co-dhàimh eileamaid
Seòrsa String
bho thùsAddress String
M/O/I* Luach bunaiteach^
O
O
Thèid an siostam a shuidheachadh
luach ma tha
rèiteachadh agus
taic.
Fad as motha 100
16
Tuairisgeul
ID co-dhàimh gus sùil a chumail air iarrtasan agus freagairtean SOAP, a rèir moladh WS-I. Bidh am frithealaiche a’ gabhail ris an luach a chaidh a thoirt seachad. A bharrachd air an sin, faodar an ID co-dhàimh a chleachdadh mar ID taobh a-muigh oir bidh e air a thoirt a-steach do DR agus air a stòradh leis an dàta malairt. Thoir an aire gum faodadh cuingealachadh a thaobh caractaran ceadaichte a bhith ann. An seòladh tùsail airson an teachdaireachd SMS a tha a’ dol a-mach. Tha an seòrsa seòladh tùsail air a mhìneachadh le paramadair orginatorTON.
Ag atharrachadh Conaltradh Pearsanta
15
tùsaireTON
Slànuighear O
ceann-uidheAddress String
M
teachdaireachdTeacs
sreang
M
maxConcatenatedM integer O essages
PID
iomlan O
dàimheilValidityTime integer O
Suidhichidh an siostam luach ma tha e air a rèiteachadh agus a’ faighinn taic.
Teachdaireachd fhalamh 3 0 172800 (48 uairean)
1
40(*)
39015 3 3 9
Àireamh ghoirid Is e an fhaid as motha 16. Tha an neach-cuiridh alpha-àireamhach cuingealaichte ri Aibidil bunaiteach GSM le 11 caractar aig a’ char as àirde. Is e 15 an fhad as motha a th’ aig neach-cuiridh MSISDN (a’ cleachdadh an aon chruth ris an eileamaid ceann-uidheAddress). Faodar a shuidheachadh gu #NULL# nuair a tha an siostam air a thaghadh leis an t-siostam originAddress and originatingTON. Tha an gnìomh seo an urra ri margaidh agus rèiteachadh. Airson tuilleadh fiosrachaidh, cuir fios gu taic LINK Mobility. Faodaidh giùlan atharrachadh a rèir aonachadh Gnìomhaiche. An seòladh tùsail’ seòrsa àireamh (TON): 0 Àireamh ghoirid 1 Alpha-àireamhach (fad as motha 11) 2 MSISDN Faodar a shuidheachadh gu -1 nuair a thèid an seòladh tùsail agus an tùsTON a thaghadh leis an t-siostam. Tha an gnìomh seo an urra ri margaidh agus rèiteachadh. Airson tuilleadh fiosrachaidh, cuir fios gu taic LINK Mobility. Faodaidh giùlan atharrachadh a rèir aonachadh Gnìomhaiche. An MSISDN ris am bu chòir an teachdaireachd SMS a chuir, a’ tòiseachadh le còd dùthcha. Mar eisimpleirample: 46762050312. Airson cuid de mhargaidhean (far am feumar an MSISDN Luchd-cleachdaidh a bhith air am bacadh) faodaidh an luach seo a bhith na alias alphanumeric, le ro-leasachan le “#”.
Tha a bhith a’ cur teachdaireachd SMS gu ioma-luchd-faighinn a’ faighinn taic le bhith a’ toirt seachad liosta cuairteachaidh de MSISDNs leth-choloin (me 46762050312; 46762050313). Feumaidh an luchd-faighinn a bhith gun samhail taobh a-staigh liosta agus tha an liosta sgaoilidh cuingealaichte ri 1000 inntrigeadh. (*) Chan eil an luach faid as motha a’ buntainn ri liostaichean cuairteachaidh. An t-susbaint teachdaireachd SMS. Tha an Sgeama Còdadh Dàta air a lorg gu fèin-ghluasadach. Is e sgeamaichean le taic GSM 7-bit, no UCS-2. Luach eadar 1 agus 255 far a bheil an luach a’ mìneachadh cia mheud teachdaireachd co-cheangailte ris a bheilear iomchaidh. Ma tha an àireamh de theachdaireachdan co-cheangailte nas àirde na an luach seo, dh'fhàillig an t-iarrtas. ID protocol. Faodaidh giùlan atharrachadh a rèir aonachadh Gnìomhaiche. Ùine dligheachd coimeasach ann an diogan (an coimeas ris an ùine airson a chuir a-steach gu LINK Mobility).
Ag atharrachadh Conaltradh Pearsanta
16
àm lìbhrigidh
sreang
O
Sa bhad
brataichean aithris inbhe
Slànuighear O
0
Ainm cunntais
sreang
O
A rèir rèiteachadh cunntais
seirbheis iomraidhMetaData
sreang
O
sreang
O
Gun luach air a shuidheachadh
campaignAinm
sreang
O
ainm neach-cleachdaidh
sreang
M
facal-faire
sreang
M
* M = Riatanach, O = Roghainneil, I = Air a leigeil seachad.
25
1
50
150 1000 50 64 64
Faodaidh giùlan atharrachadh a rèir aonachadh Gnìomhaiche. Faodar an teachdaireachd SMS a lìbhrigeadh le ùine lìbhrigidh dàil. Cruth: yyyy-MM-dd HH: mm: ss Z, example: 2000-01-01 01:01:01 0000. Faodaidh giùlan atharrachadh a rèir amalachadh Gnìomhaiche. Lìbhrigeadh iarrtas aithisg: 0 Gun aithisg lìbhrigidh 1 Aithisg lìbhrigidh air iarraidh 9 Aithisg lìbhrigidh frithealaiche air iarraidh (Cha chuir LINK Mobility an aithisg air adhart chun t-Solaraiche Seirbheis ach bidh e ri fhaighinn ann an aithisgean msaa.) Leigidh an raon seo le LINK Mobility teachdaireachdan SMS a stiùireadh ann an sùbailte dòigh, a dh’ fhaodadh no nach eil a bhith sònraichte do sholaraiche seirbheis. Airson cleachdadh àbhaisteach, bu chòir #NULL# a thoirt seachad. Nota: Feumaidh cleachdadh an raoin seo a bhith air a sholarachadh le LINK Mobility. Airson an API seo mar as trice bidh ID teachdaireachd de a web roghnachadh a-steach òrdachadh MO SMS teachdaireachd. Meta-dàta seirbheis. Suidhich gu #NULL# mura cleachd thu e no mura cuir a’ mhargaidh taic ris. Is e seo fiosrachadh sònraichte margaidh. Airson tuilleadh fiosrachaidh, cuir fios gu taic LINK Mobility. Tha na gnothaichean gu lèir le roinn LINK Mobility tagged leis an ainm so. Tha e air a chleachdadh gus gnothaichean a chur còmhla ann an aithisgean Link Mobility. Suidhich gu #NULL# mura tèid a chleachdadh. Ainm-cleachdaidh an t-Solaraiche Seirbheis, air a sholarachadh le LINK Mobility. Facal-faire an t-Solaraiche Seirbheis, air a thoirt seachad le LINK Mobility.
^ Thèid an luach bunaiteach a chleachdadh ma tha luach eileamaid air a shuidheachadh gu null.
Ag atharrachadh Conaltradh Pearsanta
17
3.5 Cuir freagairt
Tha an eileamaid freagairt cuir air a chruth mar a leanas:
Tha am freagairt cuir air a chleachdadh airson an dà chuid iarrtas cuir agus iarrtas teacsa a chuir.
Tha na h-eileamaidean freagairt leanabh air an làimhseachadh le LINK Mobility mar a leanas:
Teachdaireachd co-dhàimh eileamaidMion-fhiosrachadh
Còd freagairt
Seòrsa
liosta sreang de messa geDetai l integer
M/O/I* OM
M
Luach bunaiteach^
Fad as motha 100 1000 eileamaidean
5
sreath teachdaireachd freagairt M
200
* M = Riatanach, O = Roghainneil, I = Air a leigeil seachad. ^ Thèid an luach bunaiteach a chleachdadh ma tha luach eileamaid air a shuidheachadh gu null.
Tuairisgeul
ID co-dhàimh iarrtas mac-talla. Liosta de IDan teachdaireachd sònraichte LINK Mobility agus còd freagairt airson malairt soirbheachail no pàirt shoirbheachail, liosta falamh ma dh’fhàilligeas. Tha còd freagairt gluasad LINK 0 a’ comharrachadh gnothach soirbheachail. Tha còd freagairt 50 a’ comharrachadh malairt gu ìre shoirbheachail; chaidh co-dhiù aon teachdaireachd a chuir gu neach a gheibh e, faic teachdaireachdDetails airson còdan freagairt fa leth airson gach neach a gheibh e. Tha còd mearachd sam bith eile a’ comharrachadh fàilligeadh iomlan a chuir. Faic clàr air leth airson liosta iomlan de chòdan freagairt. Freagairt tuairisgeul teacsa, me teacsa mearachd.
Ag atharrachadh Conaltradh Pearsanta
18
Tha an teachdaireachdDetail eileamaidean cloinne air an làimhseachadh le LINK Mobility mar a leanas:
Eileamaid
ceann-uidheAddress messageIds
Seòrsa
sreang-sreang
M/O/I*
MM
Luach bunaiteach^
Còd freagairt
iomlan M
freagairt Teachdaireachd
sreang
M
* M = Riatanach, O = Roghainneil, I = Air a leigeil seachad.
An fhad as motha 40 5864
5
200
Tuairisgeul
Echoed request destinationAddress. LINK Mobility ID teachdaireachd sònraichte airson malairt soirbheachail, sreang falamh air fàiligeadh. Thèid grunn IDan teachdaireachd a thilleadh ma tha an teachdaireachd co-cheangailte. Tha na IDan teachdaireachd air an sgaradh le leth-choloin. Airson cuid de shuidheachaidhean mearachd thèid liosta falamh a thilleadh. Tha còd freagairt gluasad LINK 0 a’ comharrachadh gnothach soirbheachail. Faic clàr air leth airson liosta iomlan de chòdan freagairt. NOTA: Tha an còd freagairt 0 a’ nochdadh gu bheil an teachdaireachd clàraichte airson a lìbhrigeadh, chan e gun deach lìbhrigeadh soirbheachail a dhèanamh. Freagairt tuairisgeul teacsa, me teacsa mearachd.
^ Thèid an luach bunaiteach a chleachdadh ma tha luach eileamaid air a shuidheachadh gu null.
3.6 Còdan freagairt
Faodar na còdan freagairt a leanas a thilleadh san fhreagairt cuir:
Còd 0 1 2 3 4 5 6 7 8 9
Text Success Log a-steach mì-dhligheach no cleachdadh API gun chead Neach-cleachdaidh air a bhacadh le Link Mobility Operation chan eil e air a sholarachadh le Link Mobility Chan eil fios aig an neach-cleachdaidh gu Link Mobility Tha neach-cleachdaidh air an t-seirbheis seo a bhacadh ann an Link Mobility Chan eil an seòladh tùsail a’ faighinn taic seòladh bho thùs Alpha gun taic cunntas MSISDN bho thùs an t-seòladh gun taic GSM leudaichte chan eil taic ann
Tuairisgeul Air a chuir gu bàs gu soirbheachail. Tha ainm-cleachdaidh neo facal-faire ceàrr no solaraiche seirbheis air a thoirmeasg le LINK Mobility. Tha an neach-cleachdaidh air a bhacadh le LINK Mobility.
Tha an obrachadh air a bhacadh airson an t-Solaraiche Seirbheis.
Chan eil an neach-cleachdaidh eòlach air LINK Mobility. No ma bha alias air a chleachdadh anns an iarrtas ; ailias nach deach a lorg. Tha an Neach-cleachdaidh air an t-seirbheis seo a bhacadh ann an Link Mobility.
Chan eil taic ris an t-seòladh tùsail.
Chan eil an cunntas a' cur taic ris an t-seòladh tùsail alpha.
Chan eil taic ris an t-seòladh tùsail MSISDN.
GSM leudaichte gun taic.
Ag atharrachadh Conaltradh Pearsanta
19
10
Chan eil taic ri Unicode
Chan eil taic ri Unicode.
11
Chan eil taic ris an aithisg inbhe
Chan eil taic ris an aithisg inbhe.
12
Chan eil an comas riatanach
An comas a tha a dhìth (ach a-mhàin na tha gu h-àrd) airson an teachdaireachd a chuir
taic
chan eil taic ann.
13
Bidh an solaraiche susbaint max
Tha an Solaraiche Seirbheis a’ cur na teachdaireachdan SMS gu LINK Mobility cuideachd
tha ìre throtling air a dhol thairis air
luath.
14
ID protocol nach eil taic ann le
Chan eil taic ri ID protocol.
cunntas
15
Crìochan co-cheangail teachdaireachd
Tha an àireamh de theachdaireachdan co-cheangailte nas àirde na an àireamh as motha
seachad air
dh'iarr.
16
Cha b' urrainn dhuinn an teachdaireachd slighe
Cha b' urrainn do LINK Mobility an teachdaireachd a stiùireadh.
17
Ùine ùine toirmisgte
Chan eil cead teachdaireachd a chuir a-steach rè ùine
18
Cothromachadh ro ìosal air seirbheis
Tha solaraiche seirbheis air a bhacadh air sgàth cothromachadh ro ìosal
cunntas solaraiche
50
Soirbheachas pàirt
Soirbheachas gu ìre nuair a chuireas tu teachdaireachd SMS gu grunn luchd-faighinn.
99
Mearachd an fhrithealaiche a-staigh
Mearachd gluasaid LINK eile, cuir fios gu taic LINK Mobility airson barrachd
fiosrachadh.
100
Seòladh ceann-uidhe mì-dhligheach
Tha an seòladh ceann-uidhe (MSISDN, no alias) neo-dhligheach.
102
ID mì-dhligheach (ceangailte).
Tha an ID iomraidh neo-dhligheach, is dòcha gu bheil an ID iomraidh air a chleachdadh mu thràth, cuideachd
sean no neo-aithnichte.
103
Ainm cunntais mì-dhligheach
Tha ainm a’ chunntais mì-dhligheach.
105
Dàta meata seirbheis mì-dhligheach
Tha meata-dàta na seirbheis neo-dhligheach.
106
Seòladh tùsail mì-dhligheach
Tha an seòladh tùsail mì-dhligheach.
107
Tùs alphanumeric mì-dhligheach Tha an seòladh tùsanach alphanumeric mì-dhligheach.
seòladh
108
Ùine dligheachd mì-dhligheach
Tha an ùine dligheachd neo-dhligheach.
109
Ùine lìbhrigidh mì-dhligheach
Tha an ùine lìbhrigidh neo-dhligheach.
110
Susbaint teachdaireachd/cleachdaiche mì-dhligheach
Tha an dàta cleachdaiche, ie an teachdaireachd SMS, neo-dhligheach.
dàta
111
Faid teachdaireachd mì-dhligheach
Tha fad na teachdaireachd SMS mì-dhligheach.
112
Ceann-cinn dàta cleachdaiche mì-dhligheach
Tha bann-cinn dàta an neach-cleachdaidh mì-dhligheach.
113
Sgeama còdaidh dàta mì-dhligheach
Tha an DCS neo-dhligheach.
114
ID pròtacal mì-dhligheach
Tha am PID neo-dhligheach.
115
Brataichean aithisg staid mì-dhligheach
Tha brataichean na h-aithisg inbhe neo-dhligheach.
116
TON mì-dhligheach
Tha an neach-tòiseachaidh TON mì-dhligheach.
117
Neo-dhligheach campaign ainm
Tha an campaign ainm neo-dhligheach.
120
Crìochan mì-dhligheach airson an ìre as àirde
Tha an àireamh as motha de theachdaireachdan co-cheangailte mì-dhligheach.
àireamh co-cheangailte
brathan
121
Mì-dhligheach bho thùs msisdn
Tha an seòladh tùsail MSISDN mì-dhligheach.
seòladh
122
ID co-dhàimh mì-dhligheach
Tha an ID co-dhàimh neo-dhligheach.
3.7 Leugh an ùine-ama
Leis gu bheil ionnsaighean air Link Mobility API mar as trice a’ ciallachadh gu bheil LINK Mobility a’ toirt ionnsaigh air siostaman eile bhon taobh a-muigh, leithid siostaman pàighidh Operator agus SMSCn, thathas a’ moladh gun cleachd an Solaraiche Seirbheis ùine leughaidh caran àrd. Thathas a’ moladh ùine leughaidh de 10 mionaidean airson iarrtasan HTTP. Le bhith a’ cleachdadh na h-ùine seo làimhsichidh e eadhon na cùisean ùine leughaidh as fharsainge.
3.8 A’ faighinn aithisg lìbhrigidh
Faodaidh an Solaraiche Seirbheis, ma thèid a sholarachadh, aithisgean lìbhrigidh teachdaireachd SMS no fiosan lìbhrigidh iarraidh airson na teachdaireachdan MT a chaidh a chuir. Tha na h-aithisgean sin air am brosnachadh anns an
Ag atharrachadh Conaltradh Pearsanta
20
SMSC gnìomhaiche nuair a thèid an teachdaireachd MT a lìbhrigeadh don neach-cleachdaidh cuimsichte no air a dhubhadh às, me air tighinn gu crìch no, airson adhbhar air choireigin, chan eil e ri chleachdadh. Chan eil ach inbhe deireannach na teachdaireachd SMS air aithris don t-Solaraiche Seirbheis, ie air a lìbhrigeadh no air a dhubhadh às. Chan eil ach aon aithisg gach teachdaireachd MT ga chruthachadh. Leis an inbhe a chaidh a dhubhadh às, faodaidh còd adhbhar a bhith ann. Tha an còd adhbhar seo a’ sònrachadh an adhbhar airson nach deach an teachdaireachd SMS a lìbhrigeadh.
Tha na h-aithisgean air an stiùireadh tro Link Mobility agus air an cur chun t-Solaraiche Seirbheis a’ cleachdadh protocol HTTP.
Gus aithisgean fhaighinn, feumaidh an Solaraiche Seirbheis a chuir an gnìomh airson example Java Servlet no duilleag ASP.NET. Bidh an dithis seo a’ faighinn iarrtasan HTTP GET no POST.
Paramadairean
Tha an t-iarrtas a’ toirt a-steach na paramadairean a leanas:
Paramadair MessageId Ceann-uidheCòd seòlaidh
UairStamp
Gnìomhaiche
Còd Adhbhar
Taidhp a-steach an t-sreath sreang integer
sreang
sreang
iomlanachd
M/O/I*
Luach bunaiteach
Fad as motha
Tuairisgeul
M
22
ID teachdaireachd na teachdaireachd MT
ris a bheil an aithisg seo a’ freagairt.
M
40
MSISDN an Luchd-cleachdaidh, ie an
seòladh ceann-uidhe an MT tùsail
teachdaireachd.
M
1
Tha an còd inbhe a’ comharrachadh inbhe an
Teachdaireachd MT.
Is e còdan inbhe iomchaidh:
0 Air a lìbhrigeadh
2 - Air a dhubhadh às (còd adhbhar a’ buntainn)
M
20
Ùine a’ comharrachadh cuin a thèid an lìbhrigeadh
Fhuair LINK Mobility an aithisg.
Sòn ùine na h-ùine as àirdeamp tha CET
no CEST (le àm samhraidh mar a chaidh a mhìneachadh
airson an EU).
Cruth: yyyyMMdd HH: mm: ss.
M
100
Ainm an Gnìomhaiche a chleachdar nuair a
a' cur an teachdaireachd SMS no an
ainm cunntais a thathar a’ cleachdadh nuair a thathar a’ cur an
Teachdaireachd SMS.
Tha liosta de na gnìomhaichean a tha rim faighinn air a thoirt seachad
le taic LINK Mobility.
O
3
Tha còd adhbhar a’ nochdadh carson a tha an
thàinig an teachdaireachd gu crìch san inbhe
air a sguabadh às.
Is e còdan adhbhar iomchaidh:
100 air tighinn gu crìch 101 air a dhiùltadh 102 Mearachd cruth 103 Mearachd eile 110 Neach-clàraidh neo-aithnichte 111 Neach-clàraidh air a thoirmeasg 112 Neach-clàraidh gun a bhith air a sholarachadh 113 Neach-clàraidh nach eil ri fhaighinn 120 fàiligeadh SMSC
Ag atharrachadh Conaltradh Pearsanta
21
OperatorTimeStamp
sreang
O
Teacs inbhe
sreang
O
Co-dhàimhId
sreang
O
Còd Obrachaidh Lìonra
iomlan O
* M = Riatanach, O = Roghainneil, I = Air a leigeil seachad.
121 SMSC dùmhlachd
122 SMSC romhpa
130 Mearachd inneal-làimhe
131 Cuimhne inneal-làimhe air a dhol thairis air
Faodaidh giùlan atharrachadh le gnìomhaiche
aonachadh.
20
Ùine a’ comharrachadh cuin a bha an aithisg
air a bhrosnachadh ann an SMSC an Gnìomhaiche
(ma tha an gnìomhaiche air a thoirt seachad).
Sòn ùine na h-ùine as àirdeamp tha CET
no CEST (le àm samhraidh mar a chaidh a mhìneachadh
airson an EU).
Cruth: yyyyMMdd HH: mm: ss.
255
Neach-ionaid airson fiosrachadh a bharrachd
bhon Ghnìomhaiche, me teacsa soilleir
tuairisgeul air an inbhe / adhbhar.
Faodaidh giùlan atharrachadh le gnìomhaiche
aonachadh.
100
Tha an ID co-dhàimh a tha air a thoirt seachad anns an
SendRequest no SendTextRequest.
6
Tha còd an lìonraidh fòn-làimhe (MCC+
MNC) den Ghnìomhaiche.
Feumaidh an Solaraiche Seirbheis an targaid a thoirt do LINK Mobility URL airson aithisgean lìbhrigidh (gu roghnach a’ toirt a-steach teisteanasan airson dearbhadh bunaiteach HTTP).
Faodaidh an Solaraiche Seirbheis taghadh dè an dòigh HTTP as fheàrr leotha a chleachdadh:
· HTTP POST (air a mholadh) · HTTP GET.
Example bhith a’ cleachdadh HTTP GET (air a lìbhrigeadh gu soirbheachail):
https://user:password@www.serviceprovider.com/receivereport? MessageId=122&DestinationAddress=46762050312&Operator=Vodafone&TimeSt amp=20100401%2007%3A47%3A44&StatusCode=0
Example bhith a’ cleachdadh HTTP GET (cha deach a lìbhrigeadh, tha an Gnìomhaiche air timest a thoirt seachadamp airson an tachartais):
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
Ag atharrachadh Conaltradh Pearsanta
22
Tha na paramadairean URL còdachadhvi.
Còdachadh charactaran:
Faodaidh an Solaraiche Seirbheis taghadh dè an còdachadh caractar as fheàrr leotha a chleachdadh: · UTF-8 (air a mholadh) · ISO-8859-1.
3.9 Aithneachadh Solaraiche Seirbheis
Bu chòir don t-Solaraiche Seirbheis aithne a thoirt do gach aithisg lìbhrigidh. Faodaidh an aithne a bhith deimhinneach, ie aithisg lìbhrigidh air fhaighinn gu soirbheachail, no àicheil, ie fàilligeadh.
Thoir an aire: Tha ùine leughaidh aig LINK Mobility airson aideachadh 30 diog airson aithisgean lìbhrigidh. Brosnaichidh ùine-ama ath-thagradh lìbhrigidh (ma tha e comasach a-rithist) no cuir às don lìbhrigeadh (ma tha e ciorramach a-rithist). Tha seo a’ ciallachadh gum feum tagradh an t-Solaraiche Seirbheis dèanamh cinnteach à amannan freagairt luath, gu sònraichte aig àm luchdan àrd.
Thathas a’ moladh gu mòr an aithisg lìbhrigidh a dh’ ionnsaigh LINK Mobility aithneachadh mus giullachd e.
Tha an riaghailt airson aithne adhartach is àicheil air a mhìneachadh mar a leanas:
Aithneachadh adhartach, ACK, aithisg lìbhrigidh air a lìbhrigeadh: Còd freagairt raon HTTP 200 còmhla ris an t-susbaint cruth XML a leanas:
Aithneachadh àicheil, NAK, aithisg lìbhrigidh nach deach a lìbhrigeadh: Freagairt sam bith ach aideachadh dearbhach, airson example, tha aithne àicheil air a bhrosnachadh le còd mearachd HTTP sam bith no an t-susbaint XML a leanas:
Faodar an susbaint XML a chleachdadh airson smachd a chumail air an inneal ath-fheuchainn Link Mobility. Nì NAK oidhirp a-rithist ma tha sin an comas. Airson Solaraichean Seirbheis nach eil air an rèiteachadh airson an uidheamachd ath-fheuchainn, tha an susbaint XML roghainneil.
Gu h-ìosal tha iarrtas HTTP POST agus freagairt example aithisg lìbhrigidh air a lìbhrigeadh gu Solaraiche Seirbheis:
Ag atharrachadh Conaltradh Pearsanta
23
Iarrtas HTTP: POST /context/app HTTP/1.1 Seòrsa-susbaint: iarrtas/x-www-form-urlencoded; charset = utf-8 Host: server: port Susbaint-Fad: xx
MessageId=213123213&DestinationAddress=46762050312&Operator=Telia & OperatorTimeStamp=20130607%2010%3A45%3A00&TimeStamp=20130607 %2010%3A45%3A02&StatusCode=0
Freagairt HTTP: HTTP / 1.1 200 math susbaint-seòrsa: teacsa / plain
3.10 Feuch a-rithist
Faodaidh an siostam LINK Mobility oidhirpean a dhèanamh a-rithist airson lìbhrigeadh aithris lìbhrigidh air fàiligeadh, ie nach deach aithneachadh. Faodaidh an Solaraiche Seirbheis an giùlan ath-thagradh as fheàrr leotha a thaghadh:
· Gun ath-fheuchainn (bunaiteach) - thèid an teachdaireachd a thilgeil air falbh ma dh’ fhailicheas oidhirp ceangail, leugh ùine a-mach no airson còd mearachd HTTP sam bith.
· Feuch a-rithist - bidh an teachdaireachd diombach airson a h-uile seòrsa duilgheadas ceangail, leugh ùine a-muigh, no aideachadh àicheil.
Nuair a bhios ath-fheuchainn airson NAK air a chomasachadh, tha e cudromach tuigsinn dè na suidheachaidhean a ghineas oidhirp a-rithist bho LINK Mobility agus mar a bhios an ath-fheuchainn ag obair.
Tha ciudha ath-fheuchainn fhèin aig gach Solaraiche Seirbheis, far am bi teachdaireachdan air an òrdachadh a rèir an ùine teachdaireachd as luaitheamp. Bidh LINK Mobility an-còmhnaidh a’ feuchainn ri teachdaireachdan nas sine a lìbhrigeadh an toiseach, eadhon ged nach eil an òrdugh fa leth de theachdaireachdan a thèid a lìbhrigeadh don t-Solaraiche Seirbheis cinnteach.
Is e am prìomh adhbhar airson teachdaireachdan a bhith air an toirt air falbh bhon chiudha ath-fheuchainn aon de dhà adhbhar: an dàrna cuid thig an teachdaireachd TTL gu crìch no (gu teòiridheach) bidh an ciudha ath-fheuchainn làn. Tha an TTL an urra ri Gnìomhaiche agus cunntas, ie faodaidh e atharrachadh a rèir an gnìomhaiche agus no an seòrsa teachdaireachd, me prìomh SMS no teachdaireachd SMS aig ìre àbhaisteach.
Ag atharrachadh Conaltradh Pearsanta
24
Feumaidh Solaraiche Seirbheis le ath-thilleadh sùil a thoirt air ID sònraichte na teachdaireachd MT gus dèanamh cinnteach nach d’ fhuaireadh am brath mu thràth.
Ag atharrachadh Conaltradh Pearsanta
25
Tha e cudromach gun cùm an t-Solaraiche Seirbheis ris na riaghailtean sìmplidh sin nuair a thachras mearachd nuair a thathar a’ giullachd aithisg lìbhrigidh mas e adhbhar na mearachd:
1. Sealach, me stòr-dàta nach eil ri fhaighinn, bu chòir NAK a thilleadh. Cuiridh LINK Mobility am brath a-rithist.
2. Maireannach agus oidhirp a-rithist buailteach a bhith ag adhbhrachadh an aon seòrsa duilgheadas, bu chòir ACK a thilleadh. Airson example, nuair nach b’ urrainnear an teachdaireachd a pharsadh gu ceart no nuair a dh’ adhbhraich e mearachd runtime ris nach robh dùil.
Le bhith ag obair a rèir sin nì sin cinnteach nach bi bacadh no truailleadh trochur air adhbhrachadh mar thoradh air aithisg lìbhrigidh a bhith a’ gabhail aithreachas a-rithist is a-rithist.
3.11 Beachd air susbaint teachdaireachd SMS
Tha susbaint teachdaireachd SMS, ie am paramadair dàta cleachdaiche, air a riochdachadh ann an diofar aibideil a rèir luach DCS. Tha na bunaitean air am mìneachadh sa chlàr gu h-ìosal. Gheibhear tuilleadh fiosrachaidh mu aibideil SMS ann an sònrachadh ETSI airson SMSvii.
Aibidil
Aibidil bunaiteach GSM GSM aibidil leudaichte
Example (DCS / dàta cleachdaiche) 17 / abc@()/
17 / {}[]
Binary UCS2
25 / ©¼ë® 21 / 42696e61727921
Fad as motha 160 <160
70 280
Tuairisgeul
Teachdaireachd teacsa àbhaisteach a’ cleachdadh na h-aibideil bunaiteach GSM, faic caibideil 5.1. Teachdaireachd teacsa a’ cleachdadh an aibideil àbhaisteach GSM agus clàr leudachaidh, faic caibideil 5.2. Leis gu bheil gach caractar bhon chlàr leudachaidh air a riochdachadh le dà charactar tha an fhìor fhad as àirde air a thomhas gu dinamach mar: 160 k, far a bheil k an àireamh de charactaran leudaichte a thathas a’ cleachdadh san teachdaireachd. Unicode (16 bit), clàr caractar ISO/IEC 10646. Teachdaireachd dà-chànanach dàta 8-bit. Tha gach byte air a riochdachadh mar luach hex a’ cleachdadh dà charactar gach byte. Is e an fhad teachdaireachd as àirde 140 bytes, is e sin 280 caractar nuair a tha e air a chòdachadh le heacs.
Bidh an fhad as motha de theachdaireachd SMS a’ lughdachadh mar a bhios fad a’ chinn a’ dol am meud nuair a chuireas tu teachdaireachdan SMS le bann-cinn dàta neach-cleachdaidh air a shònrachadh.
Faodaidh taic airson diofar aibideil a bhith eadar-dhealaichte a rèir aonachadh Gnìomhaiche.
Ag atharrachadh Conaltradh Pearsanta
26
Thoir an aire nach urrainn cuid de charactaran anns an raon C0 (caractaran smachd san eadar-ama 0x00000x001F) a bhith air an riochdachadh ann an XML air sgàth cuingealachadh ann an XML 1.0. Is e aon de na caractaran sin gun taic , a tha air a ghabhail a-steach ann an clàr leudachaidh na h-aibidil GSM. Gus a dhèanamh comasach susbaint teachdaireachd a chuir a’ toirt a-steach caractaran mar sin, me, vCards, tha LINK Mobility a’ toirt taic do cho-chòrdadh teicheadh Unicode.
Tha co-chòrdadh teicheadh LINK Mobility Unicode co-ionann ris a’ cho-chòrdadh teicheadh a chleachd Sònrachadh Cànain Javaviii. Às deidh na caractaran teicheadh u le ceithir àireamhan hexadecimal a’ riochdachadh luach UTF-16 a’ charactar, uxxxx.
Bidh cuid a 'teicheadh examples:
· u000a - Biadhadh loidhne · u000c - Foirm biadhaidh · u000d - Tilleadh carbaid · u2603 Fear-sneachda
4. Cur an gnìomh examples
Bidh SOAP a’ dèanamh am fuasgladh neo-eisimeileach bhon chànan prògramaidh a thathar a’ cleachdadh aig taobh teachdaiche an t-Solaraiche Seirbheis.
Tha an web tha seirbheis airson an SMS Messaging API glè choltach ris an t-seirbheis web seirbheis air a chleachdadh san API SMS. Tha an còd exampfaodar nas lugha a lorgar anns an stiùireadh API SMS atharrachadh gu furasta airson a chleachdadh leis an API seo.
Ag atharrachadh Conaltradh Pearsanta
27
5. Clàran caractar GSM
5.1 Clàr aibideil àbhaisteach GSM (7-bit)
Tha an clàr seo a' sealltainn nan caractaran a dh'fhaodar a thaisbeanadh air a h-uile fòn-làimhe GSM.
b7 0
Binary
b6 0
b5 0
Dùbhlachd
0
b4 b3 b2 b1
heics 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
11b
Ø
1 1
0
0
12C
ø
1 1
0
1
13 d
CR
1 1
1
0
14 E
Å
1 1
1
1
15 f
å
Airson example, tha na leanas anns an litir “A”.
luachan:
1) Tha an còd seo na theicheadh gu leudachadh de
an aibidil àbhaisteach 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
SP 0
¡
P ¿p
_
!
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
‘
7 G Wg w
(
8 HXh x
)
9 mi
Tha i
y
*
:
JZ j
z
1) +;
cnag
Æ,
<L ul
ö
æ -
= Mìn
ß.
> NÜn ü
É/
?
O §
o
à
Bunait àireamh Decimal Hexadecimal Binary
Àireamhachadh 64 + 1 40 + 1 b1–b7
Luach 65 41 1000001
Ag atharrachadh Conaltradh Pearsanta
28
Clàr leudachaidh aibideil bunaiteach 5.2 GSM (7-bit)
Tha an clàr seo a' sealltainn nan caractaran leudaichte dhan aibidil àbhaisteach 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
Dùbhlachd
0
16 32 48 64 80 96 112
b4 b3 b2 b1
heics 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
11b
1 1
0
0
12C
[1 1
0
1
13 d
~
1 1
1
0
14 E
]
1 1
1
1
15 f
Ag atharrachadh Conaltradh Pearsanta
29
6. Acronyms agus giorrachaidhean
Tha a h-uile geàrr-chunntas agus giorrachadh air an liostadh anns a’ Ghlas-fhaclairix.
7. Iomraidhean
i Iùl Gnìomh Gluasaid LINK, 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 Iùl Gnìomh Gluasaid, Teisteanasan CA earbsach, 11/155 19-FGC 101 0169 Uen vi Aithnearan Goireasan Èideadh, http://www.ietf. org/rfc/rfc2396.txt vii ETSI TS 100 900 V7.2.0 (GSM 03.38 dreach 7.2.0), Aibideil agus fiosrachadh cànain-sònraichte viii LINK Pàipear-taice Stiùiridh Gnìomh Gluasaid, Fios Cìsean, 10/155 19-FGC 101 Ue LINK Pàipear-taice Stiùireadh Gnìomh Gluasaid, Beag-fhaclair, 0169/36 155-FGC 19 101 Uen
Ag atharrachadh Conaltradh Pearsanta
30
Sgrìobhainnean/Goireasan
 |
gluasad ceangail Cur an gnìomh Teachdaireachdan SMS 1.0 [pdfStiùireadh Cleachdaiche 1.0, Teachdaireachdan SMS Buileachadh 1.0, Teachdaireachdan SMS 1.0, Teachdaireachdan 1.0 |