Stiùireadh Gnìomh Gluasaid LINK REST API SMS
Tha LINK Mobility a’ toirt seachad seirbheis airson lìbhrigeadh teachdaireachd, meanbh-phàighidhean, agus seirbheisean stèidhichte air àite. Bidh an àrd-ùrlar ag obair mar neach-ceannach susbaint soilleir, leubail geal agus router malairt eadar Solaraichean Seirbheis agus Luchd-obrachaidh.
Tha LINK Mobility a’ toirt seachad API RESTful a ghabhas cleachdadh gus faighinn gu seirbheisean LINK Mobility leithid a bhith a’ cur SMS. Tha an API seo air a dhealbhadh gus a bhith furasta a chleachdadh agus co-chòrdail ris a h-uile cànan agus frèam ùr-nodha. A’ cleachdadh a’ chànan as fheàrr leat faodaidh an tagradh agad an Link Mobility REST API a chleachdadh gus comasan teachdaireachdan is pàighidh cumhachdach a chuir an gnìomh
© LINK Mobility, 10 Màrt, 2021
Fiosrachadh laghail
Is ann le seilbh agus dlighe-sgrìobhaidh Netsize a-mhàin a tha am fiosrachadh a gheibhear san sgrìobhainn seo. Tha e dìomhair agus an dùil airson cleachdadh fiosrachaidh teann. Chan eil e ceangaltach agus dh’ fhaodadh gun tèid atharrachadh gun rabhadh. Bithear a’ meas gu bheil foillseachadh no cleachdadh gun chead sam bith mì-laghail.
Tha Netsize ™ agus linkmobility ™ air an dìon le laghan seilbh inntleachdail Frangach, EEC agus eadar-nàiseanta.
Is ann leis an luchd-seilbh aca a tha a h-uile comharra-malairt eile a chaidh ainmeachadh.
Cha tèid dad a tha an seo a mhìneachadh mar bhith a’ toirt seachad cead no còir fo peutant Netsize, dlighe-sgrìobhaidh no comharra-malairt.
GNATH-FHOCAIL
Société gun ainm no prìomh-bhaile de 5 478 070 iùro
Siège sòisealta: 62, slighe Emile Zola92100 Boulogne - An Fhraing
418 712 477 RCS Nanterre
http://www.LinkMobility.com
http://www.linkmobility.com
Farsaingeachd na Sgrìobhainn
Tha an sgrìobhainn seo a’ mìneachadh mar a bhios an Solaraiche Seirbheis a’ cleachdadh an LINK Mobility REST API airson SMS. Tha e airson ailtirean teignigeach agus dealbhadairean a bhios a’ cur an gnìomh seirbheisean an t-Solaraiche Seirbheis.
1. Cleachdadh Bunaiteach
Tha e gu math furasta SMS a chuir. Bidh thu a’ cur iarrtas HTTP gu LINK Mobility a ghabhas coileanadh le bhith a’ cleachdadh dìreach a web bhrabhsair.
2. Functional Overview
Tha siostam LINK Mobility a’ toirt seachad na feartan bunaiteach a leanas airson teachdaireachdan SMS:
A’ cur teachdaireachdan SMS Crìochnaichte Fòn-làimhe (MT), leithid teachdaireachdan teacsa no binary (me WAP Push) àrd-ìre agus teachdaireachdan ìre àbhaisteach.
A’ faighinn aithisgean lìbhrigidh airson teachdaireachdan MT a chaidh a chuir a-steach.
A’ faighinn teachdaireachdan SMS Tùs Fòn-làimhe (MO), prìomh ìre agus ìre àbhaisteach.
Tha an SMS REST API coisrigte airson teachdaireachdan SMS MT ìre àbhaisteach a chuir.
Bidh an API a’ cur a h-uile teachdaireachd SMS gu co-shìnte, a’ comasachadh feartan leithid:
“Teine-is-dìochuimhnich” - tha an Solaraiche Seirbheis ag iarraidh amannan freagairt nas ro-innseach a bhith aca agus chan eil e airson feitheamh ri toradh bhon Ghnìomhaiche.
Gnìomh a-rithist - Cuiridh LINK Mobility an teachdaireachd a-rithist ma tha duilgheadasan sealach aig a’ Ghnìomhaiche.
2.1 A’ cur teachdaireachd SMS
Solaraiche Seirbheis Netsize Consumer
- Cuir teachdaireachd MT
- Thoir air ais ID teachdaireachd
- Cuir a-steach teachdaireachd SMS
- Thoir seachad aithisg lìbhrigidh
- Cuir a-steach aithisg lìbhrigidh
Tha an sruth bunaiteach airson teachdaireachdan SMS a chuir air a mhìneachadh mar a leanas:
Bidh an Solaraiche Seirbheis a’ dèanamh iarrtas airson teachdaireachd SMS a chuir gu neach a gheibh e tro shiostam LINK Mobility.
Thèid ID teachdaireachd a thilleadh chun t-Solaraiche Seirbheis. Faodar an ID seo a chleachdadh airson me an teachdaireachd a cho-cheangal ris an aithisg lìbhrigidh cheart.
Bidh LINK Mobility a’ làimhseachadh slighe agus a’ lìbhrigeadh an teachdaireachd SMS don neach-cleachdaidh ris an deach dèiligeadh.
Tha aithisg lìbhrigidh air a phiobrachadh, me nuair a thèid an teachdaireachd SMS a lìbhrigeadh gu inneal an neach-cleachdaidh.
Thèid an aithisg lìbhrigidh a chuir chun t-Solaraiche Seirbheis. Tha an aon ID teachdaireachd san aithisg agus a chaidh a thilleadh ann an ceum 2.
Sruth eile: Iarrtas neo-dhligheach
Ma tha na paramadairean a chaidh a sholarachadh no na teisteanasan cleachdaiche san iarrtas neo-dhligheach thèid mearachd a thilleadh chun t-Solaraiche Seirbheis. Tha am mearachd a’ nochdadh an adhbhar airson a dhiùltadh agus thig an sruth gu crìch. Chan eil ID teachdaireachd air ais.
3. Endpoint
Gheibhear a-steach don ghoireas SMS leis an t-slighe:
/restapi/v1/sms
Example URL
https://europe.ipx.com/restapi/v1/sms
Airson tèarainteachd ceangail chan fhaighear an LINK Mobility REST API ach thairis air HTTPS.
Tha an teisteanas frithealaiche Link Mobility air a shoidhnigeadh le Thawte Server CA.
4. Obrachaidhean
Bidh an t-seirbheis SMS a’ toirt seachad na gnìomhan a leanas:
| Ainm | Slighe |
| Seol | /restapi/v1/sms/cuir |
4.1 Seol
Tha an gnìomhachd cuir air a chleachdadh gus SMS a chuir gu aon neach a gheibh e.
Tha an obrachadh seo airson luchd-cleachdaidh bunaiteach agus adhartach. Anns a 'chùis as sìmplidh, chan fheum ach seòladh ceann-uidhe, agus teacsa na teachdaireachd gus SMS a lìbhrigeadh. Lorgaidh LINK Mobility an Sgeama Còdaidh Dàta agus nì e ceangal fèin-ghluasadach de theachdaireachd gu grunn phàirtean teachdaireachd ma tha sin riatanach.
Airson cleachdadh adhartach, faodaidh an Solaraiche Seirbheis paramadairean roghainneil a chleachdadh airson smachd iomlan air cruth teachdaireachd a’ toirt a-steach bann dàta an neach-cleachdaidh.
Faodaidh an t-Solaraiche Seirbheis teachdaireachdan dùmhlaichte a chuir, ach feumaidh an Solaraiche Seirbheis ullachadh an dàta neach-cleachdaidh agus bann dàta luchd-cleachdaidh agus feumaidh an teachdaireachd a bhith air a chuir tro iomadh iarrtas cuir gu LINK Mobility.
5. Dearbhadh
Tha ainm-cleachdaidh agus facal-faire air an cur a-steach anns a h-uile iarrtas a’ cleachdadh Sgeama Dearbhaidh Bunasach HTTP.
https://www.w3.org/Protocols/HTTP/1.0/spec.html#BasicAA
Bithear a’ cur teisteanasan ann am bann-cinn Ùghdarrachaidh san iarrtas HTTP. Bidh an neach-dèiligidh a’ togail an raon cinn mar a tha air a mhìneachadh an seo:
https://en.wikipedia.org/wiki/Basic_access_authentication#Client_side
Airson example, mas e john an t-ainm-cleachdaiche agus is e changeme am facal-faire is e an ceann-cinn Ùghdarrachaidh a thig às:
Ùghdarrachadh: Basic am9objpjaGFuZ2VtZSA=
Mar chùl-raon faodar an t-ainm-cleachdaidh agus am facal-faire a chuir a-steach mar pharaimearan iarrtas. Chan eil seo air a mholadh ach airson teachdaichean nach eil a’ toirt taic do Basic Auth.
6. A 'cur a-steach iarrtas
6.1 Sreath ceist
Tha paramadairean iarrtas air an cur a-steach mar shreang ceist anns a bheil paidhrichean ainm/luach. Tha sreang na ceiste air a chòdachadh le còdachadh sa cheud (URL còdachadh).
http://www.w3schools.com/tags/ref_urlencode.asp
Airson example, Hello World! air a chòdachadh mar Hello+World%21.
6.2 Paramadairean iarrtas èigneachail
| Ainm | Fad as motha | Tuairisgeul |
| ceann-uidheAddress | 40 | An MSISDN ris am bu chòir an teachdaireachd SMS a chuir, a’ tòiseachadh le còd dùthcha. Mar eisimpleirample: 46123456789. Airson cuid de mhargaidhean (far am feumar an MSISDN Luchd-cleachdaidh a chuir am falach) faodaidh an luach seo a bhith na alias alphanumeric, le ro-leasachan le “#”. |
| teachdaireachdTeacs | 1600 | An t-susbaint teachdaireachd SMS. |
6.3 Paramadairean iarrtas roghainneil (airson cleachdadh adhartach)
| Ainm | Fad as motha | Tuairisgeul |
| Seòladh bho thùs | 16 | An seòladh tùsail airson an teachdaireachd SMS a chaidh a-mach. Tha an seòrsa seòladh tùsail air a mhìneachadh leis a’ pharameter tùsanach. Is e an àireamh ghoirid an fhad as motha 16. Tha an neach-cuiridh alpha àireamhach cuingealaichte ri Aibidil bunaiteach GSM le caractaran 11 aig a’ char as àirde. Is e 15 an fhad as motha a th’ aig neach-cuiridh MSISDN (a’ cleachdadh an aon chruth ris an eileamaid ceann-uidheAddress). Faodar a chuir air falbh nuair a bhios an siostam a’ taghadh seòladh tùsail agus originatingTON. Tha an gnìomh seo an urra ri margaidh agus rèiteachadh. Faodaidh giùlan atharrachadh a rèir aonachadh Gnìomhaiche. |
| tùsaireTON | 1 | Seòrsa àireamh an t-seòlaidh thùsail (TON): 0 - Àireamh ghoirid 1 - Alpha àireamhach (fad as motha 11) 2 - MSISDN Faodar a chuir air falbh nuair a thèid seòladh tùsail agus originatingTON a thaghadh leis an t-siostam. Tha an gnìomh seo an urra ri margaidh agus rèiteachadh. Faodaidh giùlan atharrachadh a rèir aonachadh Gnìomhaiche. |
| CleachdaicheDataHeader | 280 | Faodaidh suas ri 140 a bhith ann an Ceann Dàta Cleachdaiche còmhla ris an Dàta Cleachdaiche, ie 280 nuair a tha e air a chòdachadh le hex, octets. Tha am paramadair seo an-còmhnaidh air a chòdachadh le hex. |
| DCS | 3 | Sgeama còdaidh dàta. Faodaidh giùlan atharrachadh a rèir aonachadh Gnìomhaiche. |
| PID | 3 | ID protocol. Faodaidh giùlan atharrachadh a rèir aonachadh Gnìomhaiche. |
| càirdeasValidityTime | 6 | Ùine dligheachd coimeasach ann an diogan (an coimeas ris an ùine airson a chuir a-steach gu LINK Mobility). Is e an luach as àirde 604800 (7 latha) agus is e 48 uairean an àbhaist. Faodaidh giùlan atharrachadh a rèir aonachadh Gnìomhaiche. |
| àm lìbhrigidh | 20 | Uairamp nuair a bu chòir teachdaireachd SMS a lìbhrigeadh (ùine lìbhrigidh dàil). Faic an earrann air cruth ceann-latha. |
| brataichean aithris inbhe | 1 | Lìbhrig iarrtas aithisg: 0 - Gun aithisg lìbhrigidh (àbhaisteach) 1 - Aithisg lìbhrigidh air iarraidh 9 - Aithisg lìbhrigidh frithealaiche air iarraidh (cha chuir LINK Mobility an aithisg air adhart chun t-Solaraiche Seirbheis ach bidh e ri fhaighinn ann an aithisgean msaa.) |
| campaignAinm | 50 | Tha na gnothaichean gu lèir le roinn LINK Mobility tagged leis an ainm so. Tha e air a chleachdadh gus gnothaichean a chur còmhla ann an aithisgean Link Mobility. |
| Teachdaireachdan co-cheangailte as àirde | 1 | Luach eadar 1 agus 10 a tha a’ mìneachadh cia mheud teachdaireachd co-cheangail a tha ceadaichte. Is e 3 an àbhaist. |
| co-dhàimhId | 100 | ID air a thoirt seachad le Solaraiche Seirbheis a thèid a nochdadh san Aithisg Lìbhrigeadh. |
| ainm neach-cleachdaidh | 100 | Air a thoirt seachad mar roghainn eile an àite HTTP Basic Authentication. |
| facal-faire | 100 | Air a thoirt seachad mar roghainn eile an àite HTTP Basic Authentication. |
6.4 Modhan Iarr HTTP
Airson an eadar-obrachadh as motha, tha an API a’ toirt taic do mhodhan iarrtas HTTP GET agus POST. Chan eil dòighean HTTP sam bith eile ceadaichte.
6.4.1 GACH
Tha an t-sreath ceiste còdaichte ceangailte ris an fhaidhle URL.
FAIGHINN
https://europe.ipx.com/restapi/v1/sms/send?destinationAddress=461234
56789&messageText=Hello+Saoghal%21
Ùghdarrachadh: Basic am9objpjaGFuZ2VtZSA=
6.4.2 POST
Tha an sreang ceiste còdaichte air a chuir a-steach ann am buidheann teachdaireachd iarrtas HTTP. Is e an seòrsa susbaint tagradh / x-www-form-urlcòdachadh.
POST https://europe.ipx.com/restapi/v1/sms/send
Neach-aoigheachd: europe.ipx.com
Seòrsa-susbaint: tagradh / x-www-form-urlcòdachadh
Ùghdarrachadh: Basic am9objpjaGFuZ2VtZSA=
Fad susbaint: 57
destinationAddress=46123456789&messageText=Hello+Saoghal% 21
6.5 Ceann-latha agus uair
Tha paramadairean anns an REST API a tha a’ riochdachadh ceann-latha agus àm an-còmhnaidh ann an sòn ùine UTC (Ùine Coitcheann Co-òrdanaichte). Uairamps air an riochdachadh mar shreang leis an dearbh chruth seo:
2017-04-25T23:20:50Z
Tha seo a’ riochdachadh 20 mionaid agus 50 diog às deidh an 23mh uair den Ghiblean 25th, 2017 ann an UTC.
7. Teachdaireachd freagairt
Às deidh teachdaireachd iarrtas fhaighinn agus eadar-mhìneachadh bidh an API a’ freagairt le teachdaireachd freagairt HTTP.
7.1 Còd inbhe HTTP
Bidh an REST API an-còmhnaidh a’ tilleadh còd inbhe HTTP 200 ceart gu leòr airson iarrtasan giullachd. Anns a’ bhuidheann teachdaireachd tha Còd freagairt paramadair a thèid a chleachdadh gus an dearbh bhuil a dhearbhadh.
7.2 Buidheann teachdaireachd
Anns a’ bhuidheann teachdaireachd tha JSON a’ toirt cunntas air toradh an iarrtais.
http://json.org/
Tha Link Mobility JSON a’ cumail ri Stiùireadh Stoidhle Google JSON.
https://google.github.io/styleguide/jsoncstyleguide.xml
7.3 Paramadairean freagairt
| Ainm | Fad as motha | Tuairisgeul |
| Còd freagairt | 3 | 0 a’ comharrachadh malairt soirbheachail. |
| freagairt Teachdaireachd | 255 | Freagairt tuairisgeul teacsa, me teacsa mearachd. |
| uairamp | 20 | Ceann-latha agus àm nuair a làimhsich LINK Mobility an t-iarrtas. (Thoir sùil air an roinn cruth ceann-latha/ùine). |
| lorgId | 36 | Ceangal aithnichear a-staigh Mobility. Air a chleachdadh airson taic agus fuasgladh dhuilgheadasan. |
| teachdaireachd Ids | 10 x 36 | Sreath de IDan teachdaireachd sònraichte LINK Mobility airson gach teachdaireachd shoirbheachail (thèid iomadh ID teachdaireachd a thilleadh ma tha an teachdaireachd còmhla). Air fhàgail a-mach ann an cùis fàilligeadh. |
7.4 Eaample freagairtean
Soirbheachas
HTTP/1.1 200 ceart gu leòr
Seòrsa susbaint: tagradh / json
Fad susbaint: 144
Ceann-latha: Thu, 15 Sep 2016 13:20:31 GMT
{"responseCode": 0, "responseMessage": "Soirbheachas", "timestamp”:”2016-09-15T13:20:31Z”, “traceId”:”f678d30879fd4adc25f2″,”messageIds”:[“1-4850879008”]}
Seo an aon chruth JSON airson a bhith furasta a leughadh:
{
“Còd freagairt":0,
“freagairt Teachdaireachd“:”Soirbheachas”,
“uairamp“:”2016-0915T13:20:31Z”,
“lorgId“:”f678d30879fd4adc25f2”,
“teachdaireachd Ids":["1-4850879008"] }
Fàilligeadh
HTTP/1.1 200 ceart gu leòr
Seòrsa susbaint: tagradh / json
Fad susbaint: 148
Ceann-latha: Thu, 15 Sep 2016 13:20:31 GMT
{"responseCode": 1, "responseMessage": "Log a-steach mì-dhligheach no cleachdadh API gun chead"," as luaitheamp”:”2016-09-15T13:20:31Z”,”traceId”:”f678d30879fd4adc25f2″}
Soirbheachas
HTTP/1.1 200 ceart gu leòr
Seòrsa susbaint: tagradh / json
Fad susbaint: 144
Ceann-latha: Thu, 15 Sep 2016 13:20:31 GMT
{"responseCode": 0, "responseMessage": "Soirbheachas", "timestamp”:”2016-09-15T13:20:31Z”, “traceId”:”f678d30879fd4adc25f2″,”messageIds”:[“1-4850879008”]}
Seo an aon chruth JSON airson a bhith furasta a leughadh:
{
“Còd freagairt":0,
“freagairt Teachdaireachd“:”Soirbheachas”,
“uairamp“:”2016-0915T13:20:31Z”,
“lorgId“:”f678d30879fd4adc25f2”,
“teachdaireachd Ids":["1-4850879008"] }
Fàilligeadh
HTTP/1.1 200 ceart gu leòr
Seòrsa susbaint: tagradh / json
Fad susbaint: 148
Ceann-latha: Thu, 15 Sep 2016 13:20:31 GMT
{"responseCode": 1, "responseMessage": "Log a-steach mì-dhligheach no cleachdadh API gun chead"," as luaitheamp”:”2016-09-15T13:20:31Z”,”traceId”:”f678d30879fd4adc25f2″}
7.5 Còdan freagairt
Faodar na còdan freagairt a leanas a thilleadh san fhreagairt cuir:
| Còd | Teacs | Tuairisgeul |
| 0 | Soirbheachas | Air a chuir gu bàs gu soirbheachail. |
| 1 | Log a-steach mì-dhligheach no cleachdadh API gun chead | Tha ainm-cleachdaidh neo facal-faire ceàrr no solaraiche seirbheis air a thoirmeasg le LINK Mobility. |
| 2 | Tha neach-cleachdaidh air a bhacadh le Link Mobility | Tha an neach-cleachdaidh air a bhacadh le LINK Mobility. |
| 3 | Chan eil gnìomhachd air a sholarachadh le LINK Mobility | Tha an obrachadh air a bhacadh airson an t-Solaraiche Seirbheis. |
| 4 | Chan eil fios aig an neach-cleachdaidh air LINK Mobility | Chan eil an neach-cleachdaidh eòlach air LINK Mobility. No ma bha alias air a chleachdadh anns an iarrtas ; ailias nach deach a lorg. |
| 5 | Tha an neach-cleachdaidh air an t-seirbheis seo a bhacadh ann an LINK Mobility | Tha an Neach-cleachdaidh air an t-seirbheis seo a bhacadh ann an LINK Mobility. |
| 6 | Chan eil taic ris an t-seòladh tùsail | Chan eil taic ris an t-seòladh tùsail. |
| 7 | Seòladh tùsail Alpha nach eil a' faighinn taic bhon chunntas | Chan eil an cunntas a' cur taic ris an t-seòladh tùsail alpha. |
| 8 | Chan eil taic ris an t-seòladh tùsail MSISDN | Chan eil taic ris an t-seòladh tùsail MSISDN. |
| 9 | GSM leudaichte gun taic | GSM leudaichte gun taic. |
| 10 | Chan eil taic ri Unicode | Chan eil taic ri Unicode. |
| 11 | Chan eil taic ris an aithisg inbhe | Chan eil taic ris an aithisg inbhe. |
| 12 | Chan eil taic ri comas a tha a dhìth | Chan eil taic ris a’ chomas a tha a dhìth (ach a-mhàin na tha gu h-àrd) airson an teachdaireachd a chuir. |
| 13 | Thathas a’ dol thairis air an ìre smeòrach as àirde solaraiche susbaint | Tha an Solaraiche Seirbheis a’ cur na teachdaireachdan SMS gu LINK Mobility ro luath. |
| 14 | ID pròtacal nach eil a' faighinn taic bhon chunntas | Chan eil taic ri ID protocol. |
| 15 | Chaidh crìoch co-cheangail teachdaireachd thairis air | Tha an àireamh de theachdaireachdan co-cheangailte nas àirde na an àireamh as motha a chaidh iarraidh. |
| 16 | Cha ghabh an teachdaireachd slighe. | Cha b' urrainn do LINK Mobility an teachdaireachd a stiùireadh. |
| 17 | Ùine ùine toirmisgte | Chan eil cead teachdaireachd a chuir a-steach rè ùine |
| 18 | Cothromachadh ro ìosal air cunntas solaraiche seirbheis | Tha solaraiche seirbheis air a bhacadh air sgàth cothromachadh ro ìosal |
| 50 | Soirbheachas pàirt | Soirbheachas gu ìre nuair a chuireas tu teachdaireachd SMS gu grunn luchd-faighinn. |
| 99 | Mearachd an fhrithealaiche a-staigh | Mearachd Gluasad Ceangal eile, cuir fios gu taic LINK Mobility airson tuilleadh fiosrachaidh. |
| 100 | Seòladh ceann-uidhe mì-dhligheach | Tha an seòladh ceann-uidhe (MSISDN, no alias) neo-dhligheach. |
| 102 | ID mì-dhligheach (ceangailte). | Tha an ID iomraidh neo-dhligheach, is dòcha gu bheil an ID iomraidh air a chleachdadh mu thràth, ro sheann no neo-aithnichte. |
| 103 | Ainm cunntais mì-dhligheach | Tha ainm a’ chunntais mì-dhligheach. |
| 105 | Dàta meata seirbheis mì-dhligheach | Tha meata-dàta na seirbheis neo-dhligheach. |
| 106 | Seòladh tùsail mì-dhligheach | Tha an seòladh tùsail mì-dhligheach. |
| 107 | Seòladh tùsail alphanumeric mì-dhligheach | Tha an seòladh tùsail alphanumeric mì-dhligheach. |
| 108 | Ùine dligheachd mì-dhligheach | Tha an ùine dligheachd neo-dhligheach. |
| 109 | Ùine lìbhrigidh mì-dhligheach | Tha an ùine lìbhrigidh neo-dhligheach. |
| 110 | Susbaint teachdaireachd / dàta cleachdaiche mì-dhligheach | Tha an dàta cleachdaiche, ie an teachdaireachd SMS, neo-dhligheach. |
| 111 | Faid teachdaireachd mì-dhligheach | Tha fad na teachdaireachd SMS mì-dhligheach. |
| 112 | Ceann-cinn dàta cleachdaiche mì-dhligheach | Tha bann-cinn dàta an neach-cleachdaidh mì-dhligheach. |
| 113 | Sgeama còdaidh dàta mì-dhligheach | Tha an DCS neo-dhligheach. |
| 114 | ID pròtacal mì-dhligheach | Tha am PID neo-dhligheach. |
| 115 | Brataichean aithisg staid mì-dhligheach | Tha brataichean na h-aithisg inbhe neo-dhligheach. |
| 116 | TON mì-dhligheach | Tha an neach-tòiseachaidh TON mì-dhligheach. |
| 117 | Neo-dhligheach campaign ainm | Tha an campaign ainm neo-dhligheach. |
| 120 | Crìochan mì-dhligheach airson an àireamh as motha de theachdaireachdan co-cheangail | Tha an àireamh as motha de theachdaireachdan co-cheangailte mì-dhligheach. |
| 121 | Seòladh tùsail msisdn mì-dhligheach | Tha an seòladh tùsail MSISDN mì-dhligheach. |
| 122 | ID co-dhàimh mì-dhligheach | Tha an ID co-dhàimh neo-dhligheach. |
8. Feartan roghainneil
8.1 Ceartachadh MSISDN
Tha ceartachadh MSISDN na fheart roghainneil a ghabhas a chomasachadh le taic LINK Mobility ma thèid iarraidh.
Ceartaichidh am feart seo seòlaidhean ceann-uidhe agus co-thaobhadh iad ris an fhòrmat E.164 a tha a dhìth. A bharrachd air ceartachadh cruth faodaidh an siostam cuideachd gnìomhan sònraichte margaidh a dhèanamh leithid eadar-theangachadh àireamhan Frangach eadar-nàiseanta gus àireamhan DOM-TOM (départements et territoires d’outre-mer) a cheartachadh nuair a tha sin iomchaidh.
Gu h-ìosal tha grunn exampnas lugha de cheartachaidhean:
| Seòladh Ceann-uidhe air a chuir a-steach | Seòladh Ceann-uidhe ceartaichte |
| +46(0)702233445 | 46702233445 |
| (0046) 72233445 | 46702233445 |
| +460702233445 | 46702233445 |
| 46(0)702233445 | 46702233445 |
| 46070-2233445 | 46702233445 |
| 0046702233445 | 46702233445 |
| +46(0)702233445aaa | 46702233445 |
| 336005199999 | 2626005199999 (àireamh Frangach air eadar-theangachadh gu àireamh DOM-TOM) |
A bharrachd air an sin, tha e comasach àireamhan fòn nàiseanta a cheadachadh airson margaidh taghte. Nuair a bhios am feart seo air a chomasachadh feumar àireamhan eadar-nàiseanta sam bith airson margaidhean eile a chuir le soidhne `+' tùsail gus an dealachadh bhon mhargaidh taghte.
Gu h-ìosal tha grunn exampnas lugha de cheartachaidhean a chaidh a dhèanamh nuair a thathar a’ cleachdadh an t-Suain (còd dùthcha 46) mar mhargaidh àbhaisteach airson àireamhan nàiseanta.
| Seòladh Ceann-uidhe air a chuir a-steach | Seòladh Ceann-uidhe ceartaichte |
| 0702233445 | 46702233445 |
| 070-2233 445 | 46702233445 |
| 070.2233.4455 | 46702233445 |
| 460702233445 | 46702233445 |
| +460702233445 | 46702233445 |
| +458022334455 | 458022334455 |
| 45802233445 | Neo-dhligheach leis gu bheil an soidhne '+' a dhìth |
Thoir an aire gum bi an MSISDN ceartaichte air a chleachdadh le LINK Mobility agus gun tèid a thilleadh anns na h-aithisgean lìbhrigidh.
Feuch an cuir thu fios gu taic LINK Mobility airson tuilleadh fiosrachaidh.
8.2 Ath-nuadhachadh Caractaran
Tha ath-chur charactaran na fheart roghainneil a dh’ fhaodar a chomasachadh le taic LINK Mobility ma thèid iarraidh.
Bidh am feart seo ag eadar-theangachadh caractaran aibideil neo-GSM ann an dàta an neach-cleachdaidh (teacsa SMS) gu caractaran aibideil GSM co-ionann nuair a tha an DCS air a shuidheachadh gu “GSM” (17). Airson example “Seqüência de teste em Português” eadar-theangachadh gu “Seqüencia de teste em Portugues”.
9. Aithisgean lìbhrigidh
Faodaidh an Solaraiche Seirbheis, ma thèid a sholarachadh, aithisgean lìbhrigidh teachdaireachd SMS no fiosan lìbhrigidh iarraidh airson na teachdaireachdan MT a chaidh a chuir. Tha na h-aithisgean sin air am piobrachadh ann an SMSC Gnìomhaiche nuair a thèid an teachdaireachd MT a lìbhrigeadh don neach-cleachdaidh cuimsichte no a dhubhadh às, me, air tighinn gu crìch no, airson adhbhar air choireigin, gun a bhith air a ruith.
Chan eil ach inbhe deireannach na teachdaireachd SMS air aithris don t-Solaraiche Seirbheis, ie, air a lìbhrigeadh no air a dhubhadh às. Chan eil ach aon aithisg gach teachdaireachd MT ga chruthachadh. Leis an inbhe a chaidh a dhubhadh às, faodaidh còd adhbhar a bhith ann. Tha an còd adhbhar seo a’ sònrachadh an adhbhar airson nach deach an teachdaireachd SMS a lìbhrigeadh.
Tha na h-aithisgean air an stiùireadh tro LINK Mobility agus air an cur chun t-Solaraiche Seirbheis a’ cleachdadh protocol HTTP.
Gus aithisgean fhaighinn, feumaidh an Solaraiche Seirbheis a chuir an gnìomh airson example Java Servlet no duilleag ASP.NET. Bidh an dithis a’ faighinn iarrtasan HTTP GET no POST.
Paramadairean
Tha an t-iarrtas a’ toirt a-steach na paramadairean a leanas:
| Paramadair | Seòrsa | M/O/I* | Luach bunaiteach | Fad as motha | Tuairisgeul |
| TeachdaireachdId | sreang | M | – | 22 | ID teachdaireachd na teachdaireachd MT ris a bheil an aithisg seo a’ freagairt. |
| Seòladh Ceann-uidhe | sreang | M | – | 40 | MSISDN an neach-cleachdaidh, ie seòladh ceann-uidhe na teachdaireachd MT tùsail. |
| Còd Inbhe | iomlanachd | M | 1 | Tha còd inbhe a’ comharrachadh inbhe na teachdaireachd MT. Is e còdan inbhe iomchaidh: 0 - Air a lìbhrigeadh 2 - Air a dhubhadh às (còd adhbhar a’ buntainn) |
|
| UairStamp | sreang | M | – | 20 | Ùine a’ comharrachadh cuin a fhuair LINK Mobility an aithisg lìbhrigidh. Sòn ùine na h-ùine as àirdeamp is CET no CEST (le àm samhraidh mar a chaidh a mhìneachadh airson an EU). Cruth: yyyyMMdd HH: mm: ss. |
| Gnìomhaiche | sreang | M | – | 100 | Ainm a’ Ghnìomhaiche a chaidh a chleachdadh nuair a chuir thu an teachdaireachd SMS no an t-ainm cunntais a chaidh a chleachdadh nuair a chuirear an teachdaireachd SMS. Tha liosta de na gnìomhaichean a tha rim faighinn air a thoirt seachad le taic LINK Mobility. |
| Còd Adhbhar | iomlanachd | O | – | 3 | Tha còd adhbhar a’ nochdadh carson a thàinig an teachdaireachd gu crìch san inbhe a chaidh a dhubhadh às. Is e còdan adhbhar iomchaidh: 100 - Air tighinn gu crìch 101 - Air a dhiùltadh 102 - Mearachd cruth 103 - Mearachd eile 110 - Neo-aithnichte an neach-clàraidh 111 - Neach-clàraidh air a thoirmeasg 112 - Chan eil an neach-clàraidh air a sholarachadh 113 - Chan eil an neach-clàraidh ri fhaighinn 120 - Fàilligeadh SMSC 121 - dùmhlachd SMSC 122 - gluasad SMSC 130 - Mearachd inneal-làimhe 131 - Chaidh cuimhne inneal-làimhe seachad Faodaidh giùlan atharrachadh a rèir aonachadh Gnìomhaiche. |
| OperatorTimeStamp | sreang | O | – | 20 | Ùine a’ comharrachadh cuin a chaidh an aithisg a bhrosnachadh ann an SMSC a’ Ghnìomhaiche (ma thug an Gnìomhaiche seachad). Sòn ùine na h-ùine as àirdeamp is CET no CEST (le àm samhraidh mar a chaidh a mhìneachadh airson an EU). Cruth: yyyyMMdd HH: mm: ss. |
| Teacs inbhe | sreang | O | – | 255 | Neach-àite airson fiosrachadh a bharrachd bhon Ghnìomhaiche, me tuairisgeul teacsa soilleir air an inbhe/adhbhar. Faodaidh giùlan atharrachadh a rèir aonachadh Gnìomhaiche. |
| Co-dhàimhId | sreang | O | – | 100 | An ID co-dhàimh a chaidh a thoirt seachad anns an SendRequest no SendTextRequest. |
| Còd Obrachaidh Lìonra | iomlanachd | O | – | 6 | Còd Lìonra Fòn-làimhe (MCC + MNC) an gnìomhaiche. |
* M = Riatanach, O = Roghainneil, I = Air a leigeil seachad.
Feumaidh an Solaraiche Seirbheis an targaid a thoirt do LINK Mobility URL airson aithisgean lìbhrigidh (gu roghnach a’ toirt a-steach teisteanasan airson dearbhadh bunaiteach HTTP). Faodaidh an Solaraiche Seirbheis taghadh dè an dòigh HTTP as fheàrr leotha a chleachdadh:
HTTP POST (air a mholadh)
HTTP GET.
Example bhith a’ cleachdadh HTTP GET (air a lìbhrigeadh gu soirbheachail):
https://user:password@www.serviceprovider.com/receivereport?%20MessageId=122&DestinationAddress=46762050312&Operator=Vodafone&TimeStamp=20100401%2007%3A47%3A44&StatusCode=0
Example bhith a’ cleachdadh HTTP GET (cha deach a lìbhrigeadh, tha an Gnìomhaiche air timest a thoirt seachadamp airson an tachartais):
Tha na paramadairean URL còdachadh.
Còdachadh charactaran:
Faodaidh an Solaraiche Seirbheis taghadh dè an còdachadh caractar as fheàrr leotha a chleachdadh:
UTF-8 (air a mholadh)
ISO-8859-1.
9.1 Aithneachadh Solaraiche Seirbheis
Bu chòir don t-Solaraiche Seirbheis aithne a thoirt do gach aithisg lìbhrigidh. Faodaidh an aithne a bhith deimhinneach, ie aithisg lìbhrigidh air fhaighinn gu soirbheachail, no àicheil, ie fàilligeadh.
Thoir an aire: Tha ùine leughaidh aig LINK Mobility airson aideachadh 30 diog airson aithisgean lìbhrigidh. Brosnaichidh ùine-ama ath-thagradh lìbhrigidh (ma tha e comasach a-rithist) no cuir às don lìbhrigeadh (ma tha e ciorramach a-rithist). Tha seo a’ ciallachadh gum feum tagradh an t-Solaraiche Seirbheis dèanamh cinnteach à amannan freagairt luath, gu sònraichte aig àm luchdan àrd.
Thathas a’ moladh gu mòr an aithisg lìbhrigidh a dh’ ionnsaigh LINK Mobility aithneachadh mus giullachd e.
Tha an riaghailt airson aithne adhartach is àicheil air a mhìneachadh mar a leanas:
Aithneachadh adhartach, ACK, aithisg lìbhrigidh air a lìbhrigeadh:
Còd freagairt raon HTTP 200 an co-bhonn ris an t-susbaint cruth XML a leanas:
Aithneachadh àicheil, NAK, aithisg lìbhrigidh nach deach a lìbhrigeadh:
Freagairt sam bith ach aideachadh dearbhach, airson example, tha aithne àicheil air a bhrosnachadh le còd mearachd HTTP sam bith no an t-susbaint XML a leanas:
Faodar an susbaint XML a chleachdadh airson smachd a chumail air inneal ath-fheuchainn LINK Mobility. Nì NAK oidhirp a-rithist ma tha sin an comas. Airson Solaraichean Seirbheis nach eil air an rèiteachadh airson an uidheamachd ath-fheuchainn, tha an susbaint XML roghainneil.
Gu h-ìosal tha iarrtas HTTP POST agus freagairt example aithisg lìbhrigidh air a lìbhrigeadh gu Solaraiche Seirbheis:
Iarrtas HTTP:
POST / co-theacsa / app HTTP / 1.1
Seòrsa-susbaint: tagradh / x-www-form-urlcòdaichte;charset=utf-8
Host: frithealaiche: port
Susbaint-Fad: xx
MessageId=213123213&DestinationAddress=46762050312&Operator=Telia& OperatorTimeStamp=20130607%2010%3A45%3A00&TimeStamp=20130607%2010%3A 45%3A02&StatusCode=0
Freagairt HTTP:
HTTP/1.1 200 ceart gu leòr
Seòrsa susbaint: teacsa / sìmplidh
9.2 Feuch a-rithist
Faodaidh an siostam LINK Mobility oidhirpean a dhèanamh a-rithist airson lìbhrigeadh aithris lìbhrigidh air fàiligeadh, ie nach deach aithneachadh. Faodaidh an Solaraiche Seirbheis an giùlan ath-thagradh as fheàrr leotha a thaghadh:
Gun ath-fheuchainn (àbhaisteach) - thèid an teachdaireachd a thilgeil air falbh ma dh'fhàillig oidhirp ceangail, leugh ùine a-mach no airson còd mearachd HTTP sam bith.
Feuch a-rithist - bidh an teachdaireachd diombach airson a h-uile seòrsa de dhuilgheadas ceangail, ùine leughaidh, no aideachadh àicheil.
Nuair a bhios ath-fheuchainn airson NAK air a chomasachadh, tha e cudromach tuigsinn dè na suidheachaidhean a ghineas oidhirp a-rithist bho LINK Mobility agus mar a bhios an ath-fheuchainn ag obair. Tha ciudha ath-fheuchainn fhèin aig gach Solaraiche Seirbheis, far am bi teachdaireachdan air an òrdachadh a rèir an ùine teachdaireachd as luaitheamp. Bidh Link Mobility an-còmhnaidh a’ feuchainn ri teachdaireachdan nas sine a lìbhrigeadh an-toiseach, eadhon ged nach eil an òrdugh fa leth de theachdaireachdan a thèid a lìbhrigeadh don t-Solaraiche Seirbheis cinnteach. Is e am prìomh adhbhar airson teachdaireachdan a bhith air an toirt air falbh bhon chiudha ath-fheuchainn aon de dhà adhbhar: an dàrna cuid thig an teachdaireachd TTL gu crìch no (gu teòiridheach) bidh an ciudha ath-fheuchainn làn. Tha an TTL an urra ri Gnìomhaiche agus cunntas, ie, faodaidh e atharrachadh a rèir gnìomhaiche agus no seòrsa teachdaireachd, me, prìomh SMS no teachdaireachd SMS ìre àbhaisteach.
Feumaidh Solaraiche Seirbheis le ath-thilleadh sùil a thoirt air ID sònraichte na teachdaireachd MT gus dèanamh cinnteach nach d’ fhuaireadh am brath mu thràth.
Tha e cudromach gun cùm an t-Solaraiche Seirbheis ris na riaghailtean sìmplidh seo nuair a thachras mearachd nuair a thathar a’ giullachd aithisg lìbhrigidh mas e adhbhar na mearachd: Sealach, me stòr-dàta nach eil ri fhaighinn, bu chòir NAK a thilleadh. Cuiridh LINK Mobility am brath a-rithist.
Tha e coltach gun toir oidhirp maireannach agus ath-fheuchainn an aon sheòrsa duilgheadas, bu chòir ACK a thilleadh. Airson example, nuair nach b’ urrainnear an teachdaireachd a pharsadh gu ceart no nuair a dh’ adhbhraich e mearachd runtime ris nach robh dùil.
Le bhith ag obair a rèir sin nì sin cinnteach nach bi bacadh no truailleadh trochur air adhbhrachadh mar thoradh air aithisg lìbhrigidh a bhith a’ gabhail aithreachas a-rithist is a-rithist.
10. Molaidhean buileachaidh
1. Tha e comasach do chuid a chleachdadh web brabhsair gus iarrtasan a chuir a-steach don API. Tha seo ga dhèanamh gu math furasta na seirbheisean a sgrùdadh agus a mheasadh gun innealan leasachaidh sam bith.
2. Thathas a’ moladh Chrome no Firefox còmhla ri leudachadh leithid JSONView gus JSON ann an cruth breagha a thaisbeanadh.
3. Tha sinn air SoapUI a chleachdadh airson deuchainn POST, Dearbhadh Bunasach agus airson sgrùdadh a dhèanamh air iarrtas HTTP amh agus teachdaireachdan freagairt.
4. Tha an cURL tha inneal feumail airson iarrtasan POST a chuir a-steach le Dearbhadh Bunasach. Faic exampgu h-ìosal.
curl POST \
-H “Susbaint-Seòrsa: iarrtas/x-www-form-urlair a chòdachadh" \
-H “Ùghdarrachadh: Bunasach am9objpjaGFuZ2VtZSA=” \
https://europe.ipx.com/restapi/v1/sms/send \
-data “ceann-uidheAddress=46123456789&messageText=Hello+Saoghal%21"
_______________
Ag atharrachadh Conaltradh Pearsanta
Sgrìobhainnean/Goireasan
 |
Stiùireadh Gnìomh Gluasaid LINK REST API SMS [pdfStiùireadh Cleachdaiche Stiùireadh Gnìomh Gluasaid REST API SMS, Gluasad, Stiùireadh Gnìomh REST API SMS, REST API SMS, API SMS, SMS |
