LINK Rêbernameya Pêkanîna Mobility REST API SMS
LINK Mobility karûbarek ji bo gihandina peyam, dravê mîkro, û karûbarên cîh-based peyda dike. Platform di navbera Pêşkêşkerên Karûbar û Operatoran de wekî hilgirê naverokek zelal, spî-labelê û routerê danûstendinê tevdigere.
LINK Mobility API-ya RESTful peyda dike ku dikare were bikar anîn da ku bigihîje karûbarên LINK Mobility wekî şandina SMS. Ev API ji bo karanîna hêsan û bi hemî ziman û çarçoveyên nûjen re têkildar e. Bi karanîna zimanê bijareya we serîlêdana we dikare API-ya Link Mobility REST bikar bîne da ku kapasîteyên peyam û dravdanê yên bihêz bicîh bîne.
© LINK Mobility, 10ê Adarê, 2021
Agahiyên Hiqûqî
Agahdariya ku di vê belgeyê de hatî peyda kirin yekane milk û mafê telîfê yê Netsize ye. Ew nehênî ye û ji bo karanîna hişk a agahdarî tête armanc kirin. Ew ne girêdayî ye û dibe ku bêyî agahdarî were guhertin. Her eşkerekirin an karanîna bê destûr dê wekî neqanûnî were hesibandin.
Netsize™ û linkmobility™ ji hêla qanûnên milkê rewşenbîrî yên fransî, EEC û navneteweyî ve têne parastin.
Hemî tîcaretên din ên ku hatine destnîşan kirin yekane milkê xwediyên wan ên têkildar in.
Tiştek ku li vir heye nayê şîrove kirin ku di bin patenta Netsize, mafê kopî, an nîşana bazirganî de destûrek an mafek dide.
NETSIZE
Société anonyme au paytexta 5 478 070 euro
Siège civakî: 62, kolana Emile Zola92100 Boulogne - Fransa
418 712 477 RCS Nanterre
http://www.LinkMobility.com
http://www.linkmobility.com
Qada Belge
Ev belge diyar dike ka çawa Dabînkerê Karûbar LINK Mobility REST API-ya ji bo SMS-ê bikar tîne. Ew ji bo mîmar û sêwiranerên teknîkî yên ku karûbarên Pêşkêşvanê Karûbarê bicîh dikin tê armanc kirin.
1. Bikaranîna bingehîn
Pir hêsan e ku SMS bişînin. Hûn daxwazek HTTP ji LINK Mobility re dişînin ku tenê bi karanîna yek dikare pêk were web geroka.
2. Functional Overview
Pergala Mobility LINK ji bo peyamên SMS fonksiyonên bingehîn ên jêrîn peyda dike:
Şandina mesajên SMS yên bi dawîbûyî (MT) yên mobîl, wek mesajên metn an binary (mînak WAP Push) premium û rêjeya standard.
Wergirtina raporên radestkirinê ji bo peyamên MT-ê hatine şandin.
Wergirtina peyamên SMS-ê yên Orijînal ên Mobîl (MO), premium û rêjeya standard.
SMS REST API ji bo şandina mesajên SMS-ya MT-ê ya standard tê veqetandin.
API hemî peyamên SMS bi asynkron dişîne, taybetmendiyên wekî:
"Agir-û-jibîrkirin" - Pêşkêşkerê Karûbar dixwaze ku demên bersivê yên pêşbîntir hebe û naxwaze li benda encama Operatorê bimîne.
Fonksiyonê ji nû ve biceribîne - Ger Operator pirsgirêkên demkî hebin dê LINK Mobility ji nû ve peyamê bişîne.
2.1 Şandina peyamek SMS
Pêşkêşvanê Xizmetê Netsize Serfkaran
- Peyama MT bişînin
- Nasnameya peyamê vegere
- Peyama SMS bişînin
- Rapora radestkirinê radest bikin
- Rapora radestkirinê bişînin
Herikîna bingehîn ji bo şandina peyamên SMS bi vî rengî tête diyar kirin:
Dabînkerê Karûbar daxwazek dike ku bi pergala LINK Mobility re peyamek SMS ji wergirek re bişîne.
Nasnameyek peyamê ji Pêşkêşvanê Karûbarê re tê vegerandin. Ev ID dikare ji bo nimûne ji bo girêdana peyamê bi raporta radestkirina rast re were bikar anîn.
LINK Mobility rêvekirinê dimeşîne û peyama SMS-ê dide Serfkaranê navnîşan.
Nimûne dema ku peyama SMS ji cîhaza Serfkaran re tê şandin, raporek radestkirinê dest pê dike.
Rapora radestkirinê ji Pêşkêşvanê Karûbarê re tê şandin. Rapor heman ID-ya peyamê ya ku di gava 2-an de hatî vegerandin dihewîne.
Herikîna Alternatîf: Daxwaza nederbasdar
Ger parametreyên peydakirî an pêbaweriyên bikarhêner ên di daxwaznameyê de nederbasdar bin, xeletiyek ji Pêşkêşvanê Karûbarê re tê vegerandin. Çewtî sedema redkirinê nîşan dide û herikîn bi dawî dibe. Nasnameyên peyamê nayên vegerandin.
3. Dawiya dawî
Çavkaniya SMS-ê bi riya rê ve tê gihîştin:
/restapi/v1/sms
Example URL
https://europe.ipx.com/restapi/v1/sms
Ji bo ewlehiya girêdanê, LINK Mobility REST API tenê li ser HTTPS-ê tê gihîştin.
Sertîfîkaya servera Link Mobility ji hêla Thawte Server CA ve hatî îmze kirin.
4. Operasyonên
Karûbarê SMS karûbarên jêrîn peyda dike:
| Nav | Şop |
| Şandin | /restapi/v1/sms/send |
4.1 Bişîne
Operasyona şandinê ji bo şandina SMS ji yek wergir re tê bikar anîn.
Ev operasyon hem ji bo bikarhênerên bingehîn û hem jî yên pêşkeftî tête armanc kirin. Di rewşa herî hêsan de, tenê navnîşana cîhê, û nivîsa peyamê ji bo radestkirina SMS-ê hewce ne. LINK Mobility dê Bernameya Kodkirina Daneyê tespît bike û heke hewce bike, pevgirêdana otomatîkî ya peyamekê di gelek beşên peyamê de pêk tîne.
Ji bo karanîna pêşkeftî, Pêşkêşkarê Karûbar dikare pîvanên vebijarkî bikar bîne ji bo kontrolkirina tevahî ya formata peyamê tevî sernavê daneyên bikarhêner.
Pêşkêşkarê karûbarê dikare peyamên hevgirtî bişîne, lê amadekirina daneyên bikarhêner û sernavê daneyên bikarhêner divê ji hêla Pêşkêşkarê Karûbar ve were kirin û divê peyam bi çend daxwazên şandinê ber bi LINK Mobility ve were şandin.
5. Authentication
Navê bikarhêner û şîfre di her daxwazê de bi karanîna Bernameya Rastkirina Bingehîn a HTTP têne şandin.
https://www.w3.org/Protocols/HTTP/1.0/spec.html#BasicAA
Di daxwaza HTTP de pêbawerî di sernavek Destûrnameyê de têne şandin. Xerîdar qada sernavê wekî ku li vir hatî destnîşan kirin ava dike:
https://en.wikipedia.org/wiki/Basic_access_authentication#Client_side
Ji bo exampLe, heke navê bikarhêner john be û changeme şîfre be, wê hingê sernavê Desthilatdariyê ya encam ev e:
Destûrname: Bingehîn am9objpjaGFuZ2VtZSA=
Wekî paşveçûn, navê bikarhêner û şîfre dikare wekî pîvanên daxwaznameyê bêne şandin. Ev tenê ji bo xerîdarên ku Destûrnameya Bingehîn piştgirî nakin tê pêşniyar kirin.
6. Serlêdana daxwazek
6.1 Rêza pirsê
Parametreyên daxwaznameyê wekî rêzika pirsê ku cotên nav/nirx dihewîne têne şandin. Rêzika pirsê bi karanîna Sedî Encoding (URL şîfrekirin).
http://www.w3schools.com/tags/ref_urlencode.asp
Ji bo example, Silav Cîhan! wekî Hello+Corld%21 tê kodkirin.
6.2 Parametreyên daxwaza mecbûrî
| Nav | Dirêjahiya herî zêde | Terîf |
| destinationAdress | 40 | MSISDN ya ku divê peyama SMS jê re bê şandin, bi koda welat dest pê dike. Example: 46123456789. Ji bo hin bazaran (ku divê MSISDN-ya Serfkaran tê de bête qewirandin) ev nirx di heman demê de dikare navekî alfan-hejmarî jî be, bi pêşgira "#" re. |
| messageText | 1600 | Naveroka peyama SMS. |
6.3 Parametreyên daxwaza vebijarkî (ji bo karanîna pêşkeftî)
| Nav | Dirêjahiya herî zêde | Terîf |
| originatingAdress | 16 | Navnîşana bingehîn ji bo peyama SMS-ê ya derketî. Tîpa navnîşana destpêkê ji hêla parametreya originatorTON ve tê destnîşankirin. Dirêjahiya herî zêde ya hejmara kurt 16 e. Alfabeya jimareya alpha bi Alfabeya xwerû ya GSM ya bi dirêjahiya herî zêde 11 tîpan ve sînorkirî ye. Dirêjahiya herî zêde ya şanderê MSISDN 15 e (heman formata ku hêmana navnîşana destan bikar tîne). Dema ku ji hêla pergalê ve hatî hilbijartin Address û originatingTON were derxistin. Ev fonksiyon bi bazar û veavakirinê ve girêdayî ye. Dibe ku tevger bi entegrasyonên Operatorê re diguhere. |
| destpêkerTON | 1 | Cureya jimareya navnîşana destpêkê (TON): 0 – Hejmara kurt 1 - Hejmara alpha (dirêjahiya herî zêde 11) 2 - MSISDN Dema ku destpêkêNavnîşan û destpêkê TON ji hêla pergalê ve were hilbijartin, dikare were jêbirin. Ev fonksiyon bi bazarê û veavakirinê ve girêdayî ye. Dibe ku tevger bi entegrasyonên Operatorê re diguhere. |
| userDataHeader | 280 | Sernivîsa Daneyên Bikarhêner li gel Daneyên Bikarhêner dikare heta 140, ango 280 hex-encod, oktetan hebin. Ev parametre her gav hex-encoded e. |
| DCS | 3 | Plana kodkirina daneyê. Dibe ku tevger bi entegrasyonên Operatorê re diguhere. |
| PID | 3 | Nasnameya protokolê. Dibe ku tevger bi entegrasyonên Operatorê re diguhere. |
| relativeValidityTime | 6 | Demjimêra pêbaweriya nisbî di çirkeyan de (li gorî dema radestkirina LINK Mobility). Nirxa herî zêde 604800 e (7 roj) û xwerû 48 demjimêr e. Dibe ku tevger bi entegrasyonên Operatorê re diguhere. |
| deliveryTime | 20 | Demestamp dema ku divê peyama SMS were radest kirin (dema radestkirina dereng). Li beşa li ser formata demjimêra tarîxê binêre. |
| statusReportFlags | 1 | Daxwaza raporkirina raporê: 0 - Rapora radestkirinê tune (xweserî) 1 – Rapora radestkirinê tê xwestin 9 - Rapora radestkirina serverê tê xwestin (LINK Mobility raporê ji Pêşkêşkarê Karûbarê re naşîne lê di raporan de peyda dike û hwd.) |
| campaignName | 50 | Danûstendinên Mobility LINK in tagbi vî navî gehiştine. Ew ji bo komkirina danûstandinên di raporên Link Mobility de tê bikar anîn. |
| maxConcatenatedMessages | 1 | Nirxek di navbera 1 û 10-ê de ku diyar dike ka çend peyamên hevgirtî yên destûr têne dayîn. Standard 3 ye. |
| pêwendîId | 100 | Nasnameya ku ji hêla Pêşkêşvanê Karûbar ve hatî peyda kirin ku dê di Rapora Radestkirinê de were xuyang kirin. |
| navê bikarhêner | 100 | Ji bo Nasnameya Bingehîn a HTTP wekî alternatîfek tê peyda kirin. |
| şîfre | 100 | Ji bo Nasnameya Bingehîn a HTTP wekî alternatîfek tê peyda kirin. |
6.4 Rêbazên Daxwaza HTTP
Ji bo hevberdana herî zêde, API hem rêbazên daxwaza HTTP GET û hem jî POST piştgirî dike. Rêbazên HTTP yên din nayên destûr kirin.
6.4.1 GET
Rêza pirsê ya kodkirî li ser tê pêve kirin URL.
STENDIN
https://europe.ipx.com/restapi/v1/sms/send?destinationAddress=461234
56789&messageText=Silav+Cîhan%21
Destûrname: Bingehîn am9objpjaGFuZ2VtZSA=
6.4.2 POST
Rêza pirsê ya kodkirî di laşê peyama daxwaza HTTP de tê şandin. Naverok-Cûreya serîlêdanê/x-www-form- eurlkodkirî.
KOZ https://europe.ipx.com/restapi/v1/sms/send
Mêvandar: europe.ipx.com
Type-naverok: sepandin / x-www-form-urlkodkirî
Destûrname: Bingehîn am9objpjaGFuZ2VtZSA=
Naverok-Dirêjahî: 57
destinationAddress=46123456789&messageText=Silav+Cîhan%21
6.5 Dîrok û dem
Parametreyên di REST API-ya ku tarîx û dem temsîl dikin de her gav di qada demjimêra UTC de ne (Dema Gerdûnî ya Hevrêzkirî). Timestamps wekî rêzek bi vê formata tam têne destnîşan kirin:
2017-04-25T23:20:50Z
Ev 20 hûrdem û 50 saniye piştî demjimêra 23-ê ya 25-ê Avrêl, 2017-an li UTC-ê nîşan dide.
7. Peyama bersivê
Piştî wergirtin û şîrovekirina peyamek daxwaznameyê, API bi peyamek bersiva HTTP bersiv dide.
7.1 Koda rewşa HTTP
REST API ji bo daxwazên pêvajoyî her gav koda rewşa HTTP 200 OK vedigerîne. Di laşê peyamê de kodek bersivê ya parametreyê heye ku ji bo destnîşankirina encama rast tê bikar anîn.
7.2 Bedena peyamê
Laşê peyamê ji JSON pêk tê ku encama daxwaznameyê diyar dike.
http://json.org/
Girêdana Mobility JSON bi Rêbernameya Style ya Google JSON re tevdigere.
https://google.github.io/styleguide/jsoncstyleguide.xml
7.3 Parametreyên bersivê
| Nav | Dirêjahiya herî zêde | Terîf |
| bersivCode | 3 | 0 danûstendina serketî nîşan dide. |
| bersivPeyam | 255 | Danasîna nivîsê ya bersivê, p.ex. |
| timestamp | 20 | Dîrok û dema ku LINK Mobility daxwazê kir. (Li beşa formata tarîx/demê binihêrin). |
| traceId | 36 | Nasnameya navxweyî ya Mobility Link. Ji bo piştgirî û çareserkirina pirsgirêkan tê bikar anîn. |
| messageIds | 10 x 36 | Rêzeya LINK Mobility Nasnameyên yekta peyamê ji bo her peyamek serketî (heke peyam bi hev ve girêdayî be, gelek nasnameyên peyamê têne vegerandin). Di rewşa têkçûnê de tê derxistin. |
7.4 Mînakampbersivên
Serketinî
HTTP/1.1 200 OK
Naverok-Tîpa: sepan / json
Naverok-Dirêjahî: 144
Dîrok: Pênc, 15 Îlon 2016 13:20:31 GMT
{"responseCode":0,"responseMessage":"Serkeftin","timeestamp”:”2016-09-15T13:20:31Z”, “traceId”:”f678d30879fd4adc25f2″,”messageIds”:[“1-4850879008”]}
Li vir heman JSON e ku ji bo xwendinê hatî format kirin:
{
"bersivCode":0,
"bersivPeyam":"Serketinî",
"timestamp“:”2016-0915T13:20:31Z”,
"traceId“:”f678d30879fd4adc25f2”,
"messageIds":["1-4850879008"] }
Têkçûnî
HTTP/1.1 200 OK
Naverok-Tîpa: sepan / json
Naverok-Dirêjahî: 148
Dîrok: Pênc, 15 Îlon 2016 13:20:31 GMT
{“responseCode”:1,”responseMessage”:” Têketinê nederbasdar an karanîna API-ya nedestûrkirî”,”timestamp”:”2016-09-15T13:20:31Z”,”traceId”:”f678d30879fd4adc25f2″}
Serketinî
HTTP/1.1 200 OK
Naverok-Tîpa: sepan / json
Naverok-Dirêjahî: 144
Dîrok: Pênc, 15 Îlon 2016 13:20:31 GMT
{"responseCode":0,"responseMessage":"Serkeftin","timeestamp”:”2016-09-15T13:20:31Z”, “traceId”:”f678d30879fd4adc25f2″,”messageIds”:[“1-4850879008”]}
Li vir heman JSON e ku ji bo xwendinê hatî format kirin:
{
"bersivCode":0,
"bersivPeyam":"Serketinî",
"timestamp“:”2016-0915T13:20:31Z”,
"traceId“:”f678d30879fd4adc25f2”,
"messageIds":["1-4850879008"] }
Têkçûnî
HTTP/1.1 200 OK
Naverok-Tîpa: sepan / json
Naverok-Dirêjahî: 148
Dîrok: Pênc, 15 Îlon 2016 13:20:31 GMT
{“responseCode”:1,”responseMessage”:” Têketinê nederbasdar an karanîna API-ya nedestûrkirî”,”timestamp”:”2016-09-15T13:20:31Z”,”traceId”:”f678d30879fd4adc25f2″}
7.5 Kodên bersivê
Di bersiva şandinê de kodên bersivê yên jêrîn dikarin werin vegerandin:
| Navê dizî | Nivîstok | Terîf |
| 0 | Serketinî | Bi serketî îdam kirin. |
| 1 | Têketinê nederbasdar an karanîna API-ya ne-destûrkirî | Navê bikarhêner an şîfreya çewt an Pêşkêşvanê Karûbar ji hêla LINK Mobility ve hatî asteng kirin. |
| 2 | Xerîdar ji hêla Link Mobility ve hatî asteng kirin | Serfkaran ji hêla LINK Mobility ve hatî asteng kirin. |
| 3 | Operasyon ji hêla LINK Mobility ve nayê peyda kirin | Operasyon ji bo Pêşkêşvanê Xizmetê tê asteng kirin. |
| 4 | Xerîdar ji LINK Mobility re nenas e | Serfkaran ji LINK Mobility re nenas e. An jî heke di daxwaznameyê de navekî hatibe bikaranîn; nasnav nehat dîtin. |
| 5 | Xerîdar ev karûbar di LINK Mobility de asteng kiriye | Serfkaran ev karûbar di LINK Mobility de asteng kiriye. |
| 6 | Navnîşana destpêkê nayê piştgirî kirin | Navnîşana destpêkê nayê piştgirî kirin. |
| 7 | Navnîşana bingehîn a Alpha ji hêla hesabê ve nayê piştgirî kirin | Navnîşana bingehîn a alfa ji hêla hesabê ve nayê piştgirî kirin. |
| 8 | Navnîşana destpêkê ya MSISDN nayê piştgirî kirin | Navnîşana destpêkê ya MSISDN nayê piştgirî kirin. |
| 9 | GSM dirêjkirî nayê piştgirî kirin | GSM dirêjkirî nayê piştgirî kirin. |
| 10 | Unicode nayê piştgirî kirin | Unicode nayê piştgirî kirin. |
| 11 | Rapora statûyê nayê piştgirî kirin | Rapora statûyê nayê piştgirî kirin. |
| 12 | Kapasîteya pêdivî nayê piştgirî kirin | Kapasîteya pêwîst (ji bilî jorîn) ji bo şandina peyamê nayê piştgirî kirin. |
| 13 | Rêjeya herî zêde ya dabînkerê naverokê derbas bûye | Pêşkêşkarê Karûbar ji LINK Mobility re peyamên SMS pir zû dişîne. |
| 14 | Nasnameya protokolê ji hêla hesabê ve nayê piştgirî kirin | Nasnameya protokolê nayê piştgirî kirin. |
| 15 | Sînorê pevgirêdana peyamê derbas bû | Hejmara peyamên hevgirtî ji hejmara herî zêde ya tê xwestin derbas dibe. |
| 16 | Nekare peyamê bişîne. | LINK Mobility nikarî peyamê bi rê ve bibe. |
| 17 | Demjimêra qedexekirî | Di dema wextê de destûr nayê dayîn ku peyam bişînin |
| 18 | Balansa pir kêm li ser hesabê pêşkêşvanê karûbarê | Pêşkêşvanê karûbar ji ber balansa pir kêm tê asteng kirin |
| 50 | Serkeftina qismî | Serkeftina qismî dema şandina peyamek SMS ji gelek wergiran re. |
| 99 | Çewtiya servera navxweyî | Çewtiya Din Mobility Link, ji bo bêtir agahdarî bi piştgiriya LINK Mobility re têkilî daynin. |
| 100 | Navnîşana cîhê nederbasdar | Navnîşana mebestê (MSISDN, an jî navnav) nederbasdar e. |
| 102 | Nasnameya referanskirî (girêdayî) nederbasdar | Nasnameya referansê nederbasdar e, dibe ku nasnameya referansê jixwe hatiye bikaranîn, pir kevn an nenas. |
| 103 | Navê hesabê nederbasdar | Navê hesabê nederbasdar e. |
| 105 | Daneyên meta karûbarê nederbasdar | Daneyên meta karûbarê nederbasdar e. |
| 106 | Navnîşana destpêkê nederbasdar e | Navnîşana destpêkê nederbasdar e. |
| 107 | Navnîşana bingehîn a alfan-hejmarî nederbasdar | Navnîşana bingehîn a alfanumerîkî nederbasdar e. |
| 108 | Dema derbasbûna nederbasdar | Dema derbasbûnê nederbasdar e. |
| 109 | Dema radestkirina nederbasdar | Dema radestkirinê nederbasdar e. |
| 110 | Naveroka peyama nederbasdar / Daneyên bikarhêner | Daneyên bikarhêner, ango peyama SMS nederbasdar e. |
| 111 | Dirêjahiya peyama nederbasdar | Dirêjahiya peyama SMS nederbasdar e. |
| 112 | Sernavê daneyên bikarhênerê nederbasdar | Sernavê daneyên bikarhêner nederbasdar e. |
| 113 | Plana kodkirina daneya nederbasdar | DCS nederbasdar e. |
| 114 | Nasnameya protokola nederbasdar | PID nederbasdar e. |
| 115 | Alên raporê yên nederbasdar | Alên raporên statûyê nederbasdar in. |
| 116 | TON nederbasdar | Destpêker TON nederbasdar e. |
| 117 | Nederbasdar campnavê wî | The campnavê aign nederbasdar e. |
| 120 | Sînorê nederbasdar ji bo hejmara herî zêde ya peyamên hevgirtî | Hejmara herî zêde ya peyamên hevgirtî nederbasdar e. |
| 121 | Navnîşana destpêkê ya msisdn nederbasdar e | Navnîşana destpêkê ya MSISDN nederbasdar e. |
| 122 | Nasnameya pêwendiya nederbasdar | Nasnameya pêwendiyê nederbasdar e. |
8. Taybetmendiyên Bijarî
8.1 Rastkirina MSISDN
Serrastkirina MSISDN taybetmendiyek vebijarkî ye ku ger were xwestin dikare ji hêla piştgiriya LINK Mobility ve were çalak kirin.
Ev taybetmendî dê navnîşanên meqsedê rast bike û wan bi forma E.164 ya pêwîst re li hev bike. Digel rastkirina formê, dibe ku pergal fonksiyonek taybetî ya bazarê jî bike, wek wergerkirina hejmarên fransî yên navneteweyî ji bo rastkirina hejmarên DOM-TOM (départements et territoires d'outre-mer) dema ku hebe.
Li jêr hejmarek ji examprêgezên serrastkirinê:
| Submitted Destination Address | Navnîşana Destûra Rastkirî |
| +46 (0) 702233445 | 46702233445 |
| (0046)72233445 | 46702233445 |
| +460702233445 | 46702233445 |
| 46(0)702233445 | 46702233445 |
| 46070-2233445 | 46702233445 |
| 0046702233445 | 46702233445 |
| +46 (0) 702233445aaa | 46702233445 |
| 336005199999 | 2626005199999 (Hejmarek fransî ji bo hejmarek DOM-TOM hatî wergerandin) |
Wekî din, gengaz e ku ji bo bazarek hilbijartî destûr bide jimareyên têlefonên neteweyî. Dema ku ev taybetmendî were çalak kirin, divê ji bo bazarên din jimareyên navneteweyî bi nîşana destpêkê ya `+' werin şandin da ku ew ji bazara hilbijartî cuda bibin.
Li jêr çend berê heneampDema ku Swêd (koda welat 46) wekî bazara xwerû ji bo hejmarên neteweyî tê bikar anîn, sererastkirinên ku têne kirin.
| Submitted Destination Address | Navnîşana Destûra Rastkirî |
| 0702233445 | 46702233445 |
| 070-2233 445 | 46702233445 |
| 070.2233.4455 | 46702233445 |
| 460702233445 | 46702233445 |
| +460702233445 | 46702233445 |
| +458022334455 | 458022334455 |
| 45802233445 | Nederbasdar e ji ber ku nîşana '+' winda ye |
Têbînî ku MSISDN-ya rastkirî dê ji hêla LINK Mobility ve were bikar anîn û ew ê di raporên radestkirinê de were vegerandin.
Ji kerema xwe ji bo bêtir agahdarî bi piştgiriya LINK Mobility re têkilî daynin.
8.2 Replacement Karaktera
Veguheztina karakter taybetmendiyek vebijarkî ye ku heke were xwestin dikare ji hêla piştgiriya LINK Mobility ve were çalak kirin.
Ev taybetmendî dê tîpên alfabeya ne-GSM yên di daneya bikarhêner de (nivîsa SMS) wergerîne tîpên alfabeya GSM yên hevwate dema ku DCS li ser "GSM" were danîn (17). Ji bo example "Seqüência de teste em Português" dê bibe "Seqüencia de teste em Portugues".
9. Raporên radestkirinê
Dabînkerê Karûbar dikare, heke were peyda kirin, ji bo peyamên MT yên hatine şandin, raporên radestkirina peyama SMS an agahdariya radestkirinê bixwaze. Van raporên di Operator SMSC de têne destnîşan kirin dema ku peyama MT an ji Xerîdarê armanckirî re tê radest kirin an jêbirin, mînakî, qediya an, ji ber hin sedeman, ne rêkûpêk e.
Tenê statûya dawî ya peyama SMS ji Pêşkêşkarê Karûbar re tê ragihandin, ango, tê şandin an jêbirin. Ji her peyamek MT tenê yek rapor tê çêkirin. Digel statûya jêbirin, dibe ku kodek sedem were sepandin. Ev koda sedemê sedema neşandina peyama SMS diyar dike.
Rapor ji hêla LINK Mobility ve têne rêve kirin û bi karanîna protokola HTTP ji Pêşkêşkarê Karûbarê re têne şandin.
Ji bo wergirtina raporan, Pêşkêşkarê Karûbar pêdivî ye ku ji bo berê bicîh bikeample Java Servlet an rûpelek ASP.NET. Herdu jî daxwazên HTTP GET an POST distînin.
Parametreyên
Serlêdan pîvanên jêrîn pêk tîne:
| Parametre | Awa | M/O/I* | Nirxa Bingehîn | Dirêjahiya herî zêde | Terîf |
| MessageId | ben | M | – | 22 | Nasnameya peyama peyama MT ku ev rapor pê re têkildar e. |
| DestinationAddress | ben | M | – | 40 | MSISDN ya Serfkaran, ango navnîşana mebesta peyama MT ya orîjînal. |
| StatusCode | yekjimar | M | 1 | Koda statûyê rewşa peyama MT nîşan dide. Kodên rewşa sepandin ev in: 0 – Hate şandin 2 - Hat jêbirin (kodê sedemê derbas dibe) |
|
| TimeStamp | ben | M | – | 20 | Dem destnîşan dike ka kengê rapora radestkirinê ji hêla LINK Mobility ve hatî wergirtin. Qada demjimêrê ya demjimêramp CET an CEST e (bi dema havînê ya ku ji bo YE-yê hatî destnîşan kirin). Format: yyyyMMdd HH:mm:ss. |
| Makînevan | ben | M | – | 100 | Navê Operatorê ku dema şandina peyama SMS-ê tê bikar anîn an navê hesabê ku dema şandina peyama SMS-ê tê bikar anîn. Lîsteya Operatorên berdest ji hêla piştgiriya LINK Mobility ve têne peyda kirin. |
| ReasonCode | yekjimar | O | – | 3 | Koda sedemê destnîşan dike ka çima peyam di statûya jêbirin de bi dawî bû. Kodên sedema sepandin ev in: 100 – Bi dawî bûye 101 – Redkirin 102 - Çewtiya formatê 103 - Çewtiyek din 110 – Abonet nenas 111 – Abonet qedexe kirin 112 – Abonet nayê peyda kirin 113 – Abonet peyda nabe 120 - têkçûna SMSC 121 - Girtina SMSC 122 - SMSC roaming 130 - Çewtiya destikê 131 - Bîra destikê zêde bû Dibe ku tevger bi entegrasyonên Operatorê re diguhere. |
| OperatorTimeStamp | ben | O | – | 20 | Dem destnîşan dike ka kengê rapor di SMSC-ya Operatorê de hatî destpêkirin (heke ji hêla Operator ve hatî peyda kirin). Qada demjimêrê ya demjimêramp CET an CEST e (bi dema havînê ya ku ji bo YE-yê hatî destnîşan kirin). Format: yyyyMMdd HH:mm:ss. |
| StatusText | ben | O | – | 255 | Cîhê ji bo agahdariya zêde ji Operatorê, wek mînak danasîna nivîsa zelal a statûyê/sedemê. Dibe ku tevger bi entegrasyonên Operatorê re diguhere. |
| CorrelationId | ben | O | – | 100 | Nasnameya pêwendiyê ku di SendRequest an SendTextRequest de hatî peyda kirin. |
| OperatorNetworkCode | yekjimar | O | – | 6 | Koda Tora Mobîl (MCC + MNC) ya Operator. |
* M = Mecburî, O = Bijarte, Ez = Paşguhkirin.
Pêdivî ye ku Pêşkêşvanê Karûbarê LINK Mobility bi armancê re peyda bike URL ji bo raporên radestkirinê (bi vebijarkî pêbaweriyên ji bo pejirandina bingehîn a HTTP jî tê de). Pêşkêşkarê Karûbar dikare hilbijêre ku kîjan rêbazê HTTP bijare bikar bîne:
HTTP POST (pêşniyar kirin)
HTTP GET.
Exampbi karanîna HTTP GET (bi serfirazî hate radest kirin):
https://user:password@www.serviceprovider.com/receivereport?%20MessageId=122&DestinationAddress=46762050312&Operator=Vodafone&TimeStamp=20100401%2007%3A47%3A44&StatusCode=0
ExampHTTP GET bikar tîne (ne radestkirî, Operator demjimêr peyda kiriyeamp ji bo bûyerê):
Parametre ne URL encodedi.
Şîfrekirina karakterê:
Pêşkêşkarê karûbarê dikare hilbijêre ku kîjan şîfrekirina karaktera bijarte bikar bîne:
UTF-8 (pêşniyar kirin)
ISO-8859-1.
9.1 Pejirandina Pêşkêşvanê Karûbar
Divê Pêşkêşkarê Karûbar her raporta radestkirinê qebûl bike. Pejirandin dikare erênî be, ango rapora radestkirinê bi serketî hatiye wergirtin, an neyînî, ango têkçûn be.
Ji kerema xwe not: LINK Mobility ji bo raporên radestkirinê 30 çirkeyên pejirandinê demek xwendinê heye. Demjimêrek dê ji nû ve ceribandina radestkirinê (heke ji nû ve ceribandinê çalak be) an betalkirina radestkirinê (heke ji nû ve ceribandinê neçalak bike) bike. Ev tê vê wateyê ku serîlêdana Pêşkêşkarê Karûbar divê demên bersivdana bilez, nemaze di dema barkirina bilind de, peyda bike.
Pir tê pêşniyar kirin ku hûn raporta radestkirinê ber bi LINK Mobility ve berî ku hûn pêve bikin qebûl bikin.
Rêzika pejirandina erênî û neyînî bi vî rengî tête diyar kirin:
Pejirandina erênî, ACK, raporê radestkirî:
Koda bersivê ya rêza HTTP 200 digel naveroka formatkirî ya XML ya jêrîn:
Pejirandina negatîf, NAK, rapora radestkirinê nehat şandin:
Her bersivek ji bilî pejirandina erênî, ji bo nimûneampLe, pejirandinek neyînî ji hêla kodek xeletiya HTTP an naveroka XML ya jêrîn ve tê rêve kirin:
Naveroka XML dikare ji bo kontrolkirina mekanîzmaya dubare ceribandina LINK Mobility were bikar anîn. Ger çalak be, NAK dê bibe sedema hewldana dubare. Ji bo Pêşkêşkerên Karûbarên ku ji bo mekanîzmaya dubare ceribandinê nehatine mîheng kirin, naveroka XML vebijarkî ye.
Li jêr daxwazek û bersivek HTTP POST heyeampraporek radestkirinê ku ji Pêşkêşkarek Karûbar re hatî şandin:
Daxwaza HTTP:
POST /context/app HTTP/1.1
Type-naverok: sepandin / x-www-form-urlencoded;charset=utf-8
Mêvandar: server: port
Naverok-Drêjahî: xx
MessageId=213123213&DestinationAddress=46762050312&Operator=Telia& OperatorTimeStamp=20130607%2010%3A45%3A00&TimeStamp=20130607%2010%3A 45%3A02&StatusCode=0
Bersiva HTTP:
HTTP/1.1 200 OK
Naverok-Tîp: nivîs / sade
9.2 Ji nû ve biceribîne
Pergala LINK Mobility dikare ji bo radestkirina raporên radestkirina têkçûyî, ango ne pejirandî, ceribandinên dubare bike. Pêşkêşkarê karûbarê dikare tevgera dubare ceribandina bijare hilbijêre:
Ji nû ve ceribandin tune (pêşniyaz) - heke hewildana pêwendiyê têk neçe, dema xwendinê an ji bo kodek xeletiyek HTTP-ê dê peyam were avêtin.
Ji nû ve biceribîne - Dê peyam ji bo her cûre pirsgirêka pêwendiyê, dema xwendinê, an pejirandina neyînî were şandin.
Gava ku ji nû ve ceribandina NAK-ê çalak e, girîng e ku meriv fêm bike ka kîjan senaryoyên ku dê ji nû ve ceribandinê ji Mobility LINK çêbikin û ceribandin çawa dixebite. Her Pêşkêşkarek Karûbar xwedan rêzika xweya ji nû ve ceribandinê ye, ku li wir peyam li gorî demjimêra peyamê têne rêz kirinamp. Tevgera Girêdanê her gav hewl dide ku pêşî peyamên kevintir bide, her çend rêza kesane ya peyamên ku ji Pêşkêşkarê Karûbarê re têne şandin jî ne garantî ye. Sedema sereke ya ku peyamên ji rêza dubare ceribandinê têne avêtin yek ji du sedeman e: an peyama TTL diqede an (bi teorîkî) rêza dubare ceribandinê tije dibe. TTL bi Operatorê ve girêdayî ye û bi hesabê ve girêdayî ye, ango, dikare li gorî Operator û an celebê peyamê biguhere, mînakî, SMS-ya premium an peyama SMS-a rêjeya standard.
Pêşkêşkerek karûbarê ku ji nû ve ceribandinê çalak e, divê nasnameya yekta ya peyama MT-ê kontrol bikin da ku ewleh bikin ku peyam jixwe nehatiye wergirtin.
Girîng e ku Pêşkêşkar van qaîdeyên hêsan bicîh bîne dema ku xeletiyek di dema amadekirina raporek radestkirinê de çêdibe heke sedema xeletiyê ev be: Demkî, mînak databas tune, divê NAK were vegerandin. LINK Mobility dê peyamê ji nû ve bişîne.
Hewldanek daîmî û ji nû ve dibe ku bibe sedema heman pirsgirêkê, divê ACK were vegerandin. Ji bo example, dema ku peyam nekare rast were pars kirin an jî bibe sedema xeletiyek dema xebitandinê ya nediyar.
Li gorî vê yekê tevbigerin dê piştrast bike ku ji ber ku raporek radest çend caran tê şandin, tu astengkirin an xirabûna rêwiyan çênebe.
10. Serişteyên pêkanînê
1. Ev gengaz e ku hûn bikar bînin web gerok ku daxwaznameyên API-ê bişînin. Bi vê yekê vekolîn û nirxandina karûbaran bêyî amûrên pêşkeftinê pir hêsan dike.
2. Chrome an Firefox bi pêvekek wekî JSON re têne pêşniyar kirinView da ku JSON-a xweşik-formatkirî nîşan bide.
3. Me SoapUI ji bo ceribandina POST, Nasnameya Bingehîn û ji bo vekolîna daxwaz û peyamên bersivê yên xav HTTP bikar aniye.
4. The cURL amûr ji bo şandina daxwazên POST-ê bi Rastkirina Bingehîn re bikêr e. Binêre exampli jêr.
curl POST \
-H "Cîpa-Naverok: Serlêdan/x-www-form-urlkodkirî" \
-H "Rayedarkirin: Bingehîn am9objpjaGFuZ2VtZSA=" \
https://europe.ipx.com/restapi/v1/sms/send \
–daneyên “destinationAddress=46123456789&messageText=Silav+Cîhan%21”
_________________
Veguherîna Têkiliyên Kesane
Belge / Çavkanî
 |
LINK Rêbernameya Pêkanîna Mobility REST API SMS [pdf] Rehbera bikaranînê Rêbernameya Pêkanîna Mobility REST API SMS, Mobility, Rêbernameya Pêkanînê REST API SMS, REST API SMS, API SMS, SMS |
