Torolàlana amin'ny fampiharana ny LINK MOBILITY REST API SMS
LINK Mobility dia manome serivisy ho an'ny fandefasana hafatra, fandoavam-bola madinika ary serivisy mifototra amin'ny toerana. Ny sehatra dia miasa amin'ny maha-mpahazo votoaty mangarahara sy misy marika fotsy ary mpitari-draharaha eo amin'ny Mpanome tolotra sy Mpanome tolotra.
Ny LINK Mobility dia manome API RESTful izay azo ampiasaina hidirana amin'ny serivisy LINK Mobility toy ny fandefasana SMS. Ity API ity dia natao ho mora ampiasaina sy mifanaraka amin'ny fiteny sy rafitra maoderina rehetra. Amin'ny fampiasana ny fiteny safidinao, ny fampiharanao dia afaka mampiasa ny Link Mobility REST API mba hampiharana ny fahaiza-manao fandefasana hafatra sy fandoavana.
© LINK Mobility, 10 martsa 2021
Fampahalalana ara-dalàna
Ny fampahalalana omena ato amin'ity antontan-taratasy ity dia fananana sy zon'ny mpamorona tokana an'ny Netsize. Tsiambaratelo izy io ary natao ho an'ny fampitam-baovao hentitra. Tsy mamehy ary mety hiova tsy misy fampandrenesana. Izay fampahafantarana na fampiasana tsy nahazoana alalana dia heverina ho tsy ara-dalàna.
Netsize™ sy linkmobility™ dia arovan'ny lalàna frantsay, EEC ary iraisam-pirenena momba ny fananan-tsaina.
Ny marika hafa rehetra voalaza dia fananan'ny tompony ihany.
Tsy misy na inona na inona voarakitra ato dia azo raisina ho fanomezana fahazoan-dàlana na zo amin'ny patanty Netsize, zon'ny mpamorona, na marika.
NETSIZE
Société anonyme au capital de 5 478 070 euros
Siège social :62, avenue Emile Zola92100 Boulogne – France
418 712 477 RCS Nanterre
http://www.LinkMobility.com
http://www.linkmobility.com
Sahan'ny antontan-taratasy
Ity antontan-taratasy ity dia mamaritra ny fomba ampiasan'ny Mpanome tolotra ny LINK Mobility REST API ho an'ny SMS. Izy io dia natao ho an'ny mpanao mari-trano ara-teknika sy mpamorona izay manatanteraka ny tolotr'ny Mpanome serivisy.
1. Fampiasana fototra
Tena mora ny mandefa SMS. Mandefa fangatahana HTTP amin'ny LINK Mobility ianao izay azo tanterahina amin'ny alàlan'ny a web navigateur.
2. Functional Overview
Ny rafitra LINK Mobility dia manome ireto fiasa fototra manaraka ireto ho an'ny hafatra SMS:
Mandefa hafatra SMS amin'ny finday (MT), toy ny hafatra an-tsoratra na binary (ohatra WAP Push) premium sy hafatra mahazatra.
Mandray tatitra fanaterana ho an'ny hafatra MT nalefa.
Mandray hafatra SMS avy amin'ny finday (MO), premium sy ny tahan'ny mahazatra.
Ny SMS REST API dia natokana handefasana hafatra MT SMS amin'ny sarany mahazatra.
Ny API dia mandefa hafatra SMS rehetra amin'ny fomba tsy mifanandrify, mamela ireo endri-javatra toy ny:
"Afo sy adino" - ny Mpanome tolotra dia maniry ny hanana fotoana famaliana azo antoka kokoa ary tsy te hiandry ny vokatra avy amin'ny Operator.
Andramo indray ny fiasa - LINK Mobility dia handefa ny hafatra raha manana olana vonjimaika ny Operator.
2.1 Mandefa hafatra SMS
Mpanome serivisy Netsize Consumer
- Alefaso ny hafatra MT
- Avereno ID hafatra
- Alefaso SMS
- Manao tatitra fanaterana
- Alefaso ny tatitra fanaterana
Ny dingana fototra amin'ny fandefasana hafatra SMS dia voafaritra toy izao manaraka izao:
Ny Mpanome tolotra dia manao fangatahana handefa hafatra SMS amin'ny mpandray amin'ny alàlan'ny rafitra LINK Mobility.
Misy ID hafatra averina any amin'ny Mpanome tolotra. Ity ID ity dia azo ampiasaina, ohatra, hampifandray ny hafatra amin'ny tatitra fanaterana marina.
Ny LINK Mobility dia mitantana ny lalana ary mandefa ny hafatra SMS amin'ny mpanjifa voatokana.
Misy tatitra fanaterana, ohatra, rehefa alefa any amin'ny fitaovan'ny mpanjifa ny hafatra SMS.
Ny tatitra fanaterana dia alefa any amin'ny Mpanome tolotra. Ny tatitra dia misy ID hafatra mitovy amin'ny naverina tamin'ny dingana 2.
Fikoriana hafa: fangatahana tsy mety
Raha tsy manan-kery ny mari-pamantarana nomena na ny mombamomba ny mpampiasa ao amin'ny fangatahana dia misy hadisoana averina any amin'ny Mpanome serivisy. Ny hadisoana dia manondro ny anton'ny fandavana sy ny fiafaran'ny fikorianan'ny rivotra. Tsy misy ID hafatra averina.
3. Hevitra farany
Ny loharano SMS dia idirana amin'ny alàlan'ny lalana:
/restapi/v1/sms
Example URL
https://europe.ipx.com/restapi/v1/sms
Ho an'ny fiarovana ny fifandraisana, ny LINK Mobility REST API dia azo idirana amin'ny HTTPS ihany.
Ny taratasy fanamarinana mpizara Link Mobility dia nosoniavin'ny Thawte Server CA.
4. Operations
Ny serivisy SMS dia manome ireto asa manaraka ireto:
| Anarana | LALANA |
| Alefaso | /restapi/v1/sms/send |
4.1 Alefaso
Ny asa fandefasana dia ampiasaina handefasana SMS amin'ny mpandray tokana.
Ity hetsika ity dia natao ho an'ireo mpampiasa fototra sy efa mandroso. Amin'ny tranga tsotra indrindra, ny adiresin'ny toerana haleha, ary ny lahatsoratry ny hafatra dia takiana mba hanaterana SMS. LINK Mobility dia hahita ny Data Coding Scheme ary hanao concatenation mandeha ho azy ny hafatra ho amin'ny ampahany maro hafatra raha ilaina.
Ho an'ny fampiasana mandroso, ny Mpanome tolotra dia afaka mampiasa masontsivana azo atao mba hifehezana tanteraka ny fandrafetana hafatra ao anatin'izany ny lohatenin'ny angona mpampiasa.
Ny Mpanome tolotra dia afaka mandefa hafatra mifamatotra, fa ny fanomanana ny angon-drakitra mpampiasa sy ny lohatenin'ny angona mpampiasa dia tsy maintsy ataon'ny Mpanome serivisy ary ny hafatra dia tsy maintsy alefa amin'ny alàlan'ny fangatahana fandefasana marobe mankany amin'ny LINK Mobility.
5. Authentication
Anarana mpampiasa sy tenimiafina dia alefa isaky ny fangatahana mampiasa HTTP Basic Authentication Scheme.
https://www.w3.org/Protocols/HTTP/1.0/spec.html#BasicAA
Ny fahazoan-dàlana dia alefa amin'ny lohatenin'ny Fanomezan-dàlana amin'ny fangatahana HTTP. Ny mpanjifa dia manamboatra ny sahan-doha araka ny voalaza eto:
https://en.wikipedia.org/wiki/Basic_access_authentication#Client_side
Ho an'ny example, raha ny solon'anarana dia john ary changeme ny tenimiafina dia ny lohatenin'ny Fanomezan-dàlana dia:
Fanomezana alalana: Basic am9objpjaGFuZ2VtZSA=
Amin'ny maha-fihemotra ny solon'anarana sy ny tenimiafina dia azo apetraka ho mari-pamantarana fangatahana. Ity dia soso-kevitra ho an'ny mpanjifa tsy manohana Basic Auth.
6. Mametraka fangatahana
6.1 Tady fanontaniana
Ny mari-pamantarana fangatahana dia atolotra ho toy ny tady fitakiana misy mpivady anarana/soa. Ny tady fangatahana dia voasivana amin'ny alalan'ny Percent Encoding (URL encoding).
http://www.w3schools.com/tags/ref_urlencode.asp
Ho an'ny example, Hello World! dia voasokajy ho Hello+World%21.
6.2 Mandaitra fangatahana tsy maintsy atao
| Anarana | Max halavany | Description |
| destinationAddress | 40 | Ny MSISDN tokony handefasana hafatra SMS, manomboka amin'ny kaody firenena. Ekampny: 46123456789. Ho an'ny tsena sasany (izay tsy maintsy amboarina ny MSISDN Mpanjifa) io sanda io dia mety ho solon'anarana alfanumerika ihany koa, misy tovan'ny “#”. |
| messageText | 1600 | Ny votoatin'ny hafatra SMS. |
6.3 Masontsivana fangatahana azo atao (ho an'ny fampiasana mandroso)
| Anarana | Max halavany | Description |
| originatingAddress | 16 | Adiresy niaingan'ny hafatra SMS mivoaka. Ny karazana adiresy niaviany dia faritana amin'ny parameter originatorTON. Laharana fohy max ny halavany dia 16. Ny mpandefa nomerika alfa dia voafetra amin'ny Alphabet default GSM misy tarehintsoratra 11 ny halavany. Ny halavan'ny mpandefa MSISDN dia 15 (mampiasa endrika mitovy amin'ny singa destinationAddress). Azo esorina rehefa voafantina ny adiresy originatingAddress sy originatingTON. Ity fiasa ity dia miankina amin'ny tsena sy ny fanamafisana. Mety miovaova ny fitondran-tena miaraka amin'ny fampidirana Operator. |
| originatorTON | 1 | Ny karazana nomeraon'ny adiresy niaviany (TON): 0 - laharana fohy 1 – Alfa isa (halava ambony indrindra 11) 2 – MSISDN Azo esorina rehefa hofantenan'ny rafitra ny adiresy originatingAddress sy originatingTON. Ity fiasa ity dia miankina amin'ny tsena sy ny fanamafisana. Mety miovaova ny fitondran-tena miaraka amin'ny fampidirana Operator. |
| userDataHeader | 280 | Ny lohatenin'ny angona mpampiasa miaraka amin'ny angon'ny mpampiasa dia mety ahitana hatramin'ny 140, izany hoe 280 rehefa voakodia hex, octets. Ity paramètre ity dia voakodia hex foana. |
| DCS | 3 | Rafitra fanodinana data. Mety miovaova ny fitondran-tena miaraka amin'ny fampidirana Operator. |
| PID | 3 | Protocol ID. Mety miovaova ny fitondran-tena miaraka amin'ny fampidirana Operator. |
| relativeValidityTime | 6 | Fotoana manan-kery mifandraika amin'ny segondra (mifanaraka amin'ny fotoana handefasana ny LINK Mobility). Ny lanjany ambony indrindra an'ny 604800 (7 andro) dia 48 ora. Mety miovaova ny fitondran-tena miaraka amin'ny fampidirana Operator. |
| ora nanomezana | 20 | Fotoana metyamp rehefa tokony halefa ny hafatra SMS (fotoana fahatarana). Jereo ny fizarana amin'ny endrika ora daty. |
| statusReportFlags | 1 | Alefaso ny fangatahana tatitra: 0 - Tsy misy tatitra momba ny fandefasana (default) 1- Tatitra fanaterana no angatahina 9 – Nangatahana ny tatitra momba ny fanaterana mpizara (LINK Mobility dia tsy mandefa ny tatitra any amin'ny Mpanome serivisy fa manome azy io amin'ny tatitra sns.) |
| campaignName | 50 | Ny fifanakalozana LINK Mobility dia tagged amin'io anarana io. Izy io dia ampiasaina amin'ny fanakambanana ny fifanakalozana amin'ny tatitra Link Mobility. |
| maxConcatenatedMessages | 1 | Sanda eo anelanelan'ny 1 ka hatramin'ny 10 izay mamaritra ny isan'ny hafatra mitambatra azo atao. Default dia 3. |
| correlationId | 100 | ID nomen'ny Mpanome tolotra izay hantsoina ao amin'ny Tatitry ny fandefasana. |
| Anaran'ny mpampiasa | 100 | Nomena ho solon'ny HTTP Basic Authentication. |
| Password | 100 | Nomena ho solon'ny HTTP Basic Authentication. |
6.4 Fomba fangatahana HTTP
Ho an'ny fifandraisana ambony indrindra, ny API dia manohana ny fomba fangatahana HTTP GET sy POST. Tsy azo atao ny fomba HTTP hafa.
6.4.1 GET
Ampidirina amin'ny URL.
GET
https://europe.ipx.com/restapi/v1/sms/send?destinationAddress=461234
56789&messageText=Manahoana+World%21
Fanomezana alalana: Basic am9objpjaGFuZ2VtZSA=
6.4.2 POST
Ny tady fangatahana voakodia dia apetraka ao amin'ny vatan'ny hafatra fangatahana HTTP. Content-Type dia fampiharana/x-www-form-urlvoakodia.
POST https://europe.ipx.com/restapi/v1/sms/send
Host: europe.ipx.com
Karazana atiny: application / x-www-form-urlvoafango
Fanomezana alalana: Basic am9objpjaGFuZ2VtZSA=
Halavan'ny atiny: 57
destinationAddress=46123456789&messageText=Manahoana+World%21
6.5 Daty sy ora
Ny parametres ao amin'ny REST API maneho ny daty sy ny ora dia ao amin'ny faritry ny ora UTC foana (Ora iraisan'ny rehetra). Oraamps dia aseho ho tady miaraka amin'ity endrika marina ity:
2017-04-25T23:20:50Z
Izany dia maneho 20 minitra sy 50 segondra aorian'ny ora faha-23 amin'ny 25 aprily 2017 ao amin'ny UTC.
7. Hafatra valiny
Rehefa avy nandray sy nandika hafatra fangatahana ny API dia mamaly amin'ny hafatra valin'ny HTTP.
7.1 HTTP fehezan-dalàna
Ny REST API dia mamerina hatrany ny code status HTTP 200 OK ho an'ny fangatahana voarindra. Ny vatan'ny hafatra dia misy kaody valin-kafatra izay ampiasaina hamaritana ny vokatra marina.
7.2 Vatana hafatra
Ny vatan'ny hafatra dia ahitana JSON mamaritra ny vokatry ny fangatahana.
http://json.org/
Link Mobility JSON dia manaraka ny Google JSON Style Guide.
https://google.github.io/styleguide/jsoncstyleguide.xml
7.3 Masontsivana valiny
| Anarana | Max halavany | Description |
| responseCode | 3 | 0 dia manondro fifampiraharahana mahomby. |
| responseMessage | 255 | Famaritana lahatsoratra valiny, ohatra, lahatsoratra diso. |
| fotoanaamp | 20 | Daty sy ora nanodinan'ny LINK Mobility ny fangatahana. (Jereo ny fizarana endrika daty/ora). |
| traceId | 36 | Rohy Mobility famantarana anatiny. Ampiasaina ho fanohanana sy famahana olana. |
| messageIds | 10x36 | Array an'ny LINK Mobility hafatra tokana ho an'ny hafatra mahomby tsirairay (maro ny hafatra ID averina raha ampifandraisina ny hafatra). Esorina raha sendra tsy fahombiazana. |
7.4 Eksample valinteny
FETY
HTTP/1.1 200 OK
Content-Type: application/json
Halavan'ny atiny: 144
Daty: Alakamisy 15 Septambra 2016 13:20:31 GMT
{“ResponseCode”:0,”responseMessage”:”Fahombiazana”,”timestamp”:”2016-09-15T13:20:31Z”, “traceId”:”f678d30879fd4adc25f2″,”messageIds”:[“1-4850879008”]}
Ity ny JSON mitovy amin'ny formata ho mora vakina:
{
“responseCode“:0,
“responseMessage“:”Fahombiazana”,
“fotoanaamp“:”2016-0915T13:20:31Z”,
“traceId“:”f678d30879fd4adc25f2”,
“messageIds“:[“1-4850879008”] }
tsy fahombiazana
HTTP/1.1 200 OK
Content-Type: application/json
Halavan'ny atiny: 148
Daty: Alakamisy 15 Septambra 2016 13:20:31 GMT
{“ResponseCode”:1,”responseMessage”:” Fidirana tsy mety na fampiasana API tsy nahazoana alalana”,”timestamp”:”2016-09-15T13:20:31Z”,”traceId”:”f678d30879fd4adc25f2″}
FETY
HTTP/1.1 200 OK
Content-Type: application/json
Halavan'ny atiny: 144
Daty: Alakamisy 15 Septambra 2016 13:20:31 GMT
{“ResponseCode”:0,”responseMessage”:”Fahombiazana”,”timestamp”:”2016-09-15T13:20:31Z”, “traceId”:”f678d30879fd4adc25f2″,”messageIds”:[“1-4850879008”]}
Ity ny JSON mitovy amin'ny formata ho mora vakina:
{
“responseCode“:0,
“responseMessage“:”Fahombiazana”,
“fotoanaamp“:”2016-0915T13:20:31Z”,
“traceId“:”f678d30879fd4adc25f2”,
“messageIds“:[“1-4850879008”] }
tsy fahombiazana
HTTP/1.1 200 OK
Content-Type: application/json
Halavan'ny atiny: 148
Daty: Alakamisy 15 Septambra 2016 13:20:31 GMT
{“ResponseCode”:1,”responseMessage”:” Fidirana tsy mety na fampiasana API tsy nahazoana alalana”,”timestamp”:”2016-09-15T13:20:31Z”,”traceId”:”f678d30879fd4adc25f2″}
7.5 Kaody valiny
Ireto kaody valin-kafatra manaraka ireto dia azo averina amin'ny valin'ny fandefasana:
| fehezan-dalàna | Text | Description |
| 0 | FETY | Vita soa aman-tsara. |
| 1 | Fidirana tsy mety na fampiasana API tsy nahazoana alalana | Ny solonanarana na tenimiafina diso na Mpanome tolotra dia voasakana avy amin'ny LINK Mobility. |
| 2 | Nosakanan'ny Link Mobility ny mpanjifa | Nosakanan'ny LINK Mobility ny mpanjifa. |
| 3 | Tsy omen'ny LINK Mobility ny fampandehanana | Voasakana ny fandidiana ho an'ny Mpanome tolotra. |
| 4 | Ny mpanjifa dia tsy fantatry ny LINK Mobility | Ny Consumer dia tsy fantatry ny LINK Mobility. Na raha ampiasaina amin'ny fangatahana ny alias; alias tsy hita. |
| 5 | Nosakanan'ny mpanjifa ity serivisy ity tao amin'ny LINK Mobility | Nosakanan'ny Consumer ity serivisy ity tao amin'ny LINK Mobility. |
| 6 | Tsy tohana ny adiresy niaingana | Tsy tohana ny adiresy niaingana. |
| 7 | Adiresy niavian'ny alfa tsy tohanan'ny kaonty | Ny adiresy niavian'ny alpha dia tsy tohanan'ny kaonty. |
| 8 | Adiresy niavian'ny MSISDN tsy tohana | Ny adiresy niavian'ny MSISDN dia tsy tohana. |
| 9 | GSM nitarina tsy tohana | GSM nitarina tsy tohana. |
| 10 | Unicode tsy tohana | Unicode tsy tohana. |
| 11 | Tsy tohana ny tatitra momba ny sata | Tsy tohana ny tatitra momba ny sata. |
| 12 | Tsy tohana ny fahaiza-manao ilaina | Ny fahaiza-manao ilaina (ankoatra ny voalaza etsy ambony) amin'ny fandefasana ny hafatra dia tsy tohanana. |
| 13 | Nihoatra ny tahan'ny throttling ambony indrindra amin'ny mpamatsy votoaty | Mandefa hafatra SMS amin'ny LINK Mobility haingana loatra ny Mpanome tolotra. |
| 14 | Protocol ID tsy tohanan'ny kaonty | Protocol ID tsy tohana. |
| 15 | Nihoatra ny fetran'ny fampifangaroana hafatra | Ny isan'ny hafatra mitambatra dia mihoatra ny isa ambony indrindra nangatahana. |
| 16 | Tsy afaka mitondra hafatra. | LINK Mobility dia tsy afaka nitondra ny hafatra. |
| 17 | Fe-potoana voarara | Tsy mahazo mandefa hafatra mandritra ny fe-potoana |
| 18 | Mifandanja loatra amin'ny kaontin'ny mpanome tolotra | Voasakana ny mpamatsy serivisy noho ny fifandanjana ambany loatra |
| 50 | Fahombiazana ampahany | Fahombiazana ampahany rehefa mandefa hafatra SMS amin'ny mpandray maro. |
| 99 | Olana amin'ny servera anatiny | Error Link Mobility hafa, mifandraisa amin'ny fanohanana LINK Mobility raha mila fanazavana fanampiny. |
| 100 | Adiresy toerana tsy mety | Ny adiresin'ny toerana haleha (MSISDN, na alias) dia tsy mety. |
| 102 | ID voatondro (mifamatotra) tsy mety | Tsy mety ny ID reference, angamba efa nampiasaina ny ID reference, efa antitra loatra na tsy fantatra. |
| 103 | Anarana kaonty tsy mety | Tsy mety ny anaran'ny kaonty. |
| 105 | Data meta serivisy tsy mety | Tsy mety ny angona meta serivisy. |
| 106 | Adiresy niaingana tsy mety | Tsy mety ny adiresy niaingana. |
| 107 | Adiresy niaviany alfanumerie tsy mety | Tsy mety ny adiresy niavian'ny alfanumerika. |
| 108 | Fotoana tsy manankery | Tsy mety ny fotoana manankery. |
| 109 | Fotoana fanaterana tsy mety | Tsy mety ny fotoana fanaterana. |
| 110 | Ny votoatin'ny hafatra/angona mpampiasa tsy mety | Ny angon-drakitra mpampiasa, izany hoe ny hafatra SMS, dia tsy mety. |
| 111 | Tsy mety ny halavan'ny hafatra | Tsy mety ny halavan'ny hafatra SMS. |
| 112 | Lohatenin'ny angona mpampiasa tsy mety | Tsy mety ny lohatenin'ny angona mpampiasa. |
| 113 | Rafitra fanodinana data tsy mety | Ny DCS dia tsy manan-kery. |
| 114 | ID protocole tsy mety | Tsy mety ny PID. |
| 115 | Saina tatitra momba ny sata tsy mety | Tsy mety ny saina momba ny tatitra momba ny sata. |
| 116 | TON tsy mety | Tsy mety ny TON mpamorona. |
| 117 | Tsy mety campanarana aign | Ny camptsy mety ny anarana aign. |
| 120 | Famerana tsy mety ho an'ny isa ambony indrindra amin'ny hafatra mifamatotra | Ny isan'ny hafatra mifamatotra dia tsy mety. |
| 121 | Adiresy niaingana msisdn tsy mety | Ny adiresy niavian'ny MSISDN dia tsy mety. |
| 122 | ID fifandraisana tsy mety | Tsy mety ny ID mifandraika. |
8. endri-javatra azo atao
8.1 Fanitsiana MSISDN
Ny fanitsiana MSISDN dia endri-javatra tsy azo atao izay azo alefa amin'ny fanohanan'ny LINK Mobility raha angatahana.
Ity endri-javatra ity dia hanitsy ny adiresin'ny toerana haleha ary hampifanaraka azy ireo amin'ny endrika E.164 ilaina. Ho fanampin'ny fanitsiana endrika, ny rafitra dia mety hanao asa manokana momba ny tsena toy ny fandikana isa iraisam-pirenena frantsay hanitsiana ny laharan'ny DOM-TOM (départements et territoires d'outre-mer) raha azo atao.
Ireto ambany ireto ny isan'ny exampny fanitsiana:
| Adiresy toerana haleha natolotra | Adiresy toerana haleha nahitsy |
| +46(0)702233445 | 46702233445 |
| (0046)72233445 | 46702233445 |
| +460702233445 | 46702233445 |
| 46(0)702233445 | 46702233445 |
| 46070-2233445 | 46702233445 |
| 0046702233445 | 46702233445 |
| +46(0)702233445aaa | 46702233445 |
| 336005199999 | 2626005199999 (Laharana frantsay nadika ho laharana DOM-TOM) |
Fanampin'izany, azo atao ny mamela ny nomeraon-telefaona nasionaly ho an'ny tsena voafantina. Rehefa avela io endri-javatra io, ny isa iraisam-pirenena ho an'ny tsena hafa dia tsy maintsy alefa miaraka amin'ny famantarana `+' voalohany hanavahana azy amin'ny tsena voafantina.
Ireto ambany ireto misy ohatra maromaroampny fanitsiana natao tamin'ny fampiasana an'i Soeda (kaody firenena 46) ho tsena mahazatra ho an'ny laharana nasionaly.
| Adiresy toerana haleha natolotra | Adiresy toerana haleha nahitsy |
| 0702233445 | 46702233445 |
| 070-2233 445 | 46702233445 |
| 070.2233.4455 | 46702233445 |
| 460702233445 | 46702233445 |
| +460702233445 | 46702233445 |
| +458022334455 | 458022334455 |
| 45802233445 | Tsy mety satria tsy hita ny famantarana '+' |
Mariho fa ny MSISDN voahitsy dia hampiasain'ny LINK Mobility ary haverina ao amin'ny tatitra momba ny fandefasana izany.
Mifandraisa amin'ny LINK Mobility fanohanana raha mila fanazavana fanampiny.
8.2 Fanoloana toetra
Ny fanoloana endri-tsoratra dia endri-javatra azo atao izay azo alefa amin'ny fanohanan'ny LINK Mobility raha angatahana.
Ity endri-javatra ity dia handika ireo tarehintsoratra abidia tsy GSM ao amin'ny angon'ny mpampiasa (soratra SMS) ho tarehintsoratra mitovy amin'ny abidia GSM rehefa apetraka amin'ny “GSM” (17) ny DCS. Ho an'ny example “Seqüência de teste em Português” dia hadika ho “Seqüencia de teste em Portugues”.
9. Tatitra fanaterana
Ny Mpanome tolotra dia afaka mangataka tatitry ny fandefasana hafatra SMS na fampandrenesana fanaterana ho an'ny hafatra MT nalefa, raha misy. Ireo tatitra ireo dia mipoitra ao amin'ny Operator SMSC rehefa alefa any amin'ny Consumer lasibatra ny hafatra MT na voafafa, ohatra, lany daty na, noho ny antony, tsy azo alefa.
Ny sata farany amin'ny hafatra SMS ihany no taterina amin'ny Mpanome tolotra, izany hoe alefa na voafafa. Tatitra iray isaky ny hafatra MT no avoaka. Miaraka amin'ny sata voafafa, mety misy fehezan-dalàna momba ny antony. Ity fehezan-dalàna ity dia mamaritra ny antony tsy nandefasana ny hafatra SMS.
Ny tatitra dia alefa amin'ny alàlan'ny LINK Mobility ary alefa any amin'ny Mpanome serivisy amin'ny alàlan'ny protocol HTTP.
Mba hahazoana tatitra, ny Mpanome tolotra dia mila mampihatra ny exampamin'ny Java Servlet na pejy ASP.NET. Samy mahazo HTTP GET na POST fangatahana.
masontsivana
Ny fangatahana dia ahitana ireto parameter manaraka ireto:
| fikirana | Type | M/O/I* | Sanda Default | Max halavany | Description |
| MessageId | tady | M | – | 22 | Ny ID hafatra amin'ny hafatra MT mifandraika amin'ity tatitra ity. |
| DestinationAddress | tady | M | – | 40 | Ny MSISDN an'ny mpanjifa, izany hoe ny adiresin'ny hafatra MT tany am-boalohany. |
| StatusCode | integer | M | 1 | Ny code status dia manondro ny satan'ny hafatra MT. Ny fehezan-dalàna azo ampiharina dia: 0 – Naterina 2 - Voafafa (mihatra ny fehezan-dalàna momba ny antony) |
|
| TimeStamp | tady | M | – | 20 | Fotoana manondro ny fotoana nahazoan'ny LINK Mobility ny tatitra momba ny fandefasana. Ny faritr'ora amin'ny oraamp dia CET na CEST (miaraka amin'ny fotoam-pahavaratra araka ny voafaritra ho an'ny EU). Endrika: yyyyMMdd HH:mm:ss. |
| mpandraharaha | tady | M | – | 100 | Ny anaran'ny Operator ampiasaina amin'ny fandefasana ny hafatra SMS na ny anaran'ny kaonty ampiasaina rehefa mandefa ny hafatra SMS. Ny lisitry ny Opérateurs misy dia omen'ny fanohanana LINK Mobility. |
| ReasonCode | integer | O | – | 3 | Ny kaody antonony dia manondro ny antony nahatonga ny hafatra tamin'ny sata voafafa. Ny kaody antony azo ampiharina dia: 100 – Lany daty 101 – Nolavina 102 - Fahadisoan'ny format 103 – Fahadisoana hafa 110 – Mpanoratra tsy fantatra 111 – Voasakana ny mpanjifa 112 – Tsy nomena ny mpanjifa 113 – Tsy misy ny mpisoratra anarana 120 – tsy fahombiazana SMSC 121 – Fitohanana SMSC 122 – SMSC roaming 130 – Fahadisoan-tanana 131 – Nihoatra ny fitadidiana finday Mety miovaova ny fitondran-tena miaraka amin'ny fampidirana Operator. |
| OperatorTimeStamp | tady | O | – | 20 | Fotoana manondro ny fotoana nipoiran'ny tatitra tao amin'ny SMSC an'ny Operator (raha omen'ny Operator). Ny faritr'ora amin'ny oraamp dia CET na CEST (miaraka amin'ny fotoam-pahavaratra araka ny voafaritra ho an'ny EU). Endrika: yyyyMMdd HH:mm:ss. |
| StatusText | tady | O | – | 255 | Placeholder raha mila fanazavana fanampiny avy amin'ny Mpampiasa, ohatra ny famaritana lahatsoratra mazava momba ny sata/antony. Mety miovaova ny fitondran-tena miaraka amin'ny fampidirana Operator. |
| CorrelationId | tady | O | – | 100 | Ny ID mifandraika omena ao amin'ny SendRequest na SendTextRequest. |
| OperatorNetworkCode | integer | O | – | 6 | Ny Code Network Mobile (MCC + MNC) an'ny Operator. |
* M = Mandatory, O = Optional, I = Tsy raharahaina.
Ny Mpanome tolotra dia tsy maintsy manome LINK Mobility miaraka amin'ny tanjona URL ho an'ny tatitra fanaterana (azo atao ny mampiditra ny fahazoan-dàlana ho an'ny fanamarinana fototra HTTP). Ny Mpanome tolotra dia afaka misafidy izay fomba HTTP tiana hampiasaina:
HTTP POST (recommended)
HTTP GET.
Exampamin'ny fampiasana HTTP GET (navoaka soa aman-tsara):
https://user:password@www.serviceprovider.com/receivereport?%20MessageId=122&DestinationAddress=46762050312&Operator=Vodafone&TimeStamp=20100401%2007%3A47%3A44&StatusCode=0
Example mampiasa HTTP GET (tsy aterina, ny Operator dia nanome fotoanaamp ho an'ny hetsika):
Ny paramètre dia URL encodedi.
Fanodinana endri-tsoratra:
Ny Mpanome Servisy dia afaka misafidy izay fandiovana tarehintsoratra tiana hampiasaina:
UTF-8 (aroso)
ISO-8859-1.
9.1 Fankatoavan'ny Mpanome tolotra
Ny Mpanome tolotra dia tokony hanaiky ny tatitra fanaterana tsirairay. Ny fanekena dia mety ho tsara, izany hoe tatitry ny fandefasana voaray soa aman-tsara, na ratsy, izany hoe tsy fahombiazana.
Azafady, azafady: LINK Mobility dia manana fe-potoana famakiana ho an'ny fanekena 30 segondra ho an'ny tatitra fanaterana. Ny fahataperan'ny fotoana dia hiteraka fanaterana indray (raha averina averina) na fanafoanana ny fanaterana (raha andrana indray no kilemaina). Midika izany fa ny fampiharana Service Provider dia tsy maintsy miantoka ny fotoana famaliana haingana, indrindra mandritra ny enta-mavesatra be.
Tena soso-kevitra ny hanaiky ny tatitra fanaterana mankany amin'ny LINK Mobility alohan'ny hikarakarana azy.
Ny fitsipika momba ny fanekena tsara sy ratsy dia voafaritra toy izao manaraka izao:
Fanekena tsara, ACK, tatitra momba ny fandefasana:
Kaody valin-kafatra HTTP 200 miaraka amin'ireto votoaty misy endrika XML manaraka ireto:
Fanekena ratsy, NAK, tatitra fanaterana tsy voaray:
Izay valiny hafa ankoatra ny fanekena tsara, ohatraampary, ny fanekena ratsy dia ateraky ny kaody diso HTTP na ireto atiny XML manaraka ireto:
Ny atiny XML dia azo ampiasaina amin'ny fanaraha-maso ny mekanika famerenana ny LINK Mobility. Ny NAK dia hiteraka andrana indray, raha azo atao. Ho an'ny mpanome tolotra tsy namboarina ho an'ny mekanika andrana indray dia tsy voatery ny atiny XML.
Ity ambany ity ny fangatahana HTTP POST sy valiny exampny tatitry ny fanaterana naterina tamin'ny Mpanome tolotra:
HTTP fangatahana:
POST /context/app HTTP/1.1
Karazana atiny: application / x-www-form-urlvoakodia;charset=utf-8
mpampiantrano: server:port
Halavany votoaty: xx
MessageId=213123213&Address Destination=46762050312&Operator=Telia& OperatorTimeStamp=20130607%2010%3A45%3A00&TimeStamp=20130607%2010%3A 45%3A02&StatusCode=0
Valiny HTTP:
HTTP/1.1 200 OK
Karazana votoaty: lahatsoratra/tsotra
9.2 Andramo indray
Ny rafitra LINK Mobility dia afaka manao andrana indray raha tsy nahomby, izany hoe tsy ekena, fanaterana tatitra fanaterana. Ny Mpanome tolotra dia afaka misafidy ny fihetsika andrana indray:
Tsy andrana indray (default) - ny hafatra dia hariana raha toa ka tsy nahomby ny andrana fifandraisana, vakio ny fe-potoana na ho an'ny code HTTP diso.
Hanandrana indray – Ny hafatra dia haverina ho an'ny karazana olana rehetra mifandray, famakiana fotoana, na fanekena ratsy.
Rehefa avela ny manandrana indray ny NAK, dia zava-dehibe ny mahatakatra hoe iza amin'ireo toe-javatra mety hiteraka andrana indray avy amin'ny LINK Mobility sy ny fomba fiasan'ny retry. Ny Mpanome tolotra tsirairay dia manana ny filaharana andrana indray, izay misy ny baiko araka ny fe-potoanan'ny hafatraamp. Ny Link Mobility dia miezaka mampita hafatra taloha foana aloha, na dia tsy azo antoka aza ny filaharan'ny hafatra tsirairay alefa any amin'ny Mpanome tolotra. Ny antony lehibe hanesorana ny hafatra avy amin'ny filaharana andrana dia iray amin'ireo antony roa: na ny hafatra TTL lany daty na (ara-teorika) dia feno ny filaharana andrana indray. Ny TTL dia Operator ary miankina amin'ny kaonty, izany hoe, mety miovaova arakaraka ny Mpampiasa sy na karazana hafatra, ohatra, SMS premium na hafatra SMS mahazatra.
Tsy maintsy manamarina ny ID tokana an'ny hafatra MT ny Mpanome tolotra manana andrana indray mba hahazoana antoka fa mbola tsy voaray ilay hafatra.
Zava-dehibe ho an'ny Mpanome tolotra ny manaraka ireto fitsipika tsotra ireto rehefa misy hadisoana mitranga mandritra ny fikarakarana ny tatitra momba ny fanaterana raha toa ka ny anton'ny hadisoana dia: vonjimaika, ohatra tsy misy ny tahiry, tokony haverina ny NAK. LINK Mobility dia handefa ny hafatra.
Ny andrana maharitra sy andrana indray dia mety hiteraka olana mitovy, tokony haverina ny ACK. Ho an'ny example, rehefa tsy azo novakiana tsara ny hafatra na nahatonga fahadisoana tsy nampoizina.
Ny fanaovana zavatra mifanaraka amin'izany dia hiantoka fa tsy misy fanakanana na fahasimbana eo amin'ny fidirana vokatry ny tatitra fanaterana alefa miverimberina.
10. Toro-hevitra fampiharana
1. Azo atao ny mampiasa ny anao web navigateur handefa fangatahana amin'ny API. Izany dia manamora ny fijerena sy fanombanana ny serivisy tsy misy fitaovana fampandrosoana.
2. Chrome na Firefox dia atolotra miaraka amin'ny fanitarana toy ny JSONView mba hampisehoana JSON tsara endrika.
3. Nampiasa SoapUI izahay mba hizaha toetra ny POST, Fanamarinana fototra ary ny fanaraha-maso ny fangatahana HTTP manta sy ny hafatra valiny.
4. Ny cURL Ny fitaovana dia ilaina amin'ny fandefasana fangatahana POST miaraka amin'ny Fanamarinana fototra. Jereo ny example ambany.
curl POST \
-H “karazana votoaty: application/x-www-form-urlvoakodia” \
-H “Autorisation: Basic am9objpjaGFuZ2VtZSA=” \
https://europe.ipx.com/restapi/v1/sms/send \
–data “destinationAddress=46123456789&messageText=Hello+World%21”
_______________
Transforming Personalized Communications
Documents / Loharano
 |
Torolàlana amin'ny fampiharana ny LINK MOBILITY REST API SMS [pdf] Torolàlana ho an'ny mpampiasa Torolàlana amin'ny fampiharana ny hetsika REST API SMS, Fiterahana, Torolàlana fampiharana REST API SMS, REST API SMS, API SMS, SMS |
