LINK Gwida għall-Implimentazzjoni tal-Mobilità REST API SMS User Guide

LINK Gwida għall-Implimentazzjoni tal-Mobilità REST API SMS

LINK Mobility tipprovdi servizz għall-kunsinna ta' messaġġi, mikroħlasijiet, u servizzi bbażati fuq il-post. Il-pjattaforma taġixxi bħala akkwirent tal-kontenut trasparenti u b'tikketta bajda u router tat-tranżazzjonijiet bejn Fornituri tas-Servizz u Operaturi.

LINK Mobility tipprovdi API RESTful li tista' tintuża biex taċċessa s-servizzi ta' LINK Mobility bħall-bgħit ta' SMS. Din l-API hija mfassla biex tkun faċli biex tużah u kompatibbli mal-lingwi u l-oqfsa moderni kollha. Bl-użu tal-lingwa tal-għażla tiegħek, l-applikazzjoni tiegħek tista' tuża l-Link Mobility REST API biex timplimenta kapaċitajiet qawwija ta' messaġġi u ħlas

© LINK Mobilità, 10 ta’ Marzu, 2021

Informazzjoni Legali

L-informazzjoni pprovduta f'dan id-dokument hija l-unika proprjetà u l-awtur ta' Netsize. Huwa kunfidenzjali u maħsub għal użu strettament informattiv. Mhix vinkolanti u tista' tkun soġġetta għal bidliet mingħajr avviż. Kwalunkwe żvelar jew użu mhux awtorizzat għandu jitqies bħala illegali.

Netsize™ u linkmobility™ huma protetti mil-liġijiet tal-proprjetà intellettwali Franċiżi, tal-KEE u internazzjonali.

It-trademarks l-oħra kollha kkwotati huma l-unika proprjetà tas-sidien rispettivi tagħhom.

Xejn li jinsab hawnhekk m'għandu jiġi interpretat bħala li jagħti xi liċenzja jew dritt taħt il-privattiva, id-drittijiet tal-awtur jew it-trademark ta' Netsize.

NETSIZE
Société anonyme au capital de 5 478 070 euro
Siège social :62, avenue Emile Zola92100 Boulogne – Franza
418 712 477 RCS Nanterre
http://www.LinkMobility.com
http://www.linkmobility.com

Skop tad-Dokument

Dan id-dokument jiddeskrivi kif il-Fornitur tas-Servizz juża l-API LINK Mobility REST għall-SMS. Huwa maħsub għal periti tekniċi u disinjaturi li jimplimentaw is-servizzi tal-Fornitur tas-Servizz.

1. Użu Bażiku

Huwa faċli ħafna li tibgħat SMS. Inti tibgħat talba HTTP lil LINK Mobility li tista' titwettaq bl-użu biss ta' a web browser.

2. Funzjonali Overview

Is-sistema LINK Mobility tipprovdi l-funzjonalità bażika li ġejja għall-messaġġi SMS:
Tibgħat messaġġi SMS Terminati (MT) Mobile, bħal test jew messaġġi binarji (eż. WAP Push) premium u messaġġi b'rata standard.

Nirċievu rapporti ta' konsenja għal messaġġi MT sottomessi.

Nirċievu messaġġi SMS Oriġinati mill-Mobile (MO), premium u rata standard.
L-SMS REST API hija ddedikata biex tibgħat messaġġi SMS b'rata standard MT.

L-API tibgħat il-messaġġi SMS kollha b'mod mhux sinkroniku, li jippermetti karatteristiċi bħal:

"Nar u tinsa" - il-Fornitur tas-Servizz irid ikollu ħinijiet ta 'rispons aktar prevedibbli u ma jridx jistenna r-riżultat mill-Operatur.

Erġa' pprova l-funzjonalità – LINK Mobility terġa' tibgħat il-messaġġ jekk l-Operatur ikollu problemi temporanji.

2.1 Tibgħat messaġġ SMS

                                       
Fornitur tas-Servizz Netsize Konsumatur

1. Ibgħat messaġġ MT
2. L-ID tal-messaġġ lura
3. Ibgħat messaġġ SMS
4. Ikkonsenja rapport tal-kunsinna
5. Ibgħat rapport tal-kunsinna

Il-fluss bażiku biex jintbagħtu messaġġi SMS huwa deskritt kif ġej:

Il-Fornitur tas-Servizz jagħmel talba biex jibgħat messaġġ SMS lil riċevitur permezz tas-sistema LINK Mobility.

ID tal-messaġġ jintbagħat lura lill-Fornitur tas-Servizz. Din l-ID tista' tintuża biex eż. tikkorrelata l-messaġġ mar-rapport tal-kunsinna korrett.

LINK Mobility tieħu ħsieb ir-rotot u twassal il-messaġġ SMS lill-Konsumatur indirizzat.
Jiġi attivat rapport ta' konsenja, eż. meta l-messaġġ SMS jitwassal lill-apparat tal-Konsumatur.

