LINK Treoir Forfheidhmithe Soghluaisteachta REST API SMS
Soláthraíonn LINK Mobility seirbhís do sheachadadh teachtaireachtaí, micrea-íocaíochtaí, agus seirbhísí bunaithe ar shuíomh. Feidhmíonn an t-ardán mar fhaighteoir inneachair trédhearcach, lipéad bán agus mar ródaire idirbhirt idir Soláthraithe Seirbhíse agus Oibreoirí.
Soláthraíonn LINK Mobility API RESTful is féidir a úsáid chun rochtain a fháil ar sheirbhísí Soghluaisteachta LINK ar nós SMS a sheoladh. Tá an API seo deartha le bheith éasca le húsáid agus comhoiriúnach le gach teanga agus creat nua-aimseartha. Ag baint úsáide as do rogha teanga is féidir le d’iarratas an Link Mobility REST API a úsáid chun cumais chumhachtacha teachtaireachtaí agus íocaíochta a chur i bhfeidhm
© Soghluaisteacht NASC, 10 Márta, 2021
Eolas Dlí
Is le Netsize amháin an t-eolas a thugtar sa doiciméad seo agus cóipcheart. Tá sé faoi rún agus beartaithe le haghaidh úsáide faisnéise go docht. Níl sé ceangailteach agus d'fhéadfadh sé a bheith faoi réir athruithe gan fógra. Measfar aon nochtadh nó úsáid neamhúdaraithe a bheith neamhdhleathach.
Tá Netsize™ agus linkmobility™ faoi chosaint ag dlíthe maoine intleachtúla na Fraince, CEE agus idirnáisiúnta.
Is maoin aonair na n-úinéirí faoi seach iad na trádmharcanna eile go léir a luaitear.
Ní fhorléireofar aon ní atá anseo mar ní a thugann aon cheadúnas nó ceart faoi phaitinn, cóipcheart, nó trádmharc Netsize.
NETSIZE
Société gan ainm nó caipitil de 5 478 070 euro
Siège social :62, avenue Emile Zola92100 Boulogne – An Fhrainc
418 712 477 RCS Nanterre
http://www.LinkMobility.com
http://www.linkmobility.com
Scóip an Doiciméid
Déanann an doiciméad seo cur síos ar an gcaoi a n-úsáideann an Soláthraí Seirbhíse an API Soghluaisteachta LINK REST le haghaidh SMS. Tá sé dírithe ar ailtirí teicniúla agus dearthóirí a chuireann seirbhísí an tSoláthraí Seirbhíse i bhfeidhm.
1. Úsáid Bhunúsach
Tá sé an-éasca SMS a sheoladh. Cuireann tú iarratas HTTP chuig LINK Mobility is féidir a chur i gcrích trí úsáid a bhaint as a web bhrabhsálaí.
2. Thar Feidhmeview
Soláthraíonn an córas Soghluaisteachta LINK an fheidhmiúlacht bhunúsach seo a leanas le haghaidh teachtaireachtaí SMS:
Teachtaireachtaí SMS Soghluaiste Foirceanta (MT) a sheoladh, amhail teachtaireachtaí téacs nó dénártha (m.sh. WAP Push) préimhe agus teachtaireachtaí ar ráta caighdeánach.
Ag fáil tuairiscí seachadta le haghaidh teachtaireachtaí MT a cuireadh isteach.
Teachtaireachtaí SMS Tionscanta Móibíleach (MO) a fháil, mar aon le hardráta agus ráta caighdeánach.
Tá an SMS REST API tiomanta do theachtaireachtaí SMS MT ar ráta caighdeánach a sheoladh.
Seolann an API gach teachtaireacht SMS go neamhshioncronach, ag cumasú gnéithe ar nós:
“Tine agus Dearmad” – tá an Soláthraí Seirbhíse ag iarraidh amanna freagartha níos intuartha a bheith aige agus níl sé ag iarraidh fanacht ar an toradh ón Oibreoir.
Feidhmiúlacht atriail - Seolfaidh LINK Mobility an teachtaireacht arís má bhíonn fadhbanna sealadacha ag an Oibritheoir.
2.1 Teachtaireacht SMS a sheoladh
Soláthraí Seirbhíse Netsize Consumer
- Seol teachtaireacht MT
- Cuir ID na teachtaireachta ar ais
- Seol teachtaireacht SMS
- Tuairisc seachadta a sheachadadh
- Seol tuairisc seachadta
Déantar cur síos ar an sreabhadh bunúsach chun teachtaireachtaí SMS a sheoladh mar seo a leanas:
Déanann an Soláthraí Seirbhíse iarratas chun teachtaireacht SMS a sheoladh chuig faighteoir trí chóras Soghluaisteachta LINK.
Seoltar ID teachtaireachta ar ais chuig an Soláthraí Seirbhíse. Is féidir an t-aitheantas seo a úsáid le haghaidh m.sh. an teachtaireacht a chomhghaolú leis an tuairisc seachadta ceart.
Láimhseálann LINK Mobility ródú agus seachadann sé an teachtaireacht SMS don Tomhaltóir ar a ndírítear.
Spreagtar tuairisc seachadta, m.sh. nuair a sheachadtar an teachtaireacht SMS chuig gléas an Tomhaltóra.
Seoltar an tuairisc seachadta chuig an Soláthraí Seirbhíse. Tá an t-aitheantas teachtaireachta céanna sa tuarascáil agus a cuireadh ar ais i gcéim 2.
Sreabhadh malartach: Iarratas neamhbhailí
Má tá na paraiméadair a soláthraíodh nó na dintiúir úsáideora san iarratas neamhbhailí cuirtear earráid ar ais chuig an Soláthraí Seirbhíse. Léiríonn an earráid an chúis atá leis an diúltú agus críochnaíonn an sreabhadh. Ní chuirtear aon aitheantas teachtaireachta ar ais.
3. Críochphointe
Tá rochtain ar an acmhainn SMS ag baint úsáide as an gcosán:
/restapi/v1/sms
Example URL
https://europe.ipx.com/restapi/v1/sms
Ar mhaithe le slándáil naisc níl rochtain ar an LINK Mobility REST API ach thar HTTPS.
Tá an teastas freastalaí Link Mobility sínithe ag Thawte Server CA.
4. Oibríochtaí
Soláthraíonn an tseirbhís SMS na hoibríochtaí seo a leanas:
| Ainm | Conair |
| Seol | /restapi/v1/sms/seol |
4.1 Seol
Úsáidtear an oibríocht seolta chun SMS a sheoladh chuig faighteoir amháin.
Tá an oibríocht seo dírithe ar úsáideoirí bunúsacha agus ardúsáideoirí araon. Sa chás is simplí, ní gá ach seoladh ceann scríbe, agus téacs na teachtaireachta, chun SMS a sheachadadh. Braithfidh LINK Mobility an Scéim um Chódú Sonraí agus déanfaidh sé comhghaolú uathoibríoch ar theachtaireacht ina ilchodanna teachtaireachta más gá.
Chun ardúsáid a bhaint as, is féidir leis an Soláthraí Seirbhíse paraiméadair roghnacha a úsáid chun formáidiú na teachtaireachta a rialú go hiomlán lena n-áirítear an ceanntásc sonraí úsáideora.
Is féidir leis an Soláthraí Seirbhíse teachtaireachtaí comhcheangailte a sheoladh, ach ní mór don Soláthraí Seirbhíse ullmhú na sonraí úsáideora agus an ceanntásc sonraí úsáideora agus ní mór an teachtaireacht a sheoladh trí iarratais seolta iolracha i dtreo LINK Mobility.
5. Fíordheimhniú
Cuirtear ainm úsáideora agus pasfhocal isteach i ngach iarratas ag baint úsáide as Bunscéim Fíordheimhnithe HTTP.
https://www.w3.org/Protocols/HTTP/1.0/spec.html#BasicAA
Seoltar dintiúir i gceanntásc Údaraithe san iarratas HTTP. Tógann an cliant an réimse ceanntásca mar a thuairiscítear anseo:
https://en.wikipedia.org/wiki/Basic_access_authentication#Client_side
Le haghaidh example, más é john an t-ainm úsáideora agus más é changeme an pasfhocal, is é an ceanntásc Údaraithe a leanann é:
Údarú: Basic am9objpjaGFuZ2VtZSA=
Mar chúltaca is féidir an t-ainm úsáideora agus an pasfhocal a chur isteach mar pharaiméadair iarratais. Ní mholtar é seo ach amháin do chliaint nach dtacaíonn Basic Auth leo.
6. Iarratas a chur isteach
6.1 Teaghrán iarratais
Cuirtear paraiméadair iarratais isteach mar theaghrán ceisteanna ina bhfuil péirí ainm/luacha. Tá an teaghrán iarratais ionchódaithe le hIonchódú Céatadáin (URL ionchódú).
http://www.w3schools.com/tags/ref_urlencode.asp
Le haghaidh example, Dia duit Domhanda! atá ionchódaithe mar Hello+World% 21.
6.2 Paraiméadair iarratais éigeantacha
| Ainm | Fad uasta | Cur síos |
| ceann scríbeSeoladh | 40 | An MSISDN ar cheart an teachtaireacht SMS a sheoladh chuige, ag tosú le cód tíre. exampfaoi: 46123456789. I gcás margaí áirithe (a bhfuil gá le MSISDN an Tomhaltóra a cheilt orthu) is féidir leis an luach seo a bheith ina ailias alfa-uimhriúla freisin, arna réamhshocrú le “#”. |
| teachtaireachtText | 1600 | Ábhar na teachtaireachta SMS. |
6.3 Paraiméadair iarratais roghnacha (le haghaidh ardúsáide)
| Ainm | Fad uasta | Cur síos |
| originatingSeoladh | 16 | An seoladh tionscnaimh don teachtaireacht SMS atá ag dul as oifig. Sainmhínítear an cineál seoladh tionscnaimh ag paraiméadar an tionscnaimh. Is é 16 fad uasta an uimhir ghearr. Tá seoltóir alfa-uimhriúil teoranta do Aibítir réamhshocraithe GSM le 11 carachtar ar a mhéad. Tá uasfhad an tseoltóra MSISDN cothrom le 15 (ag baint úsáide as an bhformáid chéanna leis an eilimint destinationAddress). Is féidir é a fhágáil ar lár nuair a roghnaíonn an córas originatingAddress and originatingTON. Braitheann an fheidhm seo ar an margadh agus ar chumraíocht. Féadfaidh iompar a bheith éagsúil le comhtháthú Oibreora. |
| tionscnóirTON | 1 | Cineál uimhreach an tseolta tionscnaimh (TON): 0 – Uimhir ghearr 1 – Alfa-uimhriúil (uasfhad 11) 2 – MSISDN Is féidir é a fhágáil ar lár nuair a roghnóidh an córas originAddress and originatingTON. Braitheann an fheidhm seo ar an margadh agus ar chumraíocht. Féadfaidh iompar a bheith éagsúil le comhtháthú Oibreora. |
| úsáideoirDataHeader | 280 | Is féidir suas le 140, ie 280 nuair a bhíonn heics-ionchódaithe, octets a bheith i gCeanntásc Sonraí Úsáideora mar aon leis na Sonraí Úsáideora. Tá heics-ionchódaithe ar an bparaiméadar seo i gcónaí. |
| DCS | 3 | Scéim códaithe sonraí. Féadfaidh iompar a bheith éagsúil le comhtháthú Oibreora. |
| PID | 3 | Aitheantas Prótacail. Féadfaidh iompar a bheith éagsúil le comhtháthú Oibreora. |
| coibhneastaValidityTime | 6 | Am bailíochta choibhneasta i soicindí (i gcoibhneas leis an am le cur isteach chuig LINK Mobility). Is é an luach uasta ná 604800 (7 lá) agus is é 48 uair an chloig an réamhshocrú. Féadfaidh iompar a bheith éagsúil le comhtháthú Oibreora. |
| Am seachadta | 20 | Timestamp cathain ba cheart teachtaireacht SMS a sheachadadh (am seachadta moille). Féach an rannán ar fhormáid dáta am. |
| Bratacha tuairisce stádais | 1 | Iarratas tuairisce a sheachadadh: 0 – Gan tuairisc seachadta (réamhshocraithe) 1 – Tuairisc seachadta iarrtha 9 – Tuairisc seachadta freastalaí iarrtha (ní chuireann LINK Mobility an tuarascáil ar aghaidh chuig an Soláthraí Seirbhíse ach cuireann sí ar fáil i dtuarascálacha í etc.) |
| campaignAinm | 50 | Is iad na hidirbhearta Soghluaisteachta LINK tagged leis an ainm seo. Úsáidtear é chun idirbhearta a ghrúpáil i dtuarascálacha Link Mobility. |
| maxConcatenatedMessages | 1 | Luach idir 1 agus 10 a shainmhíníonn cé mhéad teachtaireachtaí comhcheangailte a cheadaítear. Is é 3 an réamhshocrú. |
| comhghaol Id | 100 | Aitheantas arna sholáthar ag Soláthraí Seirbhíse a bheidh macalla sa Tuarascáil Seachadta. |
| ainm úsáideora | 100 | Ar fáil mar mhalairt ar Fíordheimhniú Bunúsach HTTP. |
| pasfhocal | 100 | Ar fáil mar mhalairt ar Fíordheimhniú Bunúsach HTTP. |
6.4 Modhanna Iarratais HTTP
Ar mhaithe le hidir-inoibritheacht uasta, tacaíonn an API le modhanna iarratais HTTP GET agus POST. Ní cheadaítear aon mhodhanna HTTP eile.
6.4.1 FAIGH
Tá an teaghrán ceisteanna ionchódaithe i gceangal leis an URL.
FAIGH
https://europe.ipx.com/restapi/v1/sms/send?destinationAddress=461234
56789&messageText=Dia duit+Domhain%21
Údarú: Basic am9objpjaGFuZ2VtZSA=
6.4.2 POST
Cuirtear an teaghrán iarratais ionchódaithe isteach i gcorp teachtaireachta an iarratais HTTP. Is éard is Cineál Ábhar ann ná feidhmchlár/x-www-form-urlionchódaithe.
POST https://europe.ipx.com/restapi/v1/sms/send
Óstach: europe.ipx.com
Cineál Ábhar: iarratas/x-www-form-urlionchódaithe
Údarú: Basic am9objpjaGFuZ2VtZSA=
Ábhar-Fad: 57
scríbeAddress=46123456789&messageText=Dia duit+Domhain% 21
6.5 Dáta agus am
Tá paraiméadair san API REST a léiríonn dáta agus am i gcónaí i gcrios ama UTC (Am Uilíoch Comhordaithe). TimestampLéirítear s mar theaghrán leis an bhformáid bheacht seo:
2017-04-25T23:20:50Z
Léiríonn sé seo 20 nóiméad agus 50 soicind tar éis an 23ú uair an chloig de 25 Aibreán, 2017 in UTC.
7. Teachtaireacht freagartha
Tar éis teachtaireacht iarratais a fháil agus a léirmhíniú freagraíonn an API le teachtaireacht freagartha HTTP.
7.1 Cód stádais HTTP
Tugann an REST API cód stádais HTTP 200 OK ar ais i gcónaí le haghaidh iarratais próiseáilte. Tá cód freagartha paraiméadar i gcorp na teachtaireachta a úsáidtear chun an toradh beacht a chinneadh.
7.2 Comhlacht teachtaireachta
Is éard atá sa chomhlacht teachtaireachta JSON a dhéanann cur síos ar thoradh an iarratais.
http://json.org/
Comhlíonann Link Mobility JSON Treoir Stíle Google JSON.
https://google.github.io/styleguide/jsoncstyleguide.xml
7.3 Paraiméadair freagartha
| Ainm | Fad uasta | Cur síos |
| Cód freagartha | 3 | Léiríonn 0 idirbheart rathúil. |
| responseMessage | 255 | Cur síos ar théacs an fhreagra, m.sh. téacs earráide. |
| uairamp | 20 | Dáta agus am ar phróiseáil LINK Mobility an t-iarratas. (Déan tagairt don chuid formáid dáta/ama). |
| rian Id | 36 | Nasc Aitheantóir inmheánach Soghluaisteachta. Úsáidtear é le haghaidh tacaíochta agus fabhtcheartaithe. |
| teachtaireacht Ids | 10×36 | Eagar Aitheantais teachtaireachta uathúla Soghluaisteacht NASC do gach teachtaireacht rathúil (cuirtear ar ais IDanna il-teachtaireachtaí má tá an teachtaireacht comhcheangailte). Fágadh ar lár i gcás teipe. |
7.4 Example freagraí
Rath
HTTP/1.1 200 OK
Cineál Ábhar: iarratas/json
Ábhar-Fad: 144
Dáta: Déardaoin, 15 Meán Fómhair 2016 13:20:31 GMT
{"responseCode":0, "responseMessage": "Rath","uairamp”:”2016-09-15T13:20:31Z”, “traceId”:”f678d30879fd4adc25f2″,”messageIds”:[“1-4850879008”]}
Seo é an JSON céanna formáidithe maidir le hinléiteacht:
{
“Cód freagartha“:0,
“responseMessage“:”Rath”,
“uairamp“:”2016-0915T13:20:31Z”,
“rian Id“:”f678d30879fd4adc25f2”,
“teachtaireacht Ids“:[“1-4850879008”] }
Teip
HTTP/1.1 200 OK
Cineál Ábhar: iarratas/json
Ábhar-Fad: 148
Dáta: Déardaoin, 15 Meán Fómhair 2016 13:20:31 GMT
{"responseCode": 1, "responseMessage": "Logáil isteach neamhbhailí nó úsáid API neamhúdaraithe",," an t-am is móamp”:”2016-09-15T13:20:31Z”,”traceId”:”f678d30879fd4adc25f2″}
Rath
HTTP/1.1 200 OK
Cineál Ábhar: iarratas/json
Ábhar-Fad: 144
Dáta: Déardaoin, 15 Meán Fómhair 2016 13:20:31 GMT
{"responseCode":0, "responseMessage": "Rath","uairamp”:”2016-09-15T13:20:31Z”, “traceId”:”f678d30879fd4adc25f2″,”messageIds”:[“1-4850879008”]}
Seo é an JSON céanna formáidithe maidir le hinléiteacht:
{
“Cód freagartha“:0,
“responseMessage“:”Rath”,
“uairamp“:”2016-0915T13:20:31Z”,
“rian Id“:”f678d30879fd4adc25f2”,
“teachtaireacht Ids“:[“1-4850879008”] }
Teip
HTTP/1.1 200 OK
Cineál Ábhar: iarratas/json
Ábhar-Fad: 148
Dáta: Déardaoin, 15 Meán Fómhair 2016 13:20:31 GMT
{"responseCode": 1, "responseMessage": "Logáil isteach neamhbhailí nó úsáid API neamhúdaraithe",," an t-am is móamp”:”2016-09-15T13:20:31Z”,”traceId”:”f678d30879fd4adc25f2″}
7.5 Cóid freagartha
Is féidir na cóid freagartha seo a leanas a chur ar ais sa fhreagra seolta:
| Cód | Téacs | Cur síos |
| 0 | Rath | D'éirigh leis a rith. |
| 1 | Logáil isteach neamhbhailí nó úsáid API neamhúdaraithe | Cuireann LINK Mobility cosc ar ainm úsáideora nó pasfhocal mícheart nó ar Sholáthraí Seirbhíse. |
| 2 | Cuireann Link Mobility bac ar an tomhaltóir | Cuireann LINK Soghluaisteacht bac ar an Tomhaltóir. |
| 3 | Ní sholáthraíonn LINK Mobility an oibríocht | Tá bac ar an oibríocht don Soláthraí Seirbhíse. |
| 4 | Níl an tomhaltóir ar eolas ag LINK Mobility | Níl an Tomhaltóir ar eolas ag LINK Mobility. Nó dá mba rud é gur úsáideadh ailias san iarraidh; ailias gan aimsiú. |
| 5 | Chuir an tomhaltóir bac ar an tseirbhís seo in LINK Mobility | Chuir an Tomhaltóir bac ar an tseirbhís seo in LINK Mobility. |
| 6 | Ní thacaítear leis an seoladh tionscnaimh | Ní thacaítear leis an seoladh tionscnaimh. |
| 7 | Ní thacaítear leis an seoladh alfa de thionscnamh an chuntais | Ní thacaítear leis an seoladh alfa tionscnaimh. |
| 8 | Ní thacaítear le seoladh tionscnaimh MSISDN | Ní thacaítear leis an seoladh tionscnaimh MSISDN. |
| 9 | Ní thacaítear leis an síneadh GSM | Ní thacaítear leis an síneadh GSM. |
| 10 | Ní thacaítear le Unicode | Ní thacaítear le Unicode. |
| 11 | Ní thacaítear leis an tuarascáil stádais | Ní thacaítear leis an tuarascáil stádais. |
| 12 | Ní thacaítear leis an gcumas riachtanach | Ní thacaítear leis an gcumas riachtanach (seachas an méid thuas) chun an teachtaireacht a sheoladh. |
| 13 | Sáraítear uasráta smeartha an tsoláthraí ábhair | Tá an Soláthraí Seirbhíse ag seoladh na teachtaireachtaí SMS chuig LINK Mobility ró-thapa. |
| 14 | Ní thacaítear leis an aitheantas prótacail ag an gcuntas | Ní thacaítear le haitheantas prótacail. |
| 15 | Sáraíodh an teorainn chomhcheangail teachtaireachta | Sáraíonn líon na dteachtaireachtaí comhcheangailte an t-uaslíon a iarradh. |
| 16 | Ní féidir an teachtaireacht a sheoladh. | Níorbh fhéidir le LINK Mobility an teachtaireacht a threorú. |
| 17 | Tréimhse ama toirmiscthe | Ní cheadaítear teachtaireacht a sheoladh le linn na tréimhse ama |
| 18 | Iarmhéid ró-íseal ar chuntas soláthraí seirbhíse | Tá bac ar sholáthraí seirbhíse mar gheall ar chothromaíocht ró-íseal |
| 50 | Rath i bpáirt | Rath go páirteach nuair a sheoltar teachtaireacht SMS chuig faighteoirí iolracha. |
| 99 | Earráid freastalaí inmheánach | Earráid Soghluaisteachta Nasc Eile, déan teagmháil le tacaíocht Soghluaisteachta LINK chun tuilleadh eolais a fháil. |
| 100 | Seoladh sprice neamhbhailí | Tá an seoladh sprice (MSISDN, nó ailias) neamhbhailí. |
| 102 | Aitheantas tagartha (nasctha) neamhbhailí | Tá an t-aitheantas tagartha neamhbhailí, b'fhéidir go bhfuil an t-aitheantas tagartha in úsáid cheana féin, ró-shean nó anaithnid. |
| 103 | Ainm cuntais neamhbhailí | Tá ainm an chuntais neamhbhailí. |
| 105 | Meiteashonraí seirbhíse neamhbhailí | Tá na meiteashonraí seirbhíse neamhbhailí. |
| 106 | Seoladh tionscnaimh neamhbhailí | Tá an seoladh tionscnaimh neamhbhailí. |
| 107 | Seoladh tionscnaimh alfa-uimhriúil neamhbhailí | Tá an seoladh tionscnaimh alfa-uimhriúil neamhbhailí. |
| 108 | Am bailíochta neamhbhailí | Tá an t-am bailíochta neamhbhailí. |
| 109 | Am seachadta neamhbhailí | Tá an t-am seachadta neamhbhailí. |
| 110 | Ábhar teachtaireachta/sonraí úsáideora neamhbhailí | Tá na sonraí úsáideora, ie an teachtaireacht SMS, neamhbhailí. |
| 111 | Fad teachtaireachta neamhbhailí | Tá fad na teachtaireachta SMS neamhbhailí. |
| 112 | Ceanntásc sonraí úsáideora neamhbhailí | Tá an ceanntásc sonraí úsáideora neamhbhailí. |
| 113 | Scéim códaithe sonraí neamhbhailí | Tá an DCS neamhbhailí. |
| 114 | Aitheantas prótacail neamhbhailí | Tá an PID neamhbhailí. |
| 115 | Bratacha tuairisce stádais neamhbhailí | Tá bratacha na tuarascála stádais neamhbhailí. |
| 116 | TON neamhbhailí | Tá an tionscnóir TON neamhbhailí. |
| 117 | Neamhbhailí campaign ainm | Tá an campaign ainm atá neamhbhailí. |
| 120 | Teorainn neamhbhailí maidir le huaslíon na dteachtaireachtaí comhcheangailte | Tá uaslíon na dteachtaireachtaí comhcheangailte neamhbhailí. |
| 121 | Seoladh tionscnaimh msisdn neamhbhailí | Tá an seoladh tionscnaimh MSISDN neamhbhailí. |
| 122 | Aitheantas comhghaoil neamhbhailí | Tá an t-aitheantas comhghaoil neamhbhailí. |
8. Gnéithe roghnacha
8.1 Ceartú MSISDN
Is gné roghnach é ceartú MSISDN ar féidir é a chumasú le tacaíocht Soghluaisteachta LINK má iarrtar é.
Ceartóidh an ghné seo seoltaí ceann scríbe agus ailíniú leis an bhformáid E.164 atá riachtanach. Chomh maith le ceartú formáide, féadfaidh an córas feidhmiúlacht a bhaineann go sonrach leis an margadh a chomhlíonadh, amhail uimhreacha Francacha idirnáisiúnta a aistriú chun uimhreacha DOM-TOM (départements et territoires d'outre-mer) a cheartú nuair is infheidhme.
Anseo thíos tá roinnt seanampníos lú ceartúcháin:
| Seoladh Ceann Scríbe curtha isteach | Seoladh Ceann Scríbe Ceartaithe |
| +46(0)702233445 | 46702233445 |
| (0046)72233445 | 46702233445 |
| +460702233445 | 46702233445 |
| 46(0)702233445 | 46702233445 |
| 46070-2233445 | 46702233445 |
| 0046702233445 | 46702233445 |
| +46(0)702233445aaa | 46702233445 |
| 336005199999 | 2626005199999 (Uimhir Fraincise aistrithe go huimhir DOM-TOM) |
Ina theannta sin, is féidir uimhreacha gutháin náisiúnta a cheadú do mhargadh roghnaithe. Nuair atá an ghné seo cumasaithe ní mór aon uimhreacha idirnáisiúnta do mhargaí eile a sheoladh le comhartha `+' tosaigh chun iad a idirdhealú ón margadh roghnaithe.
Anseo thíos tá roinnt seanampníos lú ceartúcháin a rinneadh agus an tSualainn in úsáid (cód tíre 46) mar mhargadh réamhshocraithe le haghaidh uimhreacha náisiúnta.
| Seoladh Ceann Scríbe curtha isteach | Seoladh Ceann Scríbe Ceartaithe |
| 0702233445 | 46702233445 |
| 070-2233 445 | 46702233445 |
| 070.2233.4455 | 46702233445 |
| 460702233445 | 46702233445 |
| +460702233445 | 46702233445 |
| +458022334455 | 458022334455 |
| 45802233445 | Neamhbhailí toisc go bhfuil an comhartha '+' in easnamh |
Tabhair faoi deara go mbainfidh LINK Mobility úsáid as an MSISDN ceartaithe agus go dtabharfar ar ais é sna tuarascálacha seachadta.
Déan teagmháil le Tacaíocht Soghluaisteachta LINK le haghaidh tuilleadh eolais.
8.2 Athsholáthar Carachtair
Is gné roghnach é athsholáthar carachtar ar féidir é a chumasú le tacaíocht Soghluaisteachta LINK má iarrtar é.
Aistreoidh an ghné seo carachtair aibítre neamh-GSM sna sonraí úsáideora (téacs SMS) go carachtair aibítre GSM coibhéiseacha nuair a shocraítear an DCS go “GSM” (17). Le haghaidh example “Seqüência de teste em Português” aistreofar go “Seqüencia de teste em Portugues”.
9. Tuarascálacha seachadta
Is féidir leis an Soláthraí Seirbhíse, má chuirtear ar fáil é, tuairiscí seachadta teachtaireachtaí SMS nó fógraí seachadta a iarraidh maidir leis na teachtaireachtaí MT a sheoltar. Spreagtar na tuarascálacha seo i SMSC an Oibreora nuair a sheachadtar an teachtaireacht MT chuig an Tomhaltóir ar a bhfuil sé dírithe nó nuair a scriostar í, m.sh., imithe in éag nó, ar chúis éigin, nach bhfuil sí in-rothraithe.
Ní thuairiscítear ach stádas deiridh na teachtaireachta SMS don Soláthraí Seirbhíse, ie seachadtar nó scriostar é. Ní ghintear ach tuairisc amháin in aghaidh gach teachtaireacht MT. Leis an stádas scriosta, féadfaidh cód cúise a bheith i bhfeidhm. Sonraíonn an cód cúise seo an chúis nár seachadadh an teachtaireacht SMS.
Seoltar na tuarascálacha trí LINK Mobility agus seoltar chuig an Soláthraí Seirbhíse iad ag baint úsáide as an bprótacal HTTP.
Chun tuarascálacha a fháil, ní mór don Soláthraí Seirbhíse cur i bhfeidhm maidir le example Java Servlet nó leathanach ASP.NET. Faigheann an bheirt acu iarratais HTTP GET nó POST.
Paraiméadair
Áirítear leis an iarratas na paraiméadair seo a leanas:
| Paraiméadar | Cineál | M/O/I* | Luach Réamhshocraithe | Fad uasta | Cur síos |
| TeachtaireachtId | teaghrán | M | – | 22 | Aitheantas na teachtaireachta MT lena mbaineann an tuairisc seo. |
| Seoladh Ceann Scríbe | teaghrán | M | – | 40 | MSISDN an Tomhaltóra, ie seoladh ceann scríbe na bunteachtaireachta MT. |
| Cód Stádais | slánuimhir | M | 1 | Léiríonn an cód stádais stádas na teachtaireachta MT. Is iad na cóid stádais is infheidhme: 0 – Seachadta 2 – Scriosta (tá feidhm ag an gcód cúise) |
|
| AmStamp | teaghrán | M | – | 20 | Am á chur in iúl cathain a fuair LINK Mobility an tuairisc seachadta. Crios ama an ama is faideamp is CET nó CEST (le ham samhraidh mar atá sainmhínithe don AE). Formáid: yyyyMMdd HH:mm:ss. |
| Oibreoir | teaghrán | M | – | 100 | Ainm an Oibreora a úsáideadh agus an teachtaireacht SMS á sheoladh nó ainm an chuntais a úsáideadh agus an teachtaireacht SMS á sheoladh. Tá liosta de na hOibreoirí atá ar fáil curtha ar fáil ag Tacaíocht Soghluaisteachta NASC. |
| Cóid Chúis | slánuimhir | O | – | 3 | Léiríonn cód cúiseanna cén fáth ar chríochnaigh an teachtaireacht sa stádas scriosta. Is iad na cóid chúiseanna infheidhme: 100 – In éag 101 - Diúltaithe 102 - Earráid formáide 103 – Earráid eile 110 - Suibscríobhaí anaithnid 111 - Suibscríobhaí faoi urchosc 112 – Gan soláthar don suibscríobhaí 113 – Suibscríobhaí ar fáil 120 - Teip SMSC 121 – plódú SMSC 122 - fánaíocht SMSC 130 - Earráid handset 131 – Sáraíodh cuimhne an ghléas láimhe Féadfaidh iompar a bheith éagsúil le comhtháthú Oibreora. |
| OperatorTimeStamp | teaghrán | O | – | 20 | An t-am a thugann le fios cathain a spreag an tuairisc i SMSC an Oibreora (má sholáthraíonn an tOibreoir é). Crios ama an ama is faideamp is CET nó CEST (le ham samhraidh mar atá sainmhínithe don AE). Formáid: yyyyMMdd HH:mm:ss. |
| StádasText | teaghrán | O | – | 255 | Áitsealbhóir chun faisnéis bhreise a fháil ón Oibreoir, m.sh. cur síos soiléir i dtéacs ar an stádas/cúis. Féadfaidh iompar a bheith éagsúil le comhtháthú Oibreora. |
| Comhghaolú | teaghrán | O | – | 100 | An t-aitheantas comhghaoil a cuireadh ar fáil sa SendRequest nó SendTextRequest. |
| Cód Líonra Oibreora | slánuimhir | O | – | 6 | Cód Líonra Soghluaiste (MCC + MNC) an Oibreora. |
* M = Éigeantach, O = Roghnach, I = Neamhaird.
Caithfidh an Soláthraí Seirbhíse an sprioc a sholáthar do LINK Mobility URL le haghaidh tuarascálacha seachadta (go roghnach lena n-áirítear dintiúir le haghaidh fíordheimhnithe bunúsach HTTP). Is féidir leis an Soláthraí Seirbhíse an modh HTTP is fearr le húsáid a roghnú:
HTTP POST (molta)
HTTP GET.
Example HTTP GET a úsáid (seachadadh go rathúil):
https://user:password@www.serviceprovider.com/receivereport?%20MessageId=122&DestinationAddress=46762050312&Operator=Vodafone&TimeStamp=20100401%2007%3A47%3A44&StatusCode=0
Example HTTP GET a úsáid (gan seachadadh, tá an t-amanna curtha ar fáil ag an Oibreoiramp don ócáid):
Tá na paraiméadair URL ionchódaithe.
Ionchódú carachtair:
Is féidir leis an Soláthraí Seirbhíse an t-ionchódú carachtar is fearr a úsáid a roghnú:
UTF-8 (molta)
ISO-8859-1.
9.1 Admháil Soláthraí Seirbhíse
Ba cheart don Soláthraí Seirbhíse gach tuairisc seachadta a admháil. Is féidir leis an admháil a bheith dearfach, ie tuairisc seachadta faighte go rathúil, nó diúltach, ie teip.
Tabhair faoi deara le do thoil: Tá teorainn ama léite ag LINK Mobility le haghaidh admháil 30 soicind le haghaidh tuarascálacha seachadta. Spreagfaidh teorainn ama athiarracht seachadta (má tá atriail chumasaithe) nó cealú an tseachadta (má tá atriail díchumasaithe). Ciallaíonn sé seo go gcaithfidh an t-iarratas Soláthraí Seirbhíse amanna freagartha tapa a chinntiú, go háirithe le linn ualach ard.
Moltar go mór aitheantas a thabhairt don tuairisc seachadta i dtreo Soghluaisteacht LINK sula bpróiseálfar í.
Déantar cur síos ar an riail maidir le hadmháil dhearfach agus dhiúltach mar seo a leanas:
Admháil dhearfach, ACK, tuarascáil seachadta seachadta:
Cód freagartha raon HTTP 200 in éineacht leis an ábhar formáidithe XML seo a leanas:
Admháil diúltach, NAK, níor seachadadh tuairisc seachadta:
Aon fhreagra seachas admháil dhearfach, le haghaidh example, spreagtar admháil dhiúltach ag aon chód earráide HTTP nó an t-ábhar XML seo a leanas:
Is féidir an t-ábhar XML a úsáid chun meicníocht athiarraidh Soghluaisteachta LINK a rialú. Déanfaidh NAK iarracht atriail, má tá sé cumasaithe. I gcás Soláthraithe Seirbhíse nach bhfuil cumraithe don mheicníocht athiarrachta, tá an t-inneachar XML roghnach.
Anseo thíos tá iarratas HTTP POST agus freagra example tuairisc seachadta arna seachadadh chuig Soláthraí Seirbhíse:
Iarratas HTTP:
POST / comhthéacs / feidhmchlár HTTP / 1.1
Cineál Ábhar: iarratas/x-www-form-urlionchódaithe;charset=utf-8
Óstach: server:port
Ábhar-Fad: xx
MessageId=213123213&DestinationAddress=46762050312&Operator=Telia& OperatorTimeStamp=20130607%2010%3A45%3A00&TimeStamp=20130607%2010%3A 45%3A02&StatusCode=0
Freagra HTTP:
HTTP/1.1 200 OK
Cineál Ábhar: téacs/gnáth
9.2 Bain triail eile as
Is féidir le córas Soghluaisteachta LINK iarrachtaí atriallta a dhéanamh maidir le seachadtaí tuairiscí seachadta ar theip orthu, ie nach n-admhaítear. Is féidir leis an Soláthraí Seirbhíse an rogha iompraíochta athiarrachta a roghnú:
Gan triail eile (réamhshocraithe) – cuirfear deireadh leis an teachtaireacht má theipeann ar an iarracht cheangail, má léitear an t-am istigh nó má theipeann ar aon chód earráide HTTP.
Bain triail eile as – cuirfear doicheall leis an teachtaireacht maidir le gach cineál faidhbe nasctha, am istigh léite, nó admháil dhiúltach.
Nuair atá atriail le haghaidh NAK cumasaithe, tá sé tábhachtach a thuiscint cé na cásanna a chruthóidh iarracht atriail ó LINK Mobility agus conas a oibríonn an atriail. Tá scuaine athiarrachta dá chuid féin ag gach Soláthraí Seirbhíse, áit a n-ordaítear teachtaireachtaí de réir achair ama na teachtaireachtaamp. Déanann Link Mobility iarracht i gcónaí teachtaireachtaí níos sine a sheachadadh ar dtús, cé nach bhfuil ord aonair na dteachtaireachtaí a sheachadtar chuig an Soláthraí Seirbhíse ráthaithe. Is í an phríomhchúis le teachtaireachtaí a bheith caite amach as an scuaine atriail ná ceann amháin de dhá chúis: téann an teachtaireacht TTL in éag nó (go teoiriciúil) éiríonn an scuaine athiarrachta lán. Tá an TTL ag brath ar an Oibritheoir agus ar chuntas, .i. féadann sé athrú ag brath ar an Oibritheoir agus/nó ar an gcineál teachtaireachta, m.sh. SMS préimhe nó teachtaireacht SMS ar ráta caighdeánach.
Ní mór do Sholáthraí Seirbhíse a bhfuil atriail chumasaithe acu aitheantas uathúil na teachtaireachta MT a sheiceáil lena chinntiú nach bhfuil an teachtaireacht faighte cheana féin.
Tá sé tábhachtach go gcloífeadh an Soláthraí Seirbhíse leis na rialacha simplí seo nuair a tharlaíonn earráid le linn próiseáil tuairisce seachadta más é an chúis atá leis an earráid: Sealadach, m.sh. bunachar sonraí nach bhfuil ar fáil, ba cheart NAK a sheoladh ar ais. Seolfaidh LINK Mobility an teachtaireacht arís.
Is dócha go mbeidh fadhb den chineál céanna ag baint le hiarracht bhuan agus le triail eile, ba cheart ACK a chur ar ais. Le haghaidh example, nuair nárbh fhéidir an teachtaireacht a pharsáil i gceart nó nuair a tharla earráid rite gan choinne.
Má ghníomhófar dá réir, cinnteofar nach dtarlóidh aon bhlocáil ná díghrádú tréchur mar gheall ar thuairisc seachadta a bheith drogallach arís agus arís eile.
10. Leideanna cur chun feidhme
1. Is féidir úsáid a bhaint as do web bhrabhsálaí chun iarratais a chur isteach chuig an API. Déanann sé seo an-éasca na seirbhísí a iniúchadh agus a mheas gan aon uirlisí forbartha.
2. Moltar Chrome nó Firefox mar aon le síneadh mar JSONView chun JSON deas-fhormáidithe a thaispeáint.
3. Bhaineamar úsáid as SoapUI chun POST, Fíordheimhniú Bunúsach a thástáil agus chun iniúchadh a dhéanamh ar theachtaireachtaí amhiarratais agus freagartha HTTP.
4. Tá an cURL Tá an uirlis úsáideach chun iarratais POST a chur isteach le Fíordheimhniú Bunúsach. Féach example thíos.
curl POST \
-H “Ábhar-Cineál: iarratas/x-www-form-urlionchódaithe" \
-H “Údarú: Bunúsach am9objpjaGFuZ2VtZSA=” \
https://europe.ipx.com/restapi/v1/sms/send \
–sonraí “destinationAddress=46123456789&messageText=Dia duit+Domhain% 21”
_______________
Cumarsáid Phearsanta a Athrú
Doiciméid / Acmhainní
 |
LINK Treoir Forfheidhmithe Soghluaisteachta REST API SMS [pdfTreoir Úsáideora Treoir Forfheidhmithe Soghluaisteachta REST API SMS, Soghluaisteacht, Treoir Forfheidhmithe REST API SMS, REST API SMS, API SMS, SMS |
