Udhëzuesi i Zbatimit të LINK Mobility REST API SMS
LINK Mobility ofron një shërbim për dërgimin e mesazheve, pagesat mikro dhe shërbimet e bazuara në vendndodhje. Platforma vepron si një blerës transparent i përmbajtjes dhe ruter i transaksioneve ndërmjet Ofruesve të Shërbimeve dhe Operatorëve.
LINK Mobility ofron një API RESTful që mund të përdoret për të hyrë në shërbimet e LINK Mobility si dërgimi i SMS. Ky API është krijuar për të qenë i lehtë për t'u përdorur dhe i pajtueshëm me të gjitha gjuhët dhe kornizat moderne. Duke përdorur gjuhën e zgjedhjes suaj, aplikacioni juaj mund të përdorë Link Mobility REST API për të zbatuar aftësi të fuqishme të mesazheve dhe pagesave
© LINK Mobility, 10 mars 2021
Informacione Ligjore
Informacioni i dhënë në këtë dokument është pronë e vetme dhe e drejta e autorit e Netsize. Është konfidencial dhe i destinuar për përdorim rreptësisht informativ. Ai nuk është i detyrueshëm dhe mund të jetë subjekt i ndryshimeve pa paralajmërim. Çdo zbulim ose përdorim i paautorizuar do të konsiderohet si i paligjshëm.
Netsize™ dhe linkmobility™ mbrohen nga ligjet franceze, EEC dhe ndërkombëtare të pronësisë intelektuale.
Të gjitha markat e tjera të cituara janë pronë e vetme e pronarëve të tyre përkatës.
Asgjë që përmbahet këtu nuk do të interpretohet se jep ndonjë licencë ose të drejtë sipas patentës, të drejtës së autorit ose markës tregtare Netsize.
NETSIZE
Société anonyme au capital de 5 478 070 euro
Rrethimi social: 62, rruga Emile Zola92100 Boulogne – Francë
418 712 477 RCS Nanterre
http://www.LinkMobility.com
http://www.linkmobility.com
Fushëveprimi i Dokumentit
Ky dokument përshkruan se si Ofruesi i Shërbimit përdor LINK Mobility REST API për SMS. Ai është i destinuar për arkitektë teknikë dhe projektues që zbatojnë shërbimet e Ofruesit të Shërbimeve.
1. Përdorimi bazë
Është shumë e lehtë të dërgosh një SMS. Ju dërgoni një kërkesë HTTP te LINK Mobility e cila mund të realizohet duke përdorur vetëm një web shfletuesi.
2. Mbi funksionaleview
Sistemi LINK Mobility ofron funksionalitetin bazë të mëposhtëm për mesazhet SMS:
Dërgimi i mesazheve SMS me ndërprerje celulare (MT), të tilla si mesazhe me tekst ose binar (p.sh. WAP Push) premium dhe mesazhe standarde.
Marrja e raporteve të dorëzimit për mesazhet e dorëzuara MT.
Marrja e mesazheve SMS me origjinë celulare (MO), tarifa premium dhe standarde.
SMS REST API është i dedikuar për dërgimin e mesazheve SMS me normë standarde MT.
API dërgon të gjitha mesazhet SMS në mënyrë asinkrone, duke mundësuar veçori të tilla si:
“Zjarr dhe harro” – Ofruesi i Shërbimit dëshiron të ketë kohë më të parashikueshme përgjigjeje dhe nuk dëshiron të presë rezultatin nga Operatori.
Riprovoni funksionalitetin – LINK Mobility do të ridërgojë mesazhin nëse Operatori ka probleme të përkohshme.
2.1 Dërgimi i një mesazhi SMS
Ofruesi i Shërbimit Konsumatori Netsize
- Dërgo mesazh MT
- ID-ja e mesazhit të kthimit
- Dërgo mesazh SMS
- Dorëzoni raportin e dorëzimit
- Dërgo raportin e dorëzimit
Rrjedha bazë për dërgimin e një mesazhi SMS përshkruhet si më poshtë:
Ofruesi i Shërbimit bën një kërkesë për t'i dërguar një mesazh SMS një marrësi përmes sistemit LINK Mobility.
Një ID e mesazhit i kthehet Ofruesit të Shërbimit. Ky ID mund të përdoret për p.sh. për të lidhur mesazhin me raportin e saktë të dorëzimit.
LINK Mobility trajton rrugëzimin dhe dërgon mesazhin SMS te Konsumatori i adresuar.
Aktivizohet një raport dorëzimi, p.sh. kur mesazhi SMS dërgohet në pajisjen e Konsumatorit.
Raporti i dorëzimit i dërgohet Ofruesit të Shërbimit. Raporti përmban të njëjtin ID të mesazhit siç u kthye në hapin 2.
Rrjedha alternative: Kërkesë e pavlefshme
Nëse parametrat e dhënë ose kredencialet e përdoruesit në kërkesë janë të pavlefshme, një gabim i kthehet Ofruesit të Shërbimit. Gabimi tregon arsyen e refuzimit dhe rrjedha përfundon. Asnjë ID e mesazhit nuk kthehet.
3. Pika përfundimtare
Burimi i SMS arrihet duke përdorur shtegun:
/restapi/v1/sms
Example URL
https://europe.ipx.com/restapi/v1/sms
Për sigurinë e lidhjes, LINK Mobility REST API është i aksesueshëm vetëm përmes HTTPS.
Certifikata e serverit Link Mobility nënshkruhet nga Thawte Server CA.
4. Operacionet
Shërbimi SMS ofron operacionet e mëposhtme:
| Emri | Rruga |
| Dërgo | /restapi/v1/sms/send |
4.1 Dërgo
Operacioni i dërgimit përdoret për të dërguar një SMS tek një marrës i vetëm.
Ky operacion është menduar për përdoruesit bazë dhe të avancuar. Në rastin më të thjeshtë, vetëm adresa e destinacionit dhe teksti i mesazhit kërkohen për të dërguar një SMS. LINK Mobility do të zbulojë skemën e kodimit të të dhënave dhe do të kryejë lidhjen automatike të një mesazhi në disa pjesë të mesazhit nëse është e nevojshme.
Për përdorim të avancuar, Ofruesi i Shërbimit mund të përdorë parametra opsionalë për kontrollin total të formatimit të mesazhit duke përfshirë kokën e të dhënave të përdoruesit.
Ofruesi i Shërbimit mund të dërgojë mesazhe të ndërlidhura, por përgatitja e të dhënave të përdoruesit dhe titulli i të dhënave të përdoruesit duhet të bëhet nga Ofruesi i Shërbimit dhe mesazhi duhet të dërgohet me anë të kërkesave të shumta dërgimi drejt LINK Mobility.
5. Autentifikimi
Emri i përdoruesit dhe fjalëkalimi dorëzohen në çdo kërkesë duke përdorur Skemën e Autentifikimit Bazë HTTP.
https://www.w3.org/Protocols/HTTP/1.0/spec.html#BasicAA
Kredencialet dërgohen në një kokë autorizimi në kërkesën HTTP. Klienti ndërton fushën e kokës siç përshkruhet këtu:
https://en.wikipedia.org/wiki/Basic_access_authentication#Client_side
Për shembullample, nëse emri i përdoruesit është john dhe changeme është fjalëkalimi, atëherë titulli i autorizimit që rezulton është:
Autorizimi: Themelore am9objpjaGFuZ2VtZSA=
Si rikthim, emri i përdoruesit dhe fjalëkalimi mund të paraqiten si parametra të kërkesës. Kjo rekomandohet vetëm për klientët që nuk mbështesin Auth bazë.
6. Paraqitja e një kërkese
6.1 Vargu i pyetjeve
Parametrat e kërkesës dorëzohen si një varg pyetësor që përmban çifte emër/vlerë. Vargu i pyetjes është i koduar duke përdorur kodimin e përqindjes (URL kodimi).
http://www.w3schools.com/tags/ref_urlencode.asp
Për shembullample, Përshëndetje Botë! është koduar si Hello+World%21.
6.2 Parametrat e detyrueshëm të kërkesës
| Emri | Gjatësia maksimale | Përshkrimi |
| Adresa e destinacionit | 40 | MSISDN ku duhet të dërgohet mesazhi SMS, duke filluar me kodin e shtetit. p.shample: 46123456789. Për disa tregje (ku MSISDN-ja e konsumatorit duhet të jetë e turbullt) kjo vlerë mund të jetë gjithashtu një pseudonim alfanumerik, i parashtesuar me "#". |
| teksti i mesazhit | 1600 | Përmbajtja e mesazheve SMS. |
6.3 Parametrat opsionalë të kërkesës (për përdorim të avancuar)
| Emri | Gjatësia maksimale | Përshkrimi |
| Adresa e origjinës | 16 | Adresa e origjinës për mesazhin SMS në dalje. Lloji i adresës së origjinës përcaktohet nga parametri originatorTON. Gjatësia maksimale e numrit të shkurtër është 16. Dërguesi alfa numerik është i kufizuar në alfabetin e paracaktuar GSM me gjatësi maksimale 11 karaktere. Gjatësia maksimale e dërguesit MSISDN është 15 (duke përdorur të njëjtin format si elementi i adresës së destinacionit). Mund të anashkalohet kur zgjidhen nga sistemi nisja Adresa dhe FillimiTON. Ky funksion varet nga tregu dhe konfigurimi. Sjellja mund të ndryshojë me integrimet e operatorit. |
| krijuesTON | 1 | Lloji i numrit të adresës fillestare (TON): 0 - Numri i shkurtër 1 - Alfa numerike (gjatësia maksimale 11) 2 - MSISDN Mund të anashkalohet kur Adresa e origjinës dhe FillimiTON do të zgjidhen nga sistemi. Ky funksion varet nga tregu dhe konfigurimi. Sjellja mund të ndryshojë me integrimet e operatorit. |
| userDataHeader | 280 | Kreu i të dhënave të përdoruesit së bashku me të dhënat e përdoruesit mund të përmbajë deri në 140, dmth 280, kur është i koduar me heks, oktetë. Ky parametër është gjithmonë i koduar me heks. |
| DCS | 3 | Skema e kodimit të të dhënave. Sjellja mund të ndryshojë me integrimet e operatorit. |
| PID | 3 | ID-ja e protokollit. Sjellja mund të ndryshojë me integrimet e operatorit. |
| relativeVlefshmëriKoha | 6 | Koha e vlefshmërisë relative në sekonda (në lidhje me kohën e paraqitjes në LINK Mobility). Vlera maksimale është 604800 (7 ditë) dhe parazgjedhja është 48 orë. Sjellja mund të ndryshojë me integrimet e operatorit. |
| koha e dorëzimit | 20 | Me kohëamp kur duhet të dërgohet mesazhi SMS (koha e vonuar e dorëzimit). Shih seksionin mbi formatin e datës së orës. |
| statusReportFlamuj | 1 | Dorëzimi i kërkesës së raportit: 0 – Nuk ka raport dorëzimi (parazgjedhur) 1 – Kërkohet raporti i dorëzimit 9 – Kërkohet raporti i dorëzimit të serverit (LINK Mobility nuk ia përcjell raportin Ofruesit të Shërbimit, por e bën të disponueshëm në raporte etj.) |
| campemri i shenjës | 50 | Transaksionet LINK Mobility janë taggjen me këtë emër. Përdoret për të grupuar transaksionet në raportet e Link Mobility. |
| maxConcatenated Messages | 1 | Një vlerë midis 1 dhe 10 e cila përcakton se sa mesazhe të lidhura lejohen. Parazgjedhja është 3. |
| korrelacionId | 100 | ID-ja e dhënë nga Ofruesi i Shërbimit që do të ketë jehonë në Raportin e Dorëzimit. |
| emri i përdoruesit | 100 | Ofrohet si një alternativë ndaj Autentifikimit Bazë HTTP. |
| fjalëkalimin | 100 | Ofrohet si një alternativë ndaj Autentifikimit Bazë HTTP. |
6.4 Metodat e Kërkesës HTTP
Për ndërveprim maksimal, API mbështet metodat e kërkesës HTTP GET dhe POST. Asnjë metodë tjetër HTTP nuk lejohet.
6.4.1 MERRNI
Vargu i koduar i pyetjes është i bashkangjitur në URL.
MERRNI
https://europe.ipx.com/restapi/v1/sms/send?destinationAddress=461234
56789&messageText=Përshëndetje+Botë%21
Autorizimi: Themelore am9objpjaGFuZ2VtZSA=
6.4.2 POST
Vargu i koduar i pyetjes dorëzohet në trupin e mesazhit të kërkesës HTTP. Lloji i përmbajtjes është aplikacioni/x-www-forma-urltë koduara.
POST https://europe.ipx.com/restapi/v1/sms/send
Pritësi: europe.ipx.com
Lloji i përmbajtjes: aplikimi / x-www-forma-urltë koduara
Autorizimi: Themelore am9objpjaGFuZ2VtZSA=
Përmbajtja-Gjatësia: 57
Adresa e destinacionit=46123456789&messageText=Përshëndetje+Botë%21
6.5 Data dhe ora
Parametrat në API REST që përfaqësojnë datën dhe kohën janë gjithmonë në zonën kohore UTC (Koha e Koordinuar Universale). Timestamps përfaqësohen si një varg me këtë format të saktë:
2017-04-25T23:20:50Z
Kjo përfaqëson 20 minuta e 50 sekonda pas orës 23 të datës 25 prill 2017 në UTC.
7. Mesazhi i përgjigjes
Pas marrjes dhe interpretimit të një mesazhi kërkese, API përgjigjet me një mesazh përgjigjeje HTTP.
7.1 Kodi i statusit HTTP
API REST kthen gjithmonë kodin e statusit HTTP 200 OK për kërkesat e përpunuara. Trupi i mesazhit përmban një kod përgjigjeje parametri që përdoret për të përcaktuar rezultatin e saktë.
7.2 Trupi i mesazhit
Trupi i mesazhit përbëhet nga JSON që përshkruan rezultatin e kërkesës.
http://json.org/
Link Mobility JSON përputhet me Udhëzuesin e stilit të Google JSON.
https://google.github.io/styleguide/jsoncstyleguide.xml
7.3 Parametrat e përgjigjes
| Emri | Gjatësia maksimale | Përshkrimi |
| Kodi i përgjigjes | 3 | 0 tregon transaksion të suksesshëm. |
| përgjigje Mesazh | 255 | Përshkrimi tekstual i përgjigjes, p.sh. teksti i gabimit. |
| kohëamp | 20 | Data dhe ora kur LINK Mobility përpunoi kërkesën. (Referojuni seksionit të formatit të datës/kohës). |
| traceId | 36 | Identifikuesi i brendshëm i Lidhjes Mobility. Përdoret për mbështetje dhe zgjidhjen e problemeve. |
| ID-të e mesazheve | 10 x 36 | Gama e ID-ve unike të mesazheve të LINK Mobility për çdo mesazh të suksesshëm (ID-të e shumëfishta të mesazheve kthehen nëse mesazhi është i lidhur). Hiqet në rast dështimi. |
7.4 Sheshample pergjigjet
Suksese
HTTP/1.1 200 OK
Lloji i përmbajtjes: aplikacion/json
Përmbajtja-Gjatësia: 144
Data: E enjte, 15 shtator 2016 13:20:31 GMT
{“responseCode”:0,”responseMessage”:”Sukses”,”timeestamp”:”2016-09-15T13:20:31Z”, “traceId”:”f678d30879fd4adc25f2″,”messageIds”:[“1-4850879008”]}
Këtu është i njëjti JSON i formatuar për lexueshmëri:
{
“Kodi i përgjigjes“:0,
“përgjigje Mesazh“:”Suksese”,
“kohëamp“:”2016-0915T13:20:31Z”,
“traceId“:”f678d30879fd4adc25f2”,
“ID-të e mesazheve":["1-4850879008"] }
Dështimi
HTTP/1.1 200 OK
Lloji i përmbajtjes: aplikacion/json
Përmbajtja-Gjatësia: 148
Data: E enjte, 15 shtator 2016 13:20:31 GMT
{“responseCode”:1,”responseMessage”:” Identifikimi i pavlefshëm ose përdorimi i paautorizuar i API-së”,”timestamp”:”2016-09-15T13:20:31Z”,”traceId”:”f678d30879fd4adc25f2″}
Suksese
HTTP/1.1 200 OK
Lloji i përmbajtjes: aplikacion/json
Përmbajtja-Gjatësia: 144
Data: E enjte, 15 shtator 2016 13:20:31 GMT
{“responseCode”:0,”responseMessage”:”Sukses”,”timeestamp”:”2016-09-15T13:20:31Z”, “traceId”:”f678d30879fd4adc25f2″,”messageIds”:[“1-4850879008”]}
Këtu është i njëjti JSON i formatuar për lexueshmëri:
{
“Kodi i përgjigjes“:0,
“përgjigje Mesazh“:”Suksese”,
“kohëamp“:”2016-0915T13:20:31Z”,
“traceId“:”f678d30879fd4adc25f2”,
“ID-të e mesazheve":["1-4850879008"] }
Dështimi
HTTP/1.1 200 OK
Lloji i përmbajtjes: aplikacion/json
Përmbajtja-Gjatësia: 148
Data: E enjte, 15 shtator 2016 13:20:31 GMT
{“responseCode”:1,”responseMessage”:” Identifikimi i pavlefshëm ose përdorimi i paautorizuar i API-së”,”timestamp”:”2016-09-15T13:20:31Z”,”traceId”:”f678d30879fd4adc25f2″}
7.5 Kodet e përgjigjes
Kodet e mëposhtme të përgjigjes mund të kthehen në përgjigjen e dërgimit:
| Kodi | Teksti | Përshkrimi |
| 0 | Suksese | Ekzekutuar me sukses. |
| 1 | Identifikimi i pavlefshëm ose përdorimi i paautorizuar i API-së | Emri i përdoruesit ose fjalëkalimi i pasaktë ose Ofruesi i Shërbimit është i ndaluar nga LINK Mobility. |
| 2 | Konsumatori është i bllokuar nga Link Mobility | Konsumatori është bllokuar nga LINK Mobility. |
| 3 | Operacioni nuk ofrohet nga LINK Mobility | Operacioni është i bllokuar për Ofruesin e Shërbimit. |
| 4 | Konsumatori është i panjohur për LINK Mobility | Konsumatori është i panjohur për LINK Mobility. Ose nëse në kërkesë është përdorur pseudonimi; pseudonimi nuk u gjet. |
| 5 | Konsumatori e ka bllokuar këtë shërbim në LINK Mobility | Konsumatori e ka bllokuar këtë shërbim në LINK Mobility. |
| 6 | Adresa e origjinës nuk mbështetet | Adresa e origjinës nuk mbështetet. |
| 7 | Adresa e origjinës alfa nuk mbështetet nga llogaria | Adresa e origjinës alfa nuk mbështetet nga llogaria. |
| 8 | Adresa e origjinës MSISDN nuk mbështetet | Adresa e origjinës MSISDN nuk mbështetet. |
| 9 | GSM i zgjeruar nuk mbështetet | GSM i zgjeruar nuk mbështetet. |
| 10 | Unicode nuk mbështetet | Unicode nuk mbështetet. |
| 11 | Raporti i statusit nuk mbështetet | Raporti i statusit nuk mbështetet. |
| 12 | Aftësia e kërkuar nuk mbështetet | Aftësia e kërkuar (përveç sa më sipër) për dërgimin e mesazhit nuk mbështetet. |
| 13 | Është tejkaluar norma maksimale e frenimit të ofruesit të përmbajtjes | Ofruesi i shërbimit po dërgon shumë shpejt mesazhet SMS te LINK Mobility. |
| 14 | ID-ja e protokollit nuk mbështetet nga llogaria | ID-ja e protokollit nuk mbështetet. |
| 15 | Kufiri i lidhjes së mesazheve u tejkalua | Numri i mesazheve të lidhura tejkalon numrin maksimal të kërkuar. |
| 16 | Mesazhi nuk mund të drejtohet. | LINK Mobility nuk ishte në gjendje të drejtonte mesazhin. |
| 17 | Periudha kohore e ndaluar | Nuk lejohet të dërgojë mesazh gjatë periudhës kohore |
| 18 | Balanca shumë e ulët në llogarinë e ofruesit të shërbimit | Ofruesi i shërbimit është bllokuar për shkak të bilancit shumë të ulët |
| 50 | Sukses i pjesshëm | Sukses i pjesshëm kur dërgoni një mesazh SMS për marrës të shumtë. |
| 99 | Gabim i brendshëm i serverit | Gabim tjetër i lëvizshmërisë së lidhjes, kontaktoni mbështetjen e LINK Mobility për më shumë informacion. |
| 100 | Adresa e pavlefshme e destinacionit | Adresa e destinacionit (MSISDN ose pseudonimi) është e pavlefshme. |
| 102 | ID e pavlefshme e referuar (e lidhur). | ID-ja e referencës është e pavlefshme, ndoshta ID-ja e referencës është përdorur tashmë, shumë e vjetër ose e panjohur. |
| 103 | Emër i pavlefshëm llogarie | Emri i llogarisë është i pavlefshëm. |
| 105 | Të dhëna meta të pavlefshme të shërbimit | Të dhënat meta të shërbimit janë të pavlefshme. |
| 106 | Adresë e pavlefshme e origjinës | Adresa e origjinës është e pavlefshme. |
| 107 | Adresa e pavlefshme e origjinës alfanumerike | Adresa e origjinës alfanumerike është e pavlefshme. |
| 108 | Koha e pavlefshme e vlefshmërisë | Koha e vlefshmërisë është e pavlefshme. |
| 109 | Koha e pavlefshme e dorëzimit | Koha e dorëzimit është e pavlefshme. |
| 110 | Përmbajtja e pavlefshme e mesazhit/të dhënat e përdoruesit | Të dhënat e përdoruesit, pra mesazhi SMS, janë të pavlefshme. |
| 111 | Gjatësia e mesazhit është e pavlefshme | Gjatësia e mesazhit SMS është e pavlefshme. |
| 112 | Titulli i pavlefshëm i të dhënave të përdoruesit | Kreu i të dhënave të përdoruesit është i pavlefshëm. |
| 113 | Skema e pavlefshme e kodimit të të dhënave | DCS është i pavlefshëm. |
| 114 | ID e pavlefshme e protokollit | PID është i pavlefshëm. |
| 115 | Flamujt e raportit të statusit të pavlefshëm | Flamujt e raportit të statusit janë të pavlefshëm. |
| 116 | TON i pavlefshëm | TON origjinal është i pavlefshëm. |
| 117 | E pavlefshme campemri aign | shekampemri i aign është i pavlefshëm. |
| 120 | Kufiri i pavlefshëm për numrin maksimal të mesazheve të lidhura | Numri maksimal i mesazheve të lidhura është i pavlefshëm. |
| 121 | Adresa e pavlefshme e origjinës msisdn | Adresa e origjinës MSISDN është e pavlefshme. |
| 122 | ID e pavlefshme e korrelacionit | ID-ja e korrelacionit është e pavlefshme. |
8. Karakteristikat opsionale
8.1 Korrigjimi MSISDN
Korrigjimi MSISDN është një veçori opsionale që mund të aktivizohet nga mbështetja e LINK Mobility nëse kërkohet.
Ky funksion do të korrigjojë adresat e destinacionit dhe do t'i rreshtojë ato me formatin e kërkuar E.164. Përveç korrigjimit të formatit, sistemi mund të kryejë gjithashtu funksione specifike të tregut, si p.sh. përkthimin e numrave francezë ndërkombëtarë për të korrigjuar numrat DOM-TOM (départements et territoires d'outre-mer) kur është e aplikueshme.
Më poshtë janë një numër i ishampshkalla e korrigjimeve:
| Adresa e destinacionit të dorëzuar | Adresa e destinacionit të korrigjuar |
| +46 (0) 702233445 | 46702233445 |
| (0046)72233445 | 46702233445 |
| +460702233445 | 46702233445 |
| 46(0)702233445 | 46702233445 |
| 46070-2233445 | 46702233445 |
| 0046702233445 | 46702233445 |
| +46 (0) 702233445aaa | 46702233445 |
| 336005199999 | 2626005199999 (Numri frëngjisht i përkthyer në një numër DOM-TOM) |
Për më tepër, është e mundur të lejohen numrat kombëtarë të telefonit për një treg të zgjedhur. Kur kjo veçori është e aktivizuar, çdo numër ndërkombëtar për tregjet e tjera duhet të dërgohet me një shenjë fillestare "+" për t'i dalluar ata nga tregu i zgjedhur.
Më poshtë janë disa ishampkorrigjimet e bëra kur përdoret Suedia (kodi i vendit 46) si treg i paracaktuar për numrat kombëtarë.
| Adresa e destinacionit të dorëzuar | Adresa e destinacionit të korrigjuar |
| 0702233445 | 46702233445 |
| 070-2233 445 | 46702233445 |
| 070.2233.4455 | 46702233445 |
| 460702233445 | 46702233445 |
| +460702233445 | 46702233445 |
| +458022334455 | 458022334455 |
| 45802233445 | E pavlefshme pasi shenja "+" mungon |
Vini re se MSISDN i korrigjuar do të përdoret nga LINK Mobility dhe do të kthehet në raportet e dorëzimit.
Ju lutemi, kontaktoni mbështetjen e LINK Mobility për më shumë informacion.
8.2 Zëvendësimi i karaktereve
Zëvendësimi i karaktereve është një veçori opsionale që mund të aktivizohet nga mbështetja e LINK Mobility nëse kërkohet.
Ky funksion do të përkthejë karakteret e alfabetit jo-GSM në të dhënat e përdoruesit (teksti SMS) në karaktere ekuivalente të alfabetit GSM kur DCS është vendosur në "GSM" (17). Për shembullample “Seqüência de teste em Português” do të përkthehet në “Seqüencia de teste em Portugues”.
9. Raportet e dorëzimit
Ofruesi i Shërbimit, nëse ofrohet, mund të kërkojë raporte për dërgimin e mesazheve SMS ose njoftime për dërgimin e mesazheve MT të dërguara. Këto raporte aktivizohen në SMSC-në e operatorit kur mesazhi MT ose i dorëzohet Konsumatorit të synuar ose fshihet, p.sh., ka skaduar ose, për ndonjë arsye, nuk mund të drejtohet.
Vetëm statusi përfundimtar i mesazhit SMS raportohet te Ofruesi i Shërbimit, dmth., dërgohet ose fshihet. Gjenerohet vetëm një raport për mesazh MT. Me statusin e fshirë, mund të zbatohet një kod arsyeje. Ky kod arsyeje specifikon arsyen e mosdorëzimit të mesazhit SMS.
Raportet drejtohen përmes LINK Mobility dhe dërgohen te Ofruesi i Shërbimit duke përdorur protokollin HTTP.
Për të marrë raporte, Ofruesi i Shërbimit duhet të zbatojë për shembullample një Java Servlet ose një faqe ASP.NET. Të dy marrin kërkesa HTTP GET ose POST.
Parametrat
Kërkesa përfshin parametrat e mëposhtëm:
| Parametri | Lloji | M/O/I* | Vlera e paracaktuar | Gjatësia maksimale | Përshkrimi |
| MessageId | varg | M | – | 22 | ID-ja e mesazhit të mesazhit MT me të cilin korrespondon ky raport. |
| Adresa e Destinacionit | varg | M | – | 40 | MSISDN e Konsumatorit, dmth. adresa e destinacionit të mesazhit origjinal MT. |
| Kodi i Statusit | numër i plotë | M | 1 | Kodi i statusit tregon statusin e mesazhit MT. Kodet e statusit të aplikueshëm janë: 0 – Dorëzuar 2 – U fshi (zbatohet kodi i arsyes) |
|
| KohaStamp | varg | M | – | 20 | Koha që tregon se kur është marrë raporti i dorëzimit nga LINK Mobility. Zona kohore e kohësamp është CET ose CEST (me orën e verës siç përcaktohet për BE). Formati: yyyyMMdd HH:mm:ss. |
| Operatori | varg | M | – | 100 | Emri i operatorit të përdorur gjatë dërgimit të mesazhit SMS ose emri i llogarisë që përdoret gjatë dërgimit të mesazhit SMS. Një listë e operatorëve të disponueshëm ofrohet nga mbështetja e LINK Mobility. |
| Kodi i arsyes | numër i plotë | O | – | 3 | Kodi i arsyes tregon pse mesazhi përfundoi në statusin e fshirë. Kodet e arsyeve të aplikueshme janë: 100 – Ka skaduar 101 – Refuzuar 102 - Gabim në format 103 – Gabim tjetër 110 – Pajtimtar i panjohur 111 – Abonenti është i ndaluar 112 – Pajtimtari nuk ofrohet 113 – Pajtimtari nuk është i disponueshëm 120 – Dështimi i SMSC 121 – Mbyllja e SMSC 122 – SMSC roaming 130 - Gabim i celularit 131 – Memoria e celularit është tejkaluar Sjellja mund të ndryshojë me integrimet e operatorit. |
| OperatoriTimeStamp | varg | O | – | 20 | Koha që tregon se kur raporti është aktivizuar në SMSC-në e Operatorit (nëse ofrohet nga Operatori). Zona kohore e kohësamp është CET ose CEST (me orën e verës siç përcaktohet për BE). Formati: yyyyMMdd HH:mm:ss. |
| StatusText | varg | O | – | 255 | Mbajtës për informacion shtesë nga Operatori, p.sh. përshkrim i qartë me tekst të statusit/arsyes. Sjellja mund të ndryshojë me integrimet e operatorit. |
| KorrelacioniId | varg | O | – | 100 | ID-ja e korrelacionit të dhënë në SendRequest ose SendTextRequest. |
| Kodi i Rrjetit të Operatorit | numër i plotë | O | – | 6 | Kodi i Rrjetit Mobile (MCC + MNC) i Operatorit. |
* M = E detyrueshme, O = Fakultative, I = Injoruar.
Ofruesi i Shërbimit duhet të sigurojë LINK Mobility me objektivin URL për raportet e dorëzimit (duke përfshirë opsionalisht kredencialet për vërtetimin bazë HTTP). Ofruesi i Shërbimit mund të zgjedhë cilën metodë të preferuar HTTP të përdorë:
HTTP POST (rekomandohet)
HTTP GET.
Exampduke përdorur HTTP GET (dorëzuar me sukses):
https://user:password@www.serviceprovider.com/receivereport?%20MessageId=122&DestinationAddress=46762050312&Operator=Vodafone&TimeStamp=20100401%2007%3A47%3A44&StatusCode=0
Exampduke përdorur HTTP GET (nuk është dorëzuar, Operatori ka dhënë kohëzgjatjenamp për ngjarjen):
Parametrat janë URL i koduar.
Kodimi i karaktereve:
Ofruesi i Shërbimit mund të zgjedhë cilin kodim të preferuar të karaktereve të përdorë:
UTF-8 (rekomandohet)
ISO-8859-1.
9.1 Njohja e ofruesit të shërbimit
Ofruesi i Shërbimit duhet të pranojë çdo raport të ofrimit. Mirënjohja mund të jetë pozitive, dmth. raporti i dorëzimit është marrë me sukses, ose negativ, pra dështim.
Ju lutemi vini re: LINK Mobility ka një afat kohor leximi për pranimet prej 30 sekondash për raportet e dorëzimit. Një skadim do të shkaktojë një riprovim të dorëzimit (nëse riprovimi aktivizohet) ose një anulim i dorëzimit (nëse riprovimi është i çaktivizuar). Kjo do të thotë që aplikacioni i Ofruesit të Shërbimit duhet të sigurojë kohë të shpejta përgjigjeje, veçanërisht gjatë ngarkesës së lartë.
Rekomandohet shumë që të pranoni raportin e dorëzimit drejt LINK Mobility përpara se ta përpunoni atë.
Rregulli për njohjen pozitive dhe negative përshkruhet si më poshtë:
Mirënjohja pozitive, ACK, raporti i dorëzimit të dorëzuar:
Kodi i përgjigjes së intervalit HTTP 200 në kombinim me përmbajtjen e mëposhtme të formatuar XML:
Mirënjohja negative, NAK, raporti i dorëzimit nuk është dorëzuar:
Çdo përgjigje përveç njohjes pozitive, p.shampKështu, një konfirmim negativ shkaktohet nga çdo kod gabimi HTTP ose nga përmbajtja e mëposhtme XML:
Përmbajtja XML mund të përdoret për të kontrolluar mekanizmin e riprovës së LINK Mobility. Një NAK do të shkaktojë riprovim, nëse aktivizohet. Për Ofruesit e Shërbimeve që nuk janë konfiguruar për mekanizmin e riprovës, përmbajtja XML është opsionale.
Më poshtë është një kërkesë dhe përgjigje HTTP POST p.shampe një raporti të dorëzimit të dorëzuar tek një Ofrues i Shërbimit:
Kërkesë HTTP:
POST /konteksti/aplikacioni HTTP/1.1
Lloji i përmbajtjes: aplikimi / x-www-forma-urli koduar;charset=utf-8
Host: server:port
Përmbajtja-Gjatësia: xx
MessageId=213123213&DestinationAddress=46762050312&Operator=Telia& OperatorTimeStamp=20130607%2010%3A45%3A00&TimeStamp=20130607%2010%3A 45%3A02&StatusCode=0
Përgjigja HTTP:
HTTP/1.1 200 OK
Lloji i përmbajtjes: tekst/i thjeshtë
9.2 Provo sërish
Sistemi LINK Mobility mund të kryejë tentativa të riprovës për dërgesat e raporteve të dorëzimit të dështuara, dmth. të papranuara. Ofruesi i shërbimit mund të zgjedhë sjelljen e preferuar të riprovës:
Nuk ka riprovë (e parazgjedhur) – mesazhi do të hidhet poshtë nëse përpjekja për lidhje dështon, koha e leximit ose për ndonjë kod gabimi HTTP.
Provo sërish – mesazhi do të ridërgohet për çdo lloj problemi lidhjeje, skadimi i kohës së leximit ose konfirmimi negativ.
Kur aktivizohet riprovimi për NAK, është e rëndësishme të kuptoni se cilët skenarë do të gjenerojnë një përpjekje të riprovës nga LINK Mobility dhe si funksionon riprovimi. Çdo Ofrues i Shërbimit ka radhën e tij të riprovës, ku mesazhet renditen sipas kohëzgjatjes së mesazhitamp. Link Mobility gjithmonë përpiqet të dërgojë fillimisht mesazhe të vjetra, edhe pse renditja individuale e mesazheve të dorëzuara te Ofruesi i Shërbimit nuk është i garantuar. Arsyeja kryesore për heqjen e mesazheve nga radha e riprovimit është një nga dy arsyet: ose mesazhi TTL skadon ose (teorikisht) radha e riprovës bëhet e plotë. TTL është i varur nga operatori dhe llogaria, dmth., mund të ndryshojë në varësi të operatorit dhe ose llojit të mesazhit, p.sh. SMS premium ose mesazh SMS me tarifë standarde.
Ofruesit e shërbimeve me riprovën e aktivizuar duhet të kontrollojnë ID-në unike të mesazhit MT për të siguruar që mesazhi nuk është marrë tashmë.
Është e rëndësishme që Ofruesi i Shërbimit të respektojë këto rregulla të thjeshta kur ndodh një gabim gjatë përpunimit të një raporti të dorëzimit nëse arsyeja e gabimit është: E përkohshme, p.sh. baza e të dhënave nuk disponohet, një NAK duhet të kthehet. LINK Mobility do ta ridërgojë mesazhin.
Përpjekja e përhershme dhe një riprovim ka të ngjarë të shkaktojnë të njëjtin lloj problemi, një ACK duhet të kthehet. Për shembullample, kur mesazhi nuk mund të analizohej saktë ose shkaktoi një gabim të papritur në kohën e ekzekutimit.
Veprimi në përputhje me rrethanat do të sigurojë që të mos shkaktohet asnjë bllokim ose degradim i xhiros për shkak të dërgimit të përsëritur të raportit të dorëzimit.
10. Këshilla për zbatimin
1. Është e mundur të përdorni tuajin web shfletuesi për të paraqitur kërkesa në API. Kjo e bën shumë të lehtë eksplorimin dhe vlerësimin e shërbimeve pa asnjë mjet zhvillimi.
2. Chrome ose Firefox rekomandohen së bashku me një shtesë të tillë si JSONView për të shfaqur JSON të formatuar bukur.
3. Ne kemi përdorur SoapUI për testimin e POST, Autentifikimin Bazë dhe për inspektimin e mesazheve të kërkesës dhe përgjigjes së papërpunuar HTTP.
4. shekURL mjeti është i dobishëm për paraqitjen e kërkesave POST me Autentifikimin Bazë. Shih ishampmë poshtë.
curl POST \
-H “Lloji i përmbajtjes: aplikim/x-www-form-urli koduar” \
-H “Autorizimi: Themelore am9objpjaGFuZ2VtZSA=” \
https://europe.ipx.com/restapi/v1/sms/send \
–data “destinationAddress=46123456789&messageText=Hello+World%21”
_______________
Transformimi i komunikimeve të personalizuara
Dokumentet / Burimet
 |
Udhëzuesi i Zbatimit të LINK Mobility REST API SMS [pdfUdhëzuesi i përdoruesit Udhëzuesi i Zbatimit të Lëvizshmërisë REST API SMS, Mobiliteti, Udhëzuesi i Zbatimit REST API SMS, REST API SMS, API SMS, SMS |