Ir-rapport tal-kunsinna jintbagħat lill-Fornitur tas-Servizz. Ir-rapport fih l-istess ID tal-messaġġ kif rritornat fil-pass 2.

Fluss alternattiv: Talba mhux valida

Jekk il-parametri fornuti jew il-kredenzjali tal-utent fit-talba ma jkunux validi, jiġi rritornat żball lill-Fornitur tas-Servizz. L-iżball jindika r-raġuni għar-rifjut u l-fluss jintemm. L-ebda IDs tal-messaġġ ma jiġu rritornati.

3. Endpoint

Ir-riżorsa tal-SMS tiġi aċċessata permezz tal-mogħdija:
/restapi/v1/sms
Example URL
https://europe.ipx.com/restapi/v1/sms
Għas-sigurtà tal-konnessjoni l-API LINK Mobility REST hija aċċessibbli biss fuq HTTPS.
Iċ-ċertifikat tas-server tal-Link Mobility huwa ffirmat minn Thawte Server CA.

4. Operazzjonijiet

Is-servizz tal-SMS jipprovdi l-operazzjonijiet li ġejjin:

Isem	Mogħdija
Ibgħat	/restapi/v1/sms/send

4.1 Ibgħat

L-operazzjoni li tibgħat tintuża biex tibgħat SMS lil riċevitur wieħed.

Din l-operazzjoni hija maħsuba kemm għall-utenti bażiċi kif ukoll għal dawk avvanzati. Fl-aktar każ sempliċi, l-indirizz tad-destinazzjoni biss, u t-test tal-messaġġ huma meħtieġa biex iwasslu SMS. LINK Mobility se tiskopri l-Iskema ta' Kodifikazzjoni tad-Data u twettaq konkatenazzjoni awtomatika ta' messaġġ f'partijiet multipli ta' messaġġi jekk meħtieġ.

Għal użu avvanzat, il-Fornitur tas-Servizz jista' juża parametri fakultattivi għall-kontroll totali tal-ifformattjar tal-messaġġ inkluż l-header tad-dejta tal-utent.

Il-Fornitur tas-Servizz jista’ jibgħat messaġġi konkatenati, iżda l-preparazzjoni tad-dejta tal-utent u l-header tad-dejta tal-utent għandha ssir mill-Fornitur tas-Servizz u l-messaġġ irid jintbagħat permezz ta’ talbiet multipli ta’ tibgħat lil LINK Mobility.

5. Awtentikazzjoni

L-isem tal-utent u l-password huma sottomessi f'kull talba bl-użu tal-Iskema ta' Awtentikazzjoni Bażika HTTP.

https://www.w3.org/Protocols/HTTP/1.0/spec.html#BasicAA

Il-kredenzjali jintbagħtu f'header ta' Awtorizzazzjoni fit-talba HTTP. Il-klijent jibni l-field header kif deskritt hawn:

https://en.wikipedia.org/wiki/Basic_access_authentication#Client_side

Per example, jekk l-isem tal-utent huwa john u changeme hija l-password allura l-intestatura tal-Awtorizzazzjoni li tirriżulta hija:

Awtorizzazzjoni: Bażiku am9objpjaGFuZ2VtZSA=

Bħala alternattiva l-username u l-password jistgħu jiġu sottomessi bħala parametri tat-talba. Dan huwa rakkomandat biss għal klijenti li ma jappoġġjawx l-Awtoritazzjoni Bażika.

6. Sottomissjoni ta' talba

6.1 Sekwenza ta' mistoqsijiet

Il-parametri tat-talba jintbagħtu bħala sekwenza ta' mistoqsijiet li fiha pari isem/valur. Is-sekwenza ta' mistoqsija hija kodifikata bl-użu ta' Kodifikazzjoni Perċentwali (URL kodifikazzjoni).

http://www.w3schools.com/tags/ref_urlencode.asp

Per example, Hello Dinja! hija kodifikata bħala Hello+World%21.

6.2 Parametri ta' talba obbligatorji

Isem	Tul massimu	Deskrizzjoni
destinationAddress	40	L-MSISDN li l-messaġġ SMS għandu jintbagħat lejh, li jibda bil-kodiċi tal-pajjiż. Eżample: 46123456789. Għal xi swieq (fejn l-MSISDN tal-Konsumatur għandu jiġi offuskat) dan il-valur jista’ jkun ukoll alias alfanumeriku, prefissat b’“#”.
MessageText	1600	Il-kontenut tal-messaġġ SMS.

6.3 Parametri tat-talba mhux obbligatorji (għal użu avvanzat)

