LINK Mobility Implementation Guide REST API SMS
LINK Mobility inopa sevhisi yekutumira mameseji, mari shoma, uye masevhisi anoenderana nenzvimbo. Iyi puratifomu inoita seyakajeka, chena-label yemukati anowana uye transaction router pakati peSevhisi Vanopa uye Vashandisi.
LINK Mobility inopa RESTful API inogona kushandiswa kuwana LINK Mobility masevhisi akadai sekutumira SMS. Iyi API yakagadzirwa kuti ive nyore kushandisa uye inoenderana nemitauro yese yechizvino-zvino nemafuremu. Uchishandisa mutauro wesarudzo yako application yako inogona kushandisa iyo Link Mobility REST API kuita mameseji ane simba uye kugona kubhadhara.
© LINK Mobility, Kurume 10, 2021
Mashoko eMutemo
Ruzivo rwunopihwa mugwaro iri ndiyo yega pfuma uye copyright yeNetize. Iyo yakavanzika uye inotarisirwa kuti ishandiswe zvakanyanya ruzivo. Haisungiri uye inogona kuchinjwa pasina chiziviso. Chero kuburitsa kusingatenderwe kana kushandiswa kuchaonekwa sekusiri pamutemo.
Netsize™ uye linkmobility™ inodzivirirwa neFrench, EEC uye yepasirese mitemo yezvivakwa.
Mamwe matrademark ese ataurwa ndiwo ega emidziyo yevaridzi vawo.
Hapana chirimo pano chichatorwa sekupa chero rezinesi kana kodzero pasi peNetsize patent, copyright, kana trademark.
NETSIZE
Société anonyme kana 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
Kuwanda kwegwaro
Gwaro iri rinotsanangura kuti Mupi Webasa anoshandisa sei LINK Mobility REST API yeSMS. Yakagadzirirwa vagadziri vehunyanzvi uye vagadziri vanoita masevhisi eMupi weSevhisi.
1. Basic Kushandisa
Zviri nyore kutumira SMS. Unotumira chikumbiro cheHTTP kuLINK Mobility iyo inogona kuitwa uchishandisa a web browser.
2. Functional Overview
Iyo LINK Mobility system inopa zvinotevera mashandiro eSMS mameseji:
Kutumira Mobile Terminated (MT) mameseji eSMS, akadai semavara kana mabhinari (eg WAP Push) premium uye mwero meseji meseji.
Kugamuchira mishumo yekutumira yakatumirwa mameseji eMT.
Kugamuchira Mobile Originated (MO) SMS mameseji, premium uye mwero mwero.
Iyo SMS REST API yakatsaurirwa kutumira yakajairwa chiyero cheMT SMS mameseji.
Iyo API inotumira ese mameseji eSMS asynchronously, ichigonesa maficha akadai se:
"Moto-uye-kukanganwa" - Mupi weSevhisi anoda kuve neakawanda fungidziro yekupindura nguva uye haadi kumirira mhedzisiro kubva kuOperator.
Edzazve kuita - LINK Kufamba kunotumira meseji kana Operator aine matambudziko enguva pfupi.
2.1 Kutumira meseji yeSMS
Service Provider Netsize Consumer
- Tumira MT meseji
- Dzorera meseji ID
- Tumira meseji yeSMS
- Delivery report
- Tumira mushumo wekutumira
Kuyerera kwekutanga kwekutumira mameseji eSMS kunotsanangurwa seizvi:
Mushandi weSevhisi anoita chikumbiro chekutumira meseji yeSMS kune anogamuchira kuburikidza neLINK Mobility system.
Imeseji ID inodzoserwa kune Service Provider. ID iyi inogona kushandiswa semuenzaniso kuwiriranisa meseji nerepoti chaiyo yekutumira.
LINK Mobility inobata nzira uye inoendesa meseji yeSMS kune yakanyorwa Mutengi.
Chirevo chekutumira chinotangwa, semuenzaniso kana meseji yeSMS yaunzwa kumudziyo weMutengi.
Chirevo chekutumira chinotumirwa kuMupi Webasa. Chirevo chine iwo meseji ID yakadzoserwa munhanho 2.
Kumwe kuyerera: Chikumbiro chisiricho
Kana maparameter akapihwa kana zvitupa zvemushandisi muchikumbiro zvisiri izvo kukanganisa kunodzoserwa kune Service Provider. Iko kukanganisa kunoratidza chikonzero chekurambwa uye kuyerera kunopera. Hapana ma ID mameseji anodzoserwa.
3. Mhedziso
Iyo SMS sosi inowanikwa uchishandisa nzira:
/restapi/v1/sms
Example URL
https://europe.ipx.com/restapi/v1/sms
Nekuchengetedzwa kwekubatanidza LINK Mobility REST API inosvikika paHTTPS chete.
Iyo Link Mobility server seti yakasainwa neThawte Server CA.
4. Mashandiro
Basa reSMS rinopa zvinotevera mabasa:
| Zita | Path |
| Send | /restapi/v1/sms/send |
4.1 Send
Basa rekutumira rinoshandiswa kutumira SMS kune mumwe chete anogamuchira.
Kushanda uku kwakagadzirirwa vese vashandisi vekutanga uye vepamberi. Muchiitiko chakareruka, kero yekuenda chete, uye meseji meseji inodiwa kuendesa SMS. LINK Mobility inoona iyo Data Coding Scheme uye kuita otomatiki concatenation yemeseji muzvikamu zvakawanda zvemeseji kana zvichidikanwa.
Nekushandisa kwepamberi, Mupi weSevhisi anogona kushandisa sarudzo dzema paramita ekudzora yakazara meseji fomati kusanganisira iyo mushandisi data musoro.
Mushandi weSevhisi anogona kutumira mameseji akabatanidzwa, asi gadziriro yedata remushandisi uye musoro wedata wemushandisi unofanirwa kuitwa neMupi Webasa uye meseji yacho inofanirwa kutumirwa nenzira yekutumira akawanda zvikumbiro kuLINK Mobility.
5. Huchokwadi
Username nepassword zvinotumirwa muchikumbiro chese uchishandisa HTTP Basic Authentication Scheme.
https://www.w3.org/Protocols/HTTP/1.0/spec.html#BasicAA
Zvinyorwa zvinotumirwa mumusoro weMvumo muchikumbiro cheHTTP. Mutengi anovaka iyo musoro ndima sezvakatsanangurwa pano:
https://en.wikipedia.org/wiki/Basic_access_authentication#Client_side
For example, kana zita rekushandisa riri john uye changeme iri password saka mhedzisiro musoro weMvumo ndewekuti:
Mvumo: Basic am9objpjaGFuZ2VtZSA=
Sekudonha-kumashure zita rekushandisa uye pasiwedhi rinogona kuendeswa sekukumbira paramita. Izvi zvinongokurudzirwa kune vatengi vasingatsigire Basic Auth.
6. Kuendesa chikumbiro
6.1 Tambo yekubvunza
Maparamendi ekukumbira anoendeswa seyemubvunzo tambo ine zita/value pairs. Tambo yemubvunzo yakavharwa uchishandisa Percent Encoding (URL encoding).
http://www.w3schools.com/tags/ref_urlencode.asp
For example, Mhoro Nyika! yakavharidzirwa seMhoro+Nyika%21.
6.2 Inosungirwa kukumbira paramita
| Zita | Max urefu | Tsanangudzo |
| destinationAddress | 40 | Iyo MSISDN iyo meseji yeSMS inofanirwa kutumirwa kwairi, kutanga nekodhi yenyika. Exampchikamu: 46123456789. Kune mamwe misika (apo Mutengi MSISDN inofanirwa kuvharika) kukosha uku kunogona zvakare kuve zita realphanumeric, rine prefix na“#”. |
| messageText | 1600 | Izvo zvemeseji yeSMS. |
6.3 Sarudzo yekukumbira paramita (yekushandisa yepamusoro)
| Zita | Max urefu | Tsanangudzo |
| originatingAddress | 16 | Kero yekutanga yemeseji yeSMS inobuda. Rudzi rwekutangira kero inotsanangurwa neiyo originatorTON parameter. Nhamba pfupi hurefu hurefu ndeye 16. Alpha manhamba anotumira anogumira kuGSM default Alphabet ine max kureba mavara gumi nerimwe. MSISDN sender max urefu ndeye gumi neshanu (uchishandisa fomati yakafanana neyenzvimbo yeAddress element). Inogona kusiiwa painotangira Kero uye yakabvaTON inosarudzwa nehurongwa. Iri basa rinoenderana nemusika uye gadziriso. Maitiro anogona kusiyana nekubatanidzwa kweOperator. |
| akatangaTON | 1 | Kero yekutangira' mhando yenhamba (TON): 0 - Nhamba pfupi 1 – Arufa nhamba (max kureba 11) 2 – MSISDN Inogona kusiiwa painotangira Kero uye yakabvaTON ichasarudzwa nehurongwa. Iri basa rinoenderana nemusika uye gadziriso. Maitiro anogona kusiyana nekubatanidzwa kweOperator. |
| userDataHeader | 280 | Musoro weData Yemushandisi pamwe chete neMushandisi Dhata inogona kuve neanosvika zana nemakumi mana, kureva 140 kana hex-encoded, octets. Iyi parameter inogara hex-encoded. |
| DCS | 3 | Data coding scheme. Maitiro anogona kusiyana nekubatanidzwa kweOperator. |
| PID | 3 | Protocol ID. Maitiro anogona kusiyana nekubatanidzwa kweOperator. |
| hamaValidityTime | 6 | Hukama hwechokwadi nguva mumasekonzi (inoenderana nenguva yekutumirwa kuLINK Mobility). Kukosha kweMax 604800 (mazuva manomwe) uye iyo default ndeye 7 maawa. Maitiro anogona kusiyana nekubatanidzwa kweOperator. |
| deliveryTime | 20 | Nguvaamp apo meseji yeSMS inofanirwa kuendeswa (kunonoka kuendesa nguva). Ona chikamu pafomati yemazuva. |
| statusReportFlags | 1 | Tumira chikumbiro chemushumo: 0 - Hapana mushumo wekutumira (default) 1 - Mushumo wekutumira wakumbirwa 9 - Chirevo chekutumira sevha chakumbirwa (LINK Mobility usaendese mushumo kuMupi weSevhisi asi inoita kuti ivepo mumishumo nezvimwe.) |
| campaignName | 50 | Iyo LINK Mobility kutengeserana ndeye tagkubatwa nezita iri. Inoshandiswa kuunganidza kutengeserana muLink Mobility mishumo. |
| maxConcatenatedMessages | 1 | Hukoshi huri pakati pe1 ne10 inotsanangura kuti mameseji mangani anotenderwa. Default ndeye 3. |
| correlationId | 100 | ID yakapihwa neSevhisi Provider iyo inozodzokororwa muDelivery Report. |
| username | 100 | Inopihwa seimwe nzira yeHTTP Basic Authentication. |
| pasiwedhi | 100 | Inopihwa seimwe nzira yeHTTP Basic Authentication. |
6.4 Nzira dzekukumbira HTTP
Kuti kudyidzana kwakanyanya, API inotsigira ese ari maviri HTTP GET uye POST nzira dzekukumbira. Hapana dzimwe nzira dzeHTTP dzinotenderwa.
6.4.1 GET
The encoded yemubvunzo tambo inowedzerwa kune iyo URL.
GET
https://europe.ipx.com/restapi/v1/sms/send?destinationAddress=461234
56789&messageText=Mhoro+Nyika%21
Mvumo: Basic am9objpjaGFuZ2VtZSA=
6.4.2 POST
Iyo encoded yemubvunzo tambo inotumirwa muHTTP yekukumbira meseji meseji. Zvemukati-Type ndeyekushandisa/x-www-fomu-urlencoded.
POST https://europe.ipx.com/restapi/v1/sms/send
Mutungamiriri: europe.ipx.com
Zvemukati-Rudzi: kunyorera / x-www-fomu-urlencoded
Mvumo: Basic am9objpjaGFuZ2VtZSA=
Content-Kureba: 57
destinationAddress=46123456789&messageText=Mhoro+Nyika%21
6.5 Zuva uye nguva
Maparamita ari muREST API anomiririra zuva uye nguva anogara ari muUTC nguva zone (Coordinated Universal Time). Timestamps inomiririrwa setambo ine iyi chaiyo fomati:
2017-04-25T23:20:50Z
Izvi zvinomiririra maminitsi makumi maviri nemasekonzi makumi mashanu mushure meawa yechi20 yaApril 50, 23 muUTC.
7. Mharidzo yekupindura
Mushure mekugamuchira uye kududzira meseji yekukumbira iyo API inopindura neHTTP mhinduro meseji.
7.1 HTTP mamiriro kodhi
Iyo REST API inogara ichidzosa HTTP mamiriro kodhi 200 OK kune zvakagadziriswa zvikumbiro. Meseji yemeseji ine parameter mhinduroCode inoshandiswa kuona mhinduro chaiyo.
7.2 Boka remharidzo
Boka remeseji rine JSON rinotsanangura mhedzisiro yechikumbiro.
http://json.org/
Link Mobility JSON inoenderana neGoogle JSON Style Guide.
https://google.github.io/styleguide/jsoncstyleguide.xml
7.3 Mhinduro paramita
| Zita | Max urefu | Tsanangudzo |
| responseCode | 3 | 0 inoratidza kutengeserana kwakabudirira. |
| responseMessage | 255 | Tsanangudzo yemavara emhinduro, semuenzaniso mavara ezvikanganiso. |
| timestamp | 20 | Zuva uye nguva iyo LINK Mobility yakagadzirisa chikumbiro. (Tarisa kune chikamu chemazuva / nguva yefomati). |
| traceId | 36 | Batanidza Mobility yemukati identifier. Inoshandiswa kutsigira uye kugadzirisa matambudziko. |
| messageIds | 10 x 36 | Mutsara weLINK Mobility meseji maID mameseji ega ega akabudirira meseji (mameseji akawanda ID anodzoserwa kana meseji yabatanidzwa). Kusiiwa kana watadza. |
7.4 Eksample mhinduro
Success
HTTP/1.1 200 OK
Zvemukati-Rudzi: application/json
Content-Kureba: 144
Date: Thu, 15 Sep 2016 13:20:31 GMT
{"responseCode":0,"responseMessage":"Success","nguvaamp”:”2016-09-15T13:20:31Z”, “traceId”:”f678d30879fd4adc25f2″,”messageIds”:[“1-4850879008”]}
Heino yakafanana JSON yakarongwa kuti iverengeke:
{
“responseCode":0,
“responseMessage":"Kubudirira",
“timestamp“:”2016-0915T13:20:31Z”,
“traceId“:”f678d30879fd4adc25f2”,
“messageIds":["1-4850879008"] }
Kukundikana
HTTP/1.1 200 OK
Zvemukati-Rudzi: application/json
Content-Kureba: 148
Date: Thu, 15 Sep 2016 13:20:31 GMT
{“responseCode”:1,”responseMessage”:”Mashandisirwo eAPI asina kutenderwa”,”nguvaamp”:”2016-09-15T13:20:31Z”,”traceId”:”f678d30879fd4adc25f2″}
Success
HTTP/1.1 200 OK
Zvemukati-Rudzi: application/json
Content-Kureba: 144
Date: Thu, 15 Sep 2016 13:20:31 GMT
{"responseCode":0,"responseMessage":"Success","nguvaamp”:”2016-09-15T13:20:31Z”, “traceId”:”f678d30879fd4adc25f2″,”messageIds”:[“1-4850879008”]}
Heino yakafanana JSON yakarongwa kuti iverengeke:
{
“responseCode":0,
“responseMessage":"Kubudirira",
“timestamp“:”2016-0915T13:20:31Z”,
“traceId“:”f678d30879fd4adc25f2”,
“messageIds":["1-4850879008"] }
Kukundikana
HTTP/1.1 200 OK
Zvemukati-Rudzi: application/json
Content-Kureba: 148
Date: Thu, 15 Sep 2016 13:20:31 GMT
{“responseCode”:1,”responseMessage”:”Mashandisirwo eAPI asina kutenderwa”,”nguvaamp”:”2016-09-15T13:20:31Z”,”traceId”:”f678d30879fd4adc25f2″}
7.5 Makodhi emhinduro
Makodhi emhinduro anotevera anogona kudzoserwa mumhinduro yekutumira:
| Code | Text | Tsanangudzo |
| 0 | Success | Kuitwa zvakabudirira. |
| 1 | Kupinda kusina mvumo kana kusatenderwa kushandiswa kweAPI | Zita rekushandisa risiri iro kana password kana Service Provider inorambidzwa neLINK Mobility. |
| 2 | Mutengi akavharwa neLink Mobility | Mutengi akavharwa neLINK Mobility. |
| 3 | Kushanda hakuna kupihwa neLINK Mobility | Kuvhiya kwakavharwa kuMupi Webasa. |
| 4 | Mutengi haazivikanwe kune LINK Mobility | Mutengi haazivikanwe kune LINK Mobility. Kana kuti kana alias yakashandiswa mukukumbira; zita harina kuwanikwa. |
| 5 | Mutengi avhara sevhisi iyi muLINK Mobility | Mutengi avhara sevhisi iyi muLINK Mobility. |
| 6 | Kero yekutangira haitsigirwe | Kero yekutangira haitsigirwe. |
| 7 | Kero inotangira alpha haitsigirwi neakaundi | Kero inotangira alpha haitsigirwe neakaundi. |
| 8 | MSISDN kero yekutangira haina kutsigirwa | Kero yekutanga yeMSISDN haina kutsigirwa. |
| 9 | GSM yakawedzerwa haina kutsigirwa | GSM yakawedzerwa haina kutsigirwa. |
| 10 | Unicode haina kutsigirwa | Unicode haina kutsigirwa. |
| 11 | Chirevo chechimiro hachina kutsigirwa | Chirevo chechimiro hachina kutsigirwa. |
| 12 | Kugona kunodiwa hakuna kutsigirwa | Iyo inodiwa kugona (kunze kweiyo pamusoro) yekutumira meseji haina kutsigirwa. |
| 13 | The content provider max throttling rate inodarika | Mushandi weSevhisi ari kutumira mameseji eSMS kuLINK Mobility nekukasira. |
| 14 | Protocol ID haitsigirwe neakaundi | Protocol ID haina kutsigirwa. |
| 15 | Mharidzo yekubatanidza meseji yadarika | Huwandu hwemeseji dzakasungirirwa inodarika nhamba huru yakumbirwa. |
| 16 | Tatadza kutumira meseji. | LINK Mobility yatadza kufambisa meseji. |
| 17 | Yakarambidzwa nguva nguva | Hazvibvumirwi kutumira meseji panguva yenguva |
| 18 | Yakanyanya kuderera sare paakaundi yevanopa masevhisi | Sevhisi yakavharwa nekuda kwekuderera zvakanyanya |
| 50 | Kubudirira zvishoma | Kubudirira zvishoma pakutumira meseji yeSMS kune vakawanda vanogamuchira. |
| 99 | Internal server error | Kumwe kutadza kwe Link Mobility, bata LINK Mobility support kuti uwane rumwe ruzivo. |
| 100 | Kero yekwakuenda haisiyo | Kero yekwauri kuenda (MSISDN, kana zita rezita) haisiriyo. |
| 102 | ID yakarehwa haisiyo (yakabatana). | Iyo ID yereferenzi haina basa, pamwe iyo referensi ID yatoshandiswa, yasakara kana isingazivikanwe. |
| 103 | Zita reakaundi risiri iro | Zita reakaundi harisi kushanda. |
| 105 | Meta data haisiriyo | Masevhisi meta data haashandi. |
| 106 | Kero yekwakabva haisiriyo | Kero yekwavanobva haisi iyo. |
| 107 | Kero yekutanga yealphanumeric haisiyo | Kero yekutanga nenhamba haishande. |
| 108 | Nguva yechokwadi haisiriyo | Nguva yekugonesa haishande. |
| 109 | Nguva yekutumira isiriyo | Nguva yekutumira haishande. |
| 110 | Meseji yemeseji isiriyo/ data yemushandisi | Data yemushandisi, kureva meseji yeSMS, haisiriyo. |
| 111 | Hurefu hwemeseji handihwo | Hurefu hwemeseji yeSMS hahushandi. |
| 112 | Musoro wedata haushandi | Musoro wedata remushandisi haushandi. |
| 113 | Chirongwa chekukodha data chisiricho | Iyo DCS haisi iyo. |
| 114 | ID yeprotocol haisiyo | PID haisiriyo. |
| 115 | Mireza yezvimiro zvisirizvo | Mireza yerepoti haina basa. |
| 116 | TON haisiriyo | Muvambi TON haashande. |
| 117 | Haikodzeri campzita rekuti | The campzita rechiratidzo harishandi. |
| 120 | Muganho haugone pahuwandu hwehuwandu hwemashoko akabatanidzwa | Huwandu hwemashoko akasungirirwa haugoneki. |
| 121 | Kero yekwakabva msisdn haisiriyo | Kero yekutanga yeMSISDN haishande. |
| 122 | ID yekubatanidza haisiyo | ID yekubatanidza haishande. |
8. Optional features
8.1 MSISDN Kururamisa
MSISDN kururamisa chinhu chaungasarudze chinogona kuitwa neLINK Mobility support kana chakumbirwa.
Izvi zvichagadzirisa kero dzekwaunoenda uye kuendesa kune inodiwa E.164 fomati. Pamusoro pekugadzirisa fomati, sisitimu iyi inogona kuitawo mashandiro emusika sekushandura manhamba echiFrench epasi rese kugadzirisa nhamba dzeDOM-TOM (départements et territoires d'outre-mer) kana zvichiita.
Pazasi pane akati wandei ekareampzvishoma zvekugadzirisa:
| Yakatumirwa Kero Yekwaunoenda | Yakagadziriswa Kero Yekwainoenda |
| +46(0)702233445 | 46702233445 |
| (0046)72233445 | 46702233445 |
| +460702233445 | 46702233445 |
| 46(0)702233445 | 46702233445 |
| 46070-2233445 | 46702233445 |
| 0046702233445 | 46702233445 |
| +46(0)702233445aaa | 46702233445 |
| 336005199999 | 2626005199999 (Nhamba yechiFrench yakashandurirwa kunhamba yeDOM-TOM) |
Pamusoro pezvo, zvinokwanisika kubvumidza nhamba dzenhare dzenyika kumusika wakasarudzwa. Kana chimiro ichi chagoneswa chero nhamba dzepasi rose dzemamwe misika dzinofanira kutumirwa nechiratidzo chekutanga `+' kuvasiyanisa kubva kumusika wakasarudzwa.
Pazasi pane akati wandei exampzvishoma zvekugadzirisa kunoitwa kana uchishandisa Sweden (kodhi yenyika 46) semusika wakasarudzika wenhamba dzenyika.
| Yakatumirwa Kero Yekwaunoenda | Yakagadziriswa Kero Yekwainoenda |
| 0702233445 | 46702233445 |
| 070-2233 445 | 46702233445 |
| 070.2233.4455 | 46702233445 |
| 460702233445 | 46702233445 |
| +460702233445 | 46702233445 |
| +458022334455 | 458022334455 |
| 45802233445 | Haisi kushanda sezvo chiratidzo '+' chisipo |
Ziva kuti iyo MSISDN yakagadziriswa ichashandiswa ne LINK Mobility uye ichadzoserwa mumishumo yekutumira.
Ndokumbira ubate LINK Rutsigiro rweMobility kuti uwane rumwe ruzivo.
8.2 Kutsiva Hunhu
Kutsiviwa kwehunhu chinhu chaunosarudza chinogona kuitwa neLINK Mobility rutsigiro kana chakumbirwa.
Ichi chinozoshandura mavara asiri eGSM alphabet mudata remushandisi (SMS text) kuenda kumavara akaenzana eGSM alphabet kana DCS yaiswa ku“GSM” (17). For example "Seqüência de teste em Português" ichashandurwa kuita "Seqüencia de teste em Portugues".
9. Mishumo yekutumira
Mupi weSevhisi anogona, kana akapihwa, kukumbira mameseji ekutumira meseji kana zviziviso zvekutumira mameseji eMT anotumirwa. Mishumo iyi inokonzereswa muOperator SMSC kana meseji yeMT ichiendeswa kune yakanangwa Mutengi kana kubviswa, semuenzaniso, yapera kana, nekuda kwechimwe chikonzero, isingachinjike.
Chekupedzisira chimiro cheSMS meseji chinoshumwa kune Mupi weSevhisi, kureva, kuendeswa kana kudzimwa. Chirevo chimwe chete paMT meseji inogadzirwa. Nechimiro chakadzimwa, kodhi yechikonzero inogona kushanda. Ichi chikonzero kodhi inotsanangura chikonzero chekuti meseji yeSMS isaunzwe.
Mishumo inofambiswa kuburikidza neLINK Mobility uye inotumirwa kune Service Provider vachishandisa HTTP protocol.
Kuti ugamuchire marepoti, Mupi weSevhisi anofanirwa kuita zveexampkune Java Servlet kana ASP.NET peji. Ose ari maviri anogashira HTTP GET kana POST zvikumbiro.
Parameters
Chikumbiro chinosanganisira zvinotevera parameters:
| Parameter | Type | M/O/I* | Default Value | Max urefu | Tsanangudzo |
| MessageId | tambo | M | - | 22 | Iyo meseji ID yeMT meseji inoenderana nerepoti iyi. |
| DestinationAddress | tambo | M | - | 40 | Mutengi MSISDN, kureva kero yekwainoenda meseji yeMT yepakutanga. |
| StatusCode | integer | M | 1 | Status kodhi inoratidza chimiro cheMT meseji. Mamiriro emamiriro ezvinhu anoshanda ndeaya: 0 - Yakatumirwa 2 - Yakabviswa (chikonzero kodhi inoshanda) |
|
| TimeStamp | tambo | M | - | 20 | Nguva inoratidza kuti rinhi rekutumira rakatambirwa neLINK Mobility. Nzvimbo yenguva yenguvaamp is CET kana CEST (nenguva yezhizha sekutsanangurwa kweEU). Maumbirwo: yyyyMMdd HH:mm:ss. |
| Operator | tambo | M | - | 100 | Iro zita reOperator rinoshandiswa pakutumira meseji yeSMS kana zita reakaundi rinoshandiswa pakutumira meseji yeSMS. Rondedzero yeVashandi varipo inopihwa neLINK Mobility rutsigiro. |
| ReasonCode | integer | O | - | 3 | Chikonzero kodhi inoratidza kuti sei meseji yakaguma mune chimiro chakadzimwa. Makodhi ezvikonzero anoshanda ndeaya: 100 - Yapera 101 – Kurambwa 102 - Fomati kukanganisa 103 - kumwe kukanganisa 110 - Munyoreri asingazivikanwe 111 - Munyoreri akarambidzwa 112 - Munyoreri haana kupihwa 113 - Munyoreri haapo 120 - SMSC kukundikana 121 - SMSC kusangana 122 - SMSC inotenderera 130 - Handset kukanganisa 131 - Handset memory yakapfuura Maitiro anogona kusiyana nekubatanidzwa kweOperator. |
| OperatorTimeStamp | tambo | O | - | 20 | Nguva inoratidza kuti rinhi rakatangwa muSMSC yeOperator (kana yakapihwa neOperator). Nzvimbo yenguva yenguvaamp is CET kana CEST (nenguva yezhizha sekutsanangurwa kweEU). Maumbirwo: yyyyMMdd HH:mm:ss. |
| StatusText | tambo | O | - | 255 | Chibatiso cherumwe ruzivo kubva kuMushandi, semuenzaniso tsananguro yemavara yakajeka yechimiro/chikonzero. Maitiro anogona kusiyana nekubatanidzwa kweOperator. |
| CorrelationId | tambo | O | - | 100 | Iyo ID yekubatanidza yakapihwa muSendRequest kana SendTextRequest. |
| OperatorNetworkCode | integer | O | - | 6 | Iyo Mobile Network Code (MCC + MNC) yeMushandi. |
* M = Zvinosungirwa, O = Optional, I = Kuregeredzwa.
Mupi weSevhisi anofanirwa kupa LINK Mobility ine chinangwa URL yekutumira mishumo (kusarudza kusanganisira zvitupa zveHTTP basic authentication). Mupi weSevhisi anogona kusarudza kuti ndeipi nzira yeHTTP yekushandisa:
HTTP POST (inokurudzirwa)
HTTP GET.
Exampuchishandisa HTTP GET (yakaunzwa zvinobudirira):
https://user:password@www.serviceprovider.com/receivereport?%20MessageId=122&DestinationAddress=46762050312&Operator=Vodafone&TimeStamp=20100401%2007%3A47%3A44&StatusCode=0
Example uchishandisa HTTP GET (isina kuendeswa, Operator yakapa nguvaamp kune chiitiko):
Iyo parameters ndeye URL encodedi.
Encoding yemavara:
Mupi weSevhisi anogona kusarudza kuti ndeupi waanofarira mavara encoding yekushandisa:
UTF-8 (inokurudzirwa)
ISO-8859-1.
9.1 Mvumo yeMupi weSevhisi
Mupi Webasa anofanira kubvuma mushumo wega wega wekutumira. Mvumo inogona kuva yakanaka, kureva kuti rondedzero yekutumira yakagamuchirwa zvakanaka, kana yakaipa, kureva kutadza.
Ndokumbira utarise: LINK Mobility ine nguva yekuverenga yekutenda kwemasekonzi makumi matatu yekutumirwa mishumo. Nguva yekupera inokonzeresa kuyedzwa kwekutumira (kana yedza zvakare yakagoneswa) kana kukanzurwa kwekutumira (kana kuedza zvakare kukadzimwa). Izvi zvinoreva kuti Service Provider application inofanirwa kuve nechokwadi chekupindura nekukurumidza, kunyanya panguva yekuremerwa.
Zvinokurudzirwa kubvuma rondedzero yekutumira yakanangana neLINK Mobility usati waigadzirisa.
Mutemo wekubvuma zvakanaka nezvakaipa unotsanangurwa sezvizvi:
Kubvuma kwakanaka, ACK, mushumo wekutumira unounzwa:
HTTP 200 renji remhinduro kodhi yakasanganiswa neinotevera XML yakafomatirwa zvirimo:
Kubvuma kusina kunaka, NAK, mushumo wekutumira hauna kuunzwa:
Chero mhinduro kunze kwekubvuma kwakanaka, kune example, kubvuma kwakashata kunokonzereswa nechero HTTP kukanganisa kodhi kana inotevera XML yemukati:
Iyo XML yemukati inogona kushandiswa kudzora iyo LINK Mobility retry mechanism. A NAK ichakonzera kuedzazve, kana ikagoneswa. Kune Vanopa Masevhisi vasina kugadzirwa kuti vaedze zvakare, zvirimo zveXML ndezvekusarudza.
Pazasi pane chikumbiro cheHTTP POST uye mhinduro exampre repoti rekutumira rinounzwa kune Mupi Webasa:
Chikumbiro cheHTTP:
POST /context/app HTTP/1.1
Zvemukati-Rudzi: kunyorera / x-www-fomu-urlencoded;charset=utf-8
Host: server:port
Content-Kureba: xx
MessageId=213123213&DestinationAddress=46762050312&Operator=Telia& OperatorTimeStamp=20130607%2010%3A45%3A00&TimeStamp=20130607%2010%3A 45%3A02&StatusCode=0
HTTP Mhinduro:
HTTP/1.1 200 OK
Zvemukati-Rudzi: zvinyorwa/plain
9.2 Edzazve
Iyo LINK Mobility system inogona kuedza zvakare kuedza kune yakundikana, kureva kusabvumwa, kutumira mishumo yekutumira. Mushandi weSevhisi anogona kusarudza yaanofarira kuedzazve maitiro:
Kwete kuedza zvakare (default) - meseji icharaswa kana kuedza kwekubatanidza kukatadza, verenga nguva yekubuda kana chero kodhi yeHTTP yekukanganisa.
Edza zvakare - iyo meseji inozoreverwa kune yega yega dambudziko rekubatanidza, kuverenga nguva, kana kubvuma kwakashata.
Kana yedzazve NAK ikagoneswa, zvakakosha kuti unzwisise kuti ndeapi mamiriro achaunza kuedzazve kubva kuLINK Mobility uye kuti kuedzazve kunoshanda sei. Mumwe nemumwe Mupi weSevhisi ane yake yekuyedza mutsara, uko mameseji anorairwa zvinoenderana nenguva yemesejiamp. Link Mobility inogara ichiedza kuendesa mameseji ekare kutanga, kunyangwe iyo yega yeodha yemeseji inounzwa kuMupi Webasa haina kuvimbiswa. Chikonzero chikuru chekuti mameseji araswe kubva pamutsetse wekuyedza chimwe chezvikonzero zviviri: ingave meseji yeTTL inopera kana (zvichireva) mutsara wekuedza zvakare uzere. Iyo TTL iOperator uye inoenderana neakaundi, kureva, inogona kusiyana zvichienderana neOperator uye kana meseji mhando, semuenzaniso, premium SMS kana mwero meseji yeSMS.
A Sevhisi Vanopa vane yekuedza zvakare yakagoneswa vanofanirwa kutarisa yakasarudzika ID yeMT meseji kuchengetedza kuti meseji haisati yatogamuchirwa.
Zvakakosha kuti Mupi Webasa aite maererano nemitemo iyi iri nyore apo kukanganisa kunoitika panguva yekugadzirisa rondedzero yekutumira kana chikonzero chekukanganisa chiri: Yenguva pfupi, semuenzaniso database isingawaniki, NAK inofanira kudzorerwa. LINK Kufamba kunotumira meseji.
Kusingaperi uye kuedzazve kuedza kunogona kukonzera rudzi rumwe chete rwedambudziko, ACK inofanira kudzorerwa. For example, kana meseji yatadza kukamurwa zvakanaka kana kukonzera kukanganisa kusingatarisirwe kwenguva yekumhanya.
Kuita zvinoenderana kuchaita kuti hapana kuvharika kana kusvibiswa kwemukati kunokonzerwa nekuda kweshumo rekutumira rinoramba richiramba.
10. Mazano ekuita
1. Zvinokwanisika kushandisa yako web browser kuendesa zvikumbiro kuAPI. Izvi zvinoita kuti zvive nyore kwazvo kuongorora uye kuongorora masevhisi pasina chero maturusi ebudiriro.
2. Chrome kana Firefox inokurudzirwa pamwe chete nekuwedzera senge JSONView kuratidza JSON yakarongeka.
3. Isu takashandisa SoapUI yekuyedza POST, Basic Authentication uye yekuongorora yakasvibira chikumbiro cheHTTP uye meseji yekupindura.
4. The cURL chishandiso chinobatsira kuendesa zvikumbiro zvePOST neBasic Authentication. Ona example pazasi.
curl POST \
-H "Zviri-Rudzi: chikumbiro/x-www-fomu-urlencoded" \
-H "Mvumo: Basic am9objpjaGFuZ2VtZSA=" \
https://europe.ipx.com/restapi/v1/sms/send \
-data "destinationAddress=46123456789&messageText=Hello+World%21"
_______________
Kushandura Personalized Communications
Zvinyorwa / Zvishandiso
 |
LINK Mobility Implementation Guide REST API SMS [pdf] Bhuku reMushandisi Mobility Implementation Guide REST API SMS, Mobility, Implementation Guide REST API SMS, REST API SMS, API SMS, SMS. |