Isem	Tul massimu	Deskrizzjoni
originingAddress	16	L-indirizz ta' oriġini għall-messaġġ SMS li joħroġ. It-tip ta' indirizz ta' oriġini huwa definit mill-parametru originatorTON. It-tul massimu tan-numru qasir huwa 16. Il-mittent alfa numeriku huwa limitat għal Alfabett default tal-GSM b'tul massimu ta' 11-il karattru. It-tul massimu tal-mittent MSISDN huwa 15 (bl-użu tal-istess format bħall-element destinationAddress). Jistgħu jitħallew barra meta originingAddress u originingTON jintgħażlu mis-sistema. Din il-funzjoni hija dipendenti fuq is-suq u l-konfigurazzjoni. L-imġieba tista' tvarja skont l-integrazzjoni tal-Operatur.
oriġinaturTON	1	It-tip ta' numru tal-indirizz tal-oriġini (TON): 0 – Numru qasir 1 – Alfa numeriku (tul massimu 11) 2 – MSISDN Jista' jitħalla barra meta originingAddress u originingTON jintgħażlu mis-sistema. Din il-funzjoni hija dipendenti fuq is-suq u l-konfigurazzjoni. L-imġieba tista' tvarja skont l-integrazzjoni tal-Operatur.
userDataHeader	280	L-Intestatura tad-Dejta tal-Utent flimkien mad-Data tal-Utent jista' jkun fiha sa 140, jiġifieri 280 meta kodifikati b'hex, ottetti. Dan il-parametru huwa dejjem kodifikat hex.
DCS	3	Skema ta' kodifikazzjoni tad-dejta. L-imġieba tista' tvarja skont l-integrazzjoni tal-Operatur.
PID	3	ID tal-Protokoll. L-imġieba tista' tvarja skont l-integrazzjoni tal-Operatur.
relativeValidityTime	6	Ħin ta' validità relattiv f'sekondi (relattiv mal-ħin għas-sottomissjoni lil LINK Mobility). Il-valur massimu huwa 604800 (7 ijiem) u d-default huwa 48 siegħa. L-imġieba tista' tvarja skont l-integrazzjoni tal-Operatur.
ħin tal-kunsinna	20	Timestamp meta l-messaġġ SMS għandu jitwassal (ħin tal-kunsinna mdewwem). Ara t-taqsima dwar il-format tad-data tal-ħin.
statusReportFlags	1	Iwassal it-talba tar-rapport: 0 – L-ebda rapport tal-kunsinna (default) 1 – Rapport tal-kunsinna mitlub 9 – Rapport tal-kunsinna tas-server mitlub (LINK Mobility ma tibgħatx ir-rapport lill-Fornitur tas-Servizz iżda tagħmilha disponibbli f'rapporti eċċ.)
campaignName	50	It-tranżazzjonijiet LINK Mobility huma tagged b'dan l-isem. Jintuża biex jiġbor it-tranżazzjonijiet fir-rapporti tal-Link Mobility.
maxConcatenatedMessages	1	Valur bejn 1 u 10 li jiddefinixxi kemm messaġġi konkatenati huma permessi. Default huwa 3.
korrelazzjoniId	100	ID ipprovduta mill-Fornitur tas-Servizz li se ssir eku fir-Rapport ta' Kunsinna.
username	100	Ipprovdut bħala alternattiva għall-Awtentikazzjoni Bażika HTTP.
password	100	Ipprovdut bħala alternattiva għall-Awtentikazzjoni Bażika HTTP.

6.4 Metodi ta 'Talba HTTP

Għal interoperabilità massima, l-API tappoġġja kemm il-metodi ta 'talba HTTP GET kif ukoll POST. L-ebda metodu HTTP ieħor mhu permess.

6.4.1 IKOLLOK

Is-sekwenza tal-mistoqsija kodifikata hija mehmuża mal- URL.

IKOLLOK
https://europe.ipx.com/restapi/v1/sms/send?destinationAddress=461234
56789&messageText=Hello+World%21
Awtorizzazzjoni: Bażiku am9objpjaGFuZ2VtZSA=

6.4.2 POST

Is-sekwenza ta' mistoqsija kodifikata hija sottomessa fil-korp tal-messaġġ tat-talba HTTP. Content-Type huwa applikazzjoni/x-www-form-urlkodifikat.

POST https://europe.ipx.com/restapi/v1/sms/send
Ospitanti: europe.ipx.com
Tip ta' Kontenut: applikazzjoni/x-www-form-urlkodifikat
Awtorizzazzjoni: Bażiku am9objpjaGFuZ2VtZSA=
Tul tal-Kontenut: 57

destinationAddress=46123456789&messageText=Hello+World%21

6.5 Data u ħin

Il-parametri fl-API REST li jirrappreżentaw id-data u l-ħin huma dejjem fiż-żona tal-ħin UTC (Ħin Universali Koordinat). Timestamps huma rappreżentati bħala string b'dan il-format eżatt:
2017-04-25T23:20:50Z
Dan jirrappreżenta 20 minuta u 50 sekonda wara t-23 siegħa tal-25 ta' April, 2017 f'UTC.

7. Messaġġ ta 'rispons

Wara li jirċievi u jinterpreta messaġġ ta' talba l-API jirrispondi b'messaġġ ta' rispons HTTP.

7.1 Kodiċi tal-istatus HTTP

L-API REST dejjem jirritorna l-kodiċi tal-istatus HTTP 200 OK għal talbiet ipproċessati. Il-korp tal-messaġġ fih parametru responseCode li jintuża biex jiddetermina r-riżultat eżatt.

7.2 Korp tal-messaġġ

Il-korp tal-messaġġ jikkonsisti f'JSON li jiddeskrivi r-riżultat tat-talba.
http://json.org/
Link Mobility JSON jikkonforma mal-Google JSON Style Guide.
https://google.github.io/styleguide/jsoncstyleguide.xml

7.3 Parametri tar-rispons

Isem	Tul massimu	Deskrizzjoni
responseCode	3	0 jindika tranżazzjoni b'suċċess.
risponsMessage	255	Deskrizzjoni testwali tar-rispons, eż. test ta' żball.
timestamp	20	Data u ħin meta LINK Mobility ipproċessat it-talba. (Irreferi għat-taqsima tal-format tad-data/ħin).
traceId	36	Identifikatur intern tal-Mobilità. Użat għall-appoġġ u s-soluzzjoni tal-problemi.
messageIds	10 x 36	Array ta' IDs ta' messaġġ uniċi ta' LINK Mobility għal kull messaġġ ta' suċċess (IDs ta' messaġġi multipli jintbagħtu lura jekk il-messaġġ jiġi magħqud). Tħalla barra f'każ ta' falliment.

7.4 Eżample tweġibiet

Suċċess

HTTP/1.1 200 OK
Tip ta' Kontenut: applikazzjoni/json
Tul tal-Kontenut: 144
Data: Ħam, 15 ta' Settembru 2016 13:20:31 GMT
{“responseCode”:0,”responseMessage”:”Suċċess”,”timestamp”:”2016-09-15T13:20:31Z”, “traceId”:”f678d30879fd4adc25f2″,”messageIds”:[“1-4850879008”]}

Hawn hu l-istess JSON ifformattjat biex jinqara:

{
"responseCode“:0,
"risponsMessage“:”Suċċess”,
"timestamp“:”2016-0915T13:20:31Z”,
"traceId“:”f678d30879fd4adc25f2”,
"messageIds“:[“1-4850879008”]
}

Nuqqas

HTTP/1.1 200 OK
Tip ta' Kontenut: applikazzjoni/json
Tul tal-Kontenut: 148
Data: Ħam, 15 ta' Settembru 2016 13:20:31 GMT
{“responseCode”:1,”responseMessage”:” Login mhux validu jew użu mhux awtorizzat tal-API”,”timestamp”:”2016-09-15T13:20:31Z”,”traceId”:”f678d30879fd4adc25f2″}

Suċċess

HTTP/1.1 200 OK
Tip ta' Kontenut: applikazzjoni/json
Tul tal-Kontenut: 144
Data: Ħam, 15 ta' Settembru 2016 13:20:31 GMT
{“responseCode”:0,”responseMessage”:”Suċċess”,”timestamp”:”2016-09-15T13:20:31Z”, “traceId”:”f678d30879fd4adc25f2″,”messageIds”:[“1-4850879008”]}

Hawn hu l-istess JSON ifformattjat biex jinqara:

{
"responseCode“:0,
"risponsMessage“:”Suċċess”,
"timestamp“:”2016-0915T13:20:31Z”,
"traceId“:”f678d30879fd4adc25f2”,
"messageIds“:[“1-4850879008”]
}

Nuqqas

HTTP/1.1 200 OK
Tip ta' Kontenut: applikazzjoni/json
Tul tal-Kontenut: 148
Data: Ħam, 15 ta' Settembru 2016 13:20:31 GMT
{“responseCode”:1,”responseMessage”:” Login mhux validu jew użu mhux awtorizzat tal-API”,”timestamp”:”2016-09-15T13:20:31Z”,”traceId”:”f678d30879fd4adc25f2″}

7.5 Kodiċi ta' rispons

Il-kodiċijiet ta' rispons li ġejjin jistgħu jintbagħtu lura fir-rispons li jibgħat:

Kodiċi	Test	Deskrizzjoni
0	Suċċess	Esegwit b'suċċess.
1	Login invalidu jew użu mhux awtorizzat tal-API	Username jew password mhux korretta jew Fornitur tas-Servizz huwa pprojbit minn LINK Mobility.
2	Il-konsumatur huwa mblukkat minn Link Mobility	Il-Konsumatur huwa mblukkat minn LINK Mobility.
3	L-operazzjoni mhix ipprovduta minn LINK Mobility	L-operazzjoni hija mblukkata għall-Fornitur tas-Servizz.
4	Il-konsumatur mhux magħruf għal LINK Mobility	Il-Konsumatur mhux magħruf għal LINK Mobility. Jew jekk fit-talba ntuża alias; alias ma nstabx.
5	Konsumatur imblokka dan is-servizz f'LINK Mobility	Il-Konsumatur imblokka dan is-servizz f'LINK Mobility.
6	L-indirizz tal-oriġini mhuwiex appoġġjat	L-indirizz tal-oriġini mhuwiex appoġġjat.
7	Indirizz tal-oriġini alfa mhux appoġġjat mill-kont	L-indirizz tal-oriġini alfa mhuwiex sostnut mill-kont.
8	L-indirizz tal-oriġini tal-MSISDN mhux appoġġjat	L-indirizz tal-oriġini tal-MSISDN mhux appoġġjat.
9	GSM estiż mhux appoġġjat	GSM estiż mhux appoġġjat.
10	Unicode mhux appoġġjat	Unicode mhux appoġġjat.
11	Rapport tal-istatus mhux appoġġjat	Rapport tal-istatus mhux appoġġjat.
12	Kapaċità meħtieġa mhux appoġġjata	Il-kapaċità meħtieġa (minbarra dik ta' hawn fuq) biex jintbagħat il-messaġġ mhijiex appoġġjata.
13	Ir-rata massima ta' throttling tal-fornitur tal-kontenut tinqabeż	Il-Fornitur tas-Servizz qed jibgħat il-messaġġi SMS lil LINK Mobility malajr wisq.
14	ID tal-Protokoll mhux appoġġjat mill-kont	ID tal-Protokoll mhux appoġġjat.
15	Inqabeż il-limitu ta' konkatenazzjoni tal-messaġġi	In-numru ta' messaġġi konkatenati jaqbeż in-numru massimu mitlub.
16	Ma jistax iwassal il-messaġġ.	LINK Mobility ma setgħetx tibgħat il-messaġġ.
17	Perjodu ta' żmien ipprojbit	Mhux permess li jibgħat messaġġ matul il-perjodu ta 'żmien
18	Bilanċ baxx wisq fuq il-kont tal-fornitur tas-servizz	Il-fornitur tas-servizz huwa mblukkat minħabba Bilanċ baxx Wisq
50	Suċċess parzjali	Suċċess parzjali meta jintbagħat messaġġ SMS lil riċevituri multipli.
99	Żball intern tas-server	Żball ieħor ta' Link Mobility, ikkuntattja l-appoġġ ta' LINK Mobility għal aktar informazzjoni.
100	Indirizz tad-destinazzjoni mhux validu	L-indirizz tad-destinazzjoni (MSISDN, jew alias) mhuwiex validu.
102	ID ta' referenza (konnessa) mhux valida	L-ID ta 'referenza hija invalida, forsi l-ID ta' referenza hija diġà użata, antika wisq jew mhux magħrufa.
103	Isem tal-kont mhux validu	L-isem tal-kont mhuwiex validu.
105	Meta data tas-servizz mhux valida	Il-meta data tas-servizz mhix valida.
106	Indirizz ta' oriġini mhux validu	L-indirizz ta' oriġini mhuwiex validu.
107	Indirizz ta' oriġini alfanumeriku mhux validu	L-indirizz alfanumeriku ta' oriġini mhuwiex validu.
108	Żmien ta' validità mhux validu	Iż-żmien tal-validità huwa invalidu.
109	Ħin tal-kunsinna mhux validu	Il-ħin tal-kunsinna huwa invalidu.
110	Kontenut tal-messaġġ/dejta tal-utent invalida	Id-dejta tal-utent, jiġifieri l-messaġġ SMS, hija invalida.
111	Tul tal-messaġġ mhux validu	It-tul tal-messaġġ SMS mhuwiex validu.
112	Intestatura tad-dejta tal-utent mhux valida	L-intestatura tad-dejta tal-utent mhix valida.
113	Skema ta' kodifikazzjoni tad-dejta mhux valida	Id-DCS huwa invalidu.
114	ID tal-protokoll mhux validu	Il-PID huwa invalidu.
115	Bnadar ta' rapport ta' status invalidi	Il-bnadar tar-rapport tal-istatus mhumiex validi.
116	TON invalida	It-TON oriġinatur huwa invalidu.
117	Invalidu campaign isem	Il-ċampisem aign huwa invalidu.
120	Limitu mhux validu għan-numru massimu ta' messaġġi konkatenati	In-numru massimu ta' messaġġi konkatenati mhuwiex validu.
121	Indirizz ta' oriġini msisdn mhux validu	L-indirizz tal-oriġini tal-MSISDN mhuwiex validu.
122	ID ta' korrelazzjoni invalida	L-ID ta' korrelazzjoni hija invalida.

8. Karatteristiċi mhux obbligatorji

8.1 Korrezzjoni MSISDN

Il-korrezzjoni tal-MSISDN hija karatteristika fakultattiva li tista’ tiġi attivata mill-appoġġ ta’ LINK Mobility jekk tintalab.

Din il-karatteristika tikkoreġi l-indirizzi tad-destinazzjoni u tallinjahom mal-format E.164 meħtieġ. Minbarra l-korrezzjoni tal-format, is-sistema tista' twettaq ukoll funzjonalità speċifika għas-suq bħat-traduzzjoni ta' numri Franċiżi internazzjonali biex tikkoreġi n-numri DOM-TOM (départements et territoires d'outre-mer) meta applikabbli.

Hawn taħt hemm numru ta' exampil-korrezzjonijiet:

Indirizz tad-Destinazzjoni Sottomessi	Indirizz tad-Destinazzjoni Ikkoreġut
+46(0)702233445	46702233445
(0046)72233445	46702233445
+460702233445	46702233445
46(0)702233445	46702233445
46070-2233445	46702233445
0046702233445	46702233445
+46(0)702233445aaa	46702233445
336005199999	2626005199999 (Numru Franċiż tradott għal numru DOM-TOM)

Barra minn hekk, huwa possibbli li jiġu permessi numri tat-telefon nazzjonali għal suq magħżul. Meta din il-karatteristika tkun attivata kwalunkwe numri internazzjonali għal swieq oħra għandhom jintbagħtu b'sinjal inizjali "+" biex jiddistingwuhom mis-suq magħżul.

Hawn taħt hawn diversi exampil-korrezzjonijiet magħmula meta tuża l-Isvezja (kodiċi tal-pajjiż 46) bħala suq default għan-numri nazzjonali.

Indirizz tad-Destinazzjoni Sottomessi	Indirizz tad-Destinazzjoni Ikkoreġut
0702233445	46702233445
070-2233 445	46702233445
070.2233.4455	46702233445
460702233445	46702233445
+460702233445	46702233445
+458022334455	458022334455
45802233445	Invalidu peress li s-sinjal '+' huwa nieqes

Innota li l-MSISDN korrett se jintuża minn LINK Mobility u jintbagħat lura fir-rapporti tal-kunsinna.

Jekk jogħġbok ikkuntattja lill-appoġġ ta' LINK Mobility għal aktar informazzjoni.

8.2 Sostituzzjoni tal-Karattri

Is-sostituzzjoni tal-karattri hija karatteristika fakultattiva li tista' tiġi attivata mill-appoġġ ta' LINK Mobility jekk tintalab.

Din il-karatteristika se tittraduċi karattri tal-alfabett mhux GSM fid-dejta tal-utent (test tal-SMS) għal karattri tal-alfabett GSM ekwivalenti meta d-DCS ikun issettjat għal “GSM” (17). Per example “Seqüência de teste em Português” se tiġi tradotta għal “Seqüencia de teste em Portugues”.

9. Rapporti tal-kunsinna

Il-Fornitur tas-Servizz jista', jekk ipprovdut, jitlob rapporti ta' kunsinna ta' messaġġi SMS jew notifiki ta' kunsinna għall-messaġġi MT mibgħuta. Dawn ir-rapporti jiġu attivati ​​fl-Operatur SMSC meta l-messaġġ MT jew jitwassal lill-Konsumatur fil-mira jew jitħassar, eż., skada jew, għal xi raġuni, mhux routable.

L-istatus finali biss tal-messaġġ SMS jiġi rrappurtat lill-Fornitur tas-Servizz, jiġifieri, ikkunsinnat jew imħassra. Rapport wieħed biss għal kull messaġġ MT huwa ġġenerat. Bl-istatus imħassra, jista' japplika kodiċi tar-raġuni. Dan il-kodiċi tar-raġuni jispeċifika r-raġuni għaliex il-messaġġ SMS ma jitwassalx.

Ir-rapporti jintbagħtu permezz ta' LINK Mobility u jintbagħtu lill-Fornitur tas-Servizz bl-użu tal-protokoll HTTP.

Biex jirċievi rapporti, il-Fornitur tas-Servizz jeħtieġ li jimplimenta pereżempjuample a Java Servlet jew paġna ASP.NET. It-tnejn jirċievu talbiet HTTP GET jew POST.

Parametri

It-talba tinkludi l-parametri li ġejjin:

Parametru	Tip	M/O/I*	Valur Default	Tul massimu	Deskrizzjoni
MessageId	spag	M	–	22	L-ID tal-messaġġ tal-messaġġ MT li dan ir-rapport jikkorrispondi miegħu.
Indirizz tad-Destinazzjoni	spag	M	–	40	L-MSISDN tal-Konsumatur, jiġifieri l-indirizz tad-destinazzjoni tal-messaġġ MT oriġinali.
StatusCode	numru sħiħ	M		1	Kodiċi tal-istatus jindika l-istatus tal-messaġġ MT. Il-kodiċijiet tal-istatus applikabbli huma: 0 – Mogħtija 2 – Imħassar (japplika l-kodiċi tar-raġuni)
Ħin St.amp	spag	M	–	20	Ħin li jindika meta r-rapport tal-kunsinna wasal minn LINK Mobility. Iż-żona tal-ħin tal-ħinijietamp hija CET jew CEST (bil-ħin tas-sajf kif definit għall-UE). Format: yyyyMMdd HH:mm:ss.
Operatur	spag	M	–	100	L-isem tal-Operatur użat meta jintbagħat il-messaġġ SMS jew l-isem tal-kont użat meta jintbagħat il-messaġġ SMS. Lista ta' Operaturi disponibbli hija pprovduta mill-appoġġ ta' LINK Mobility.
ReasonCode	numru sħiħ	O	–	3	Il-kodiċi tar-raġuni jindika għaliex il-messaġġ spiċċa fl-istatus imħassar. Il-kodiċijiet tar-raġuni applikabbli huma: 100 – Skaduta 101 – Miċħuda 102 – Żball fil-format 103 – Żball ieħor 110 – Abbonat mhux magħruf 111 – Abbonat preskritt 112 – Abbonat mhux ipprovdut 113 – Abbonat mhux disponibbli 120 – Falliment SMSC 121 – konġestjoni SMSC 122 – SMSC roaming 130 – Żball fl-idejn 131 – Inqabeż il-memorja tal-handset L-imġieba tista' tvarja skont l-integrazzjoni tal-Operatur.
OperatorTimeStamp	spag	O	–	20	Ħin li jindika meta r-rapport ġie attivat fl-SMSC tal-Operatur (jekk ipprovdut mill-Operatur). Iż-żona tal-ħin tal-ħinijietamp hija CET jew CEST (bil-ħin tas-sajf kif definit għall-UE). Format: yyyyMMdd HH:mm:ss.
StatusText	spag	O	–	255	Placeholder għal informazzjoni addizzjonali mill-Operatur, eż. deskrizzjoni b'test ċar tal-istatus/raġuni. L-imġieba tista' tvarja skont l-integrazzjoni tal-Operatur.
KorrelazzjoniId	spag	O	–	100	L-ID ta' korrelazzjoni pprovduta fis-SendRequest jew SendTextRequest.
OperatorNetworkCode	numru sħiħ	O	–	6	Il-Kodiċi tan-Netwerk Mobbli (MCC + MNC) tal-Operatur.

* M = Obbligatorju, O = Fakultattiv, I = Injorat.
Il-Fornitur tas-Servizz għandu jipprovdi lil LINK Mobility bil-mira URL għar-rapporti tal-kunsinna (b'għażla inklużi kredenzjali għall-awtentikazzjoni bażika HTTP). Il-Fornitur tas-Servizz jista' jagħżel liema metodu HTTP preferut juża:
HTTP POST (rakkomandat)
HTTP IKOLLOK.

Example bl-użu ta' HTTP GET (konsenjat b'suċċess):
https://user:password@www.serviceprovider.com/receivereport?%20MessageId=122&DestinationAddress=46762050312&Operator=Vodafone&TimeStamp=20100401%2007%3A47%3A44&StatusCode=0

Example bl-użu ta' HTTP GET (mhux ikkunsinnat, l-Operatur ipprovda timetamp għall-avveniment):

https://user:password@www.serviceprovider.com/receivereport?MessageId=123&DestinationAddress=46762050312&Operator=Vodafone&OperatorTimeStamp=20100401%2007%3A47%3A59&TimeStamp=20100401%2007%3A47%3A51&StatusCode=2&StatusText=Delivery%20failed&ReasonCode=10

Il-parametri huma URL encodedi.

Kodifikazzjoni tal-karattri:
Il-Fornitur tas-Servizz jista' jagħżel liema kodifikazzjoni tal-karattri preferuta tuża:
UTF-8 (rakkomandat)
ISO-8859-1.

9.1 Rikonoxximent tal-Fornitur tas-Servizz

Il-Fornitur tas-Servizz għandu jirrikonoxxi kull rapport ta' kunsinna. Ir-rikonoxximent jista' jkun pożittiv, jiġifieri r-rapport tal-kunsinna riċevut b'suċċess, jew negattiv, jiġifieri falliment.

Jekk jogħġbok innota: LINK Mobility għandha żmien ta' qari għal rikonoxximenti ta' 30 sekonda għar-rapporti tal-kunsinna. Timeout se jqanqal prova mill-ġdid tal-kunsinna (jekk ipprova mill-ġdid attivat) jew kanċellazzjoni tal-kunsinna (jekk ipprova mill-ġdid diżattivat). Dan ifisser li l-applikazzjoni tal-Fornitur tas-Servizz għandha tiżgura ħinijiet ta' rispons rapidi, speċjalment waqt tagħbija għolja.

Huwa rakkomandat ħafna li tirrikonoxxi r-rapport tal-kunsinna lejn LINK Mobility qabel ma tipproċessah.

Ir-regola għal rikonoxximent pożittiv u negattiv hija deskritta kif ġej:

Rikonoxximent pożittiv, ACK, rapport tal-kunsinna mogħtija:
Kodiċi ta' rispons tal-firxa HTTP 200 flimkien mal-kontenut ifformattjat XML li ġej:

Rikonoxximent negattiv, NAK, rapport tal-kunsinna mhux ikkunsinnat:
Kwalunkwe tweġiba għajr rikonoxximent pożittiv, pereżempjuample, rikonoxximent negattiv jiġi attivat minn kwalunkwe kodiċi ta 'żball HTTP jew il-kontenut XML li ġej:

Il-kontenut XML jista' jintuża għall-kontroll tal-mekkaniżmu tal-prova mill-ġdid ta' LINK Mobility. NAK jikkawża tentattiv mill-ġdid, jekk ikun attivat. Għall-Fornituri tas-Servizzi mhux konfigurati għall-mekkaniżmu mill-ġdid, il-kontenut XML huwa fakultattiv.

Hawn taħt hemm talba u tweġiba HTTP POST example ta' rapport ta' konsenja kkonsenjat lil Fornitur tas-Servizz:

Talba HTTP:

POST /kuntest/app HTTP/1.1
Tip ta' Kontenut: applikazzjoni/x-www-form-urlkodifikat;charset=utf-8
Ospitanti: server:port
Kontenut-Tul: xx

MessageId=213123213&DestinationAddress=46762050312&Operator=Telia& OperatorTimeStamp=20130607%2010%3A45%3A00&TimeStamp=20130607%2010%3A 45%3A02&StatusCode=0

Rispons HTTP:

HTTP/1.1 200 OK
Tip ta' Kontenut: test/sempliċi

9.2 Ipprova mill-ġdid

Is-sistema LINK Mobility tista' twettaq tentattivi mill-ġdid għal kunsinni ta' rapporti ta' konsenja falluti, jiġifieri mhux rikonoxxuti. Il-Fornitur tas-Servizz jista' jagħżel l-imġieba preferuta mill-ġdid:

Nru ipprova mill-ġdid (default) – il-messaġġ se jintrema jekk it-tentattiv ta' konnessjoni jfalli, aqra time-out jew għal kwalunkwe kodiċi ta' żball HTTP.

Ipprova mill-ġdid – il-messaġġ se jintbagħat mill-ġdid għal kull tip ta 'problema ta' konnessjoni, timeout tal-qari, jew rikonoxximent negattiv.

Meta l-prova mill-ġdid għal NAK tkun attivata, huwa importanti li tifhem liema xenarji se jiġġeneraw tentattiv mill-ġdid minn LINK Mobility u kif jaħdem il-prova mill-ġdid. Kull Fornitur tas-Servizz għandu l-kju mill-ġdid tiegħu, fejn il-messaġġi huma ordnati skont il-ħin tal-messaġġamp. Link Mobility dejjem tipprova twassal messaġġi eqdem l-ewwel, anki jekk l-ordni individwali tal-messaġġi kkonsenjati lill-Fornitur tas-Servizz mhix garantita. Ir-raġuni ewlenija għall-messaġġi li jintremew mill-kju mill-ġdid hija waħda minn żewġ raġunijiet: jew il-messaġġ TTL jiskadi jew (teoretikament) il-kju mill-ġdid jimtela. It-TTL huwa dipendenti fuq l-Operatur u l-kont, jiġifieri, jista' jvarja skont l-Operatur u/jew it-tip ta' messaġġ, eż. SMS premium jew messaġġ SMS b'rata standard.

Fornituri tas-Servizzi b'retry attivat għandhom jiċċekkjaw l-ID uniku tal-messaġġ MT biex jiżguraw li l-messaġġ ma jkunx diġà wasal.

Huwa importanti li l-Fornitur tas-Servizzi jikkonforma ma' dawn ir-regoli sempliċi meta jseħħ żball waqt l-ipproċessar ta' rapport ta' kunsinna jekk ir-raġuni għall-iżball tkun: Temporanju, eż. database mhux disponibbli, NAK għandu jintbagħat lura. LINK Mobility se terġa' tibgħat il-messaġġ.

Permanenti u tentattiv mill-ġdid x'aktarx li jikkawżaw l-istess tip ta 'problema, ACK għandu jintbagħat lura. Per example, meta l-messaġġ ma setax jiġi parsed b'mod korrett jew ikkawża żball runtime mhux mistenni.

Jekk taġixxi kif xieraq, ma jkun ikkawżat l-ebda imblukkar jew degradazzjoni ta' throughput minħabba li rapport ta' kunsinna jintbagħat mill-ġdid ripetutament.

10. Suġġerimenti dwar l-implimentazzjoni

1. Huwa possibbli li tuża tiegħek web browser biex jissottometti talbiet lill-API. Dan jagħmilha faċli ħafna li tesplora u tevalwa s-servizzi mingħajr ebda għodda ta 'żvilupp.

2. Chrome jew Firefox huma rakkomandati flimkien ma' estensjoni bħal JSONView biex turi JSON ifformattjat pjuttost.

3. Aħna użajna SoapUI għall-ittestjar tal-POST, l-Awtentikazzjoni Bażika u biex nispezzjonaw it-talba HTTP mhux ipproċessata u l-messaġġi tar-rispons.

https://www.soapui.org/

4. Il-ċURL għodda hija utli biex jiġu sottomessi talbiet POST bl-Awtentikazzjoni Bażika. Ara example hawn taħt.

https://curl.haxx.se/

curl POST
-H "Tip-Kontenut: applikazzjoni/x-www-form-urlkodifikata”
-H “Authorization: Basic am9objpjaGFuZ2VtZSA=”
https://europe.ipx.com/restapi/v1/sms/send
–data “destinationAddress=46123456789&messageText=Hello+World%21”

_______________

It-trasformazzjoni tal-Komunikazzjonijiet Personalizzati