LINK Jagorar Aiwatar da Motsi REST API SMS
Motsi na LINK yana ba da sabis don isar da saƙo, ƙananan biyan kuɗi, da sabis na tushen wuri. Dandalin yana aiki azaman mai bayyanawa, mai siye abun ciki mai farin-lakabi da na'ura mai ba da hanya tsakanin hanyoyin sadarwa tsakanin Masu Ba da Sabis da Masu aiki.
LINK Motsi yana ba da API RESTful wanda za a iya amfani dashi don samun damar ayyukan LINK Motsi kamar aika SMS. An tsara wannan API ɗin don ya zama mai sauƙin amfani da dacewa da duk harsunan zamani da tsarin aiki. Amfani da yaren da kuka zaɓa aikace-aikacenku na iya amfani da Link Motsi REST API don aiwatar da saƙo mai ƙarfi da damar biyan kuɗi.
© LINK Motsi, Maris 10, 2021
Bayanin Shari'a
Bayanin da aka kawo a cikin wannan takaddar ita ce kawai dukiya da haƙƙin mallaka na Netsize. Sirri ne kuma an yi niyya don takamaiman amfani da bayanai. Ba shi da ɗauri kuma yana iya zama batun canje-canje ba tare da sanarwa ba. Duk wani bayyanawa ko amfani da ba a ba da izini ba za a ɗauke shi a matsayin haramun.
Netsize™ da linkmobility™ ana kiyaye su ta Faransanci, EEC da dokokin mallakar fasaha na duniya.
Duk sauran alamun kasuwanci da aka nakalto mallakin masu su ne kawai.
Babu wani abu da ke ƙunshe a ciki da za a yi la'akari da bayar da kowane lasisi ko hakki a ƙarƙashin ikon Netsize, haƙƙin mallaka, ko alamar kasuwanci.
NETSIZE
Société anonyme au babban birnin kasar de 5 478 070 Yuro
Siège zamantakewa: 62, hanyar Emile Zola92100 Boulogne - Faransa
418 712 477 RCS Nanterre
http://www.LinkMobility.com
http://www.linkmobility.com
Iyakar Takardu
Wannan takaddar tana bayyana yadda Mai Ba da Sabis ke amfani da LINK Motsi REST API don SMS. An yi niyya don masu zane-zane na fasaha da masu zanen kaya waɗanda ke aiwatar da ayyukan Mai Ba da Sabis.
1. Asalin Amfani
Yana da sauƙin aika SMS. Kuna aika buƙatar HTTP zuwa LINK Motsi wanda za'a iya cika ta amfani da kawai web mai bincike.
2. Aiki Overview
Tsarin Motsi na LINK yana ba da mahimman ayyuka masu zuwa don saƙonnin SMS:
Aika Saƙon SMS na Waya Ta Kashe (MT), kamar saƙon rubutu ko binary (misali WAP Push) saƙon ƙima da daidaitattun saƙonni.
Karɓar rahotannin isarwa don saƙonnin MT da aka ƙaddamar.
Karɓar Saƙonnin SMS Masu Asalin Waya (MO), ƙima da daidaitaccen ƙimar.
API ɗin SMS REST an sadaukar dashi don aika daidaitattun saƙon SMS na MT.
API ɗin yana aika duk saƙonnin SMS a daidaita, yana ba da damar fasali kamar:
"Wuta-da-manta" - Mai Ba da Sabis yana so ya sami ƙarin lokutan amsawa mai iya tsinkaya kuma baya so ya jira sakamakon daga Mai aiki.
Sake gwada ayyuka - LINK Motsi zai sake aika saƙon idan Mai aiki yana da matsalolin wucin gadi.
2.1 Aika saƙon SMS
Mai Bayar da Sabis Mai Ciniki Netsize
- Aika saƙon MT
- Maida saƙon ID
- Aika sakon SMS
- Isar da rahoton isarwa
- Aika rahoton isarwa
An siffanta ainihin kwarara don aika saƙonnin SMS kamar haka:
Mai Ba da Sabis yana buƙatar aika saƙon SMS zuwa mai karɓa ta hanyar tsarin Motsi na LINK.
Ana mayar da ID ɗin saƙo zuwa ga Mai Ba da Sabis. Ana iya amfani da wannan ID don misali daidaita saƙon tare da madaidaicin rahoton isarwa.
Motsi na LINK yana sarrafa tuƙi kuma yana isar da saƙon SMS ga abokin ciniki da aka yi magana.
Ana jawo rahoton isarwa, misali lokacin da aka isar da saƙon SMS zuwa na'urar abokin ciniki.
Ana aika rahoton isarwa zuwa ga Mai Ba da Sabis. Rahoton ya ƙunshi ID ɗin saƙo ɗaya kamar yadda aka dawo a mataki na 2.
Madadin kwarara: Buƙatun mara inganci
Idan sigogin da aka kawo ko bayanan mai amfani a cikin buƙatun ba su da inganci ana mayar da kuskure ga Mai Ba da Sabis. Kuskuren yana nuna dalilin ƙin yarda kuma kwararar ta ƙare. Ba a mayar da ID ɗin saƙo ba.
3. Ƙarshen Ƙarshe
Ana samun hanyar SMS ta amfani da hanyar:
/restapi/v1/sms
Example URL
https://europe.ipx.com/restapi/v1/sms
Don tsaron haɗin haɗin yanar gizon LINK Motsi REST API yana samuwa ne kawai akan HTTPS.
Takaddar sabar Motsi ta hanyar haɗin gwiwa ta sami sa hannun Thawte Server CA.
4. Ayyuka
Sabis na SMS yana ba da ayyuka masu zuwa:
| Suna | Hanya |
| Aika | /restapi/v1/sms/send |
4.1 Aika
Ana amfani da aikin aika don aika SMS zuwa mai karɓa ɗaya.
Wannan aikin an yi niyya ne ga masu amfani na asali da na ci gaba. A cikin mafi sauƙi, adireshin wuri kawai, kuma ana buƙatar saƙon saƙon don isar da SMS. Motsi na LINK zai gano Tsarin Coding Data kuma ya aiwatar da haɗa saƙo ta atomatik zuwa sassan saƙo da yawa idan ya cancanta.
Don ci gaba mai amfani, Mai Ba da Sabis na iya amfani da sigogi na zaɓi don jimlar sarrafa tsarin saƙon gami da kan bayanan mai amfani.
Mai Ba da Sabis na iya aika saƙonnin haɗaɗɗiyar, amma shirye-shiryen bayanan mai amfani da kan bayanan mai amfani dole ne mai ba da sabis ya yi kuma dole ne a aika saƙon ta hanyar buƙatun aikawa da yawa zuwa Motsi na LINK.
5. Tabbatarwa
Ana ƙaddamar da sunan mai amfani da kalmar wucewa a cikin kowace buƙata ta amfani da Tsarin Tabbatarwa na HTTP.
https://www.w3.org/Protocols/HTTP/1.0/spec.html#BasicAA
Ana aika takaddun shaida a cikin taken izini a cikin buƙatun HTTP. Abokin ciniki yana gina filin taken kamar yadda aka bayyana anan:
https://en.wikipedia.org/wiki/Basic_access_authentication#Client_side
Don misaliampto, idan sunan mai amfani shine john kuma changeme shine kalmar sirri to sakamakon da aka samu izini shine:
Izini: Basic am9objpjaGFuZ2VtZSA=
A matsayin faɗuwar baya ana iya ƙaddamar da sunan mai amfani da kalmar wucewa azaman sigogin buƙata. Ana ba da shawarar wannan kawai ga abokan ciniki waɗanda ba sa tallafawa Basic Auth.
6. Gabatar da buƙata
6.1 Zaren tambaya
Ana ƙaddamar da sigogin buƙatun azaman igiyar tambaya mai ɗauke da suna/ƙima nau'i-nau'i. An rufaffen kirtan tambaya ta amfani da Rubutun Kashi (Parcent).URL encoding).
http://www.w3schools.com/tags/ref_urlencode.asp
Don misaliample, Hello Duniya! an sanya shi azaman Hello+Duniya%21.
6.2 Ma'aunin buƙatu na wajibi
| Suna | Matsakaicin tsayi | Bayani |
| Adireshin manufa | 40 | MSISDN wanda ya kamata a aika saƙon SMS zuwa gare shi, farawa da lambar ƙasa. ExampSaukewa: 46123456789. Ga wasu kasuwanni (inda dole ne a toshe MSISDN na abokin ciniki) wannan ƙimar kuma na iya zama laƙabi na haruffa, wanda aka riga aka yi da "#". |
| Saƙon rubutu | 1600 | Abun cikin saƙon SMS. |
6.3 Saitunan buƙatun zaɓi (don amfani da ci gaba)
| Suna | Matsakaicin tsayi | Bayani |
| asalinAdress | 16 | Asalin adireshin saƙon SMS mai fita. Nau'in adireshi na asali an bayyana shi ta hanyar ma'auni TON. Shortan lamba max tsayin shine 16. Mai aikawa da lamba Alpha yana iyakance zuwa GSM tsoho Alphabet tare da madaidaicin tsayin haruffa 11. Max tsayin mai aikawa MSISDN shine 15 (amfani da tsari iri ɗaya da ɓangaren adireshin adireshin). Ana iya tsallakewa lokacin da tsarin ke zaɓar asalinAdress da originatingTON. Wannan aikin ya dogara da kasuwa da daidaitawa. Halin na iya bambanta tare da haɗin gwiwar Mai aiki. |
| asalin TON | 1 | Nau'in adireshin asali' nau'in lamba (TON): 0 - Gajeren lamba 1- Alfa lamba (max tsayi 11) 2- MSISDN Za a iya tsallakewa lokacin da tsarin zai zaɓi asalinAdress da originatingTON. Wannan aikin ya dogara da kasuwa da daidaitawa. Halin na iya bambanta tare da haɗin gwiwar Mai aiki. |
| mai amfaniDataHeader | 280 | Babban bayanan mai amfani tare da bayanan mai amfani na iya ƙunsar har zuwa 140, watau 280 lokacin da hex-encoded, octets. Wannan sigar koyaushe tana da hex-encoded. |
| DCS | 3 | Tsarin rikodin bayanai. Halin na iya bambanta tare da haɗin gwiwar Mai aiki. |
| PID | 3 | ID na yarjejeniya. Halin na iya bambanta tare da haɗin gwiwar Mai aiki. |
| dangiValidityTime | 6 | Lokacin ingancin dangi a cikin daƙiƙa (dangane da lokacin ƙaddamarwa zuwa Motsi na LINK). Matsakaicin ƙimar shine 604800 (kwanaki 7) kuma tsoho shine awanni 48. Halin na iya bambanta tare da haɗin gwiwar Mai aiki. |
| Lokacin bayarwa | 20 | Lokaciamp lokacin da ya kamata a isar da saƙon SMS (lokacin isar da jinkiri). Duba sashe akan tsarin kwanan wata. |
| statusReportFlags | 1 | Isar da buƙatar rahoton: 0 - Babu rahoton isarwa (tsoho) 1 - An nemi rahoton isarwa 9 - Rahoton isar da sabar da ake buƙata (Motsin LINK ba ya tura rahoton ga mai ba da sabis amma yana sanya shi cikin rahotanni da sauransu) |
| campsuna | 50 | Kasuwancin Motsi na LINK sune tagged da wannan suna. Ana amfani da shi don haɗa ma'amaloli a cikin rahotannin Motsi na Link. |
| maxConcatenated Saƙonni | 1 | Ƙimar tsakanin 1 zuwa 10 wanda ke bayyana adadin saƙonnin da aka yarda da su. Default shine 3. |
| correlationId | 100 | ID da Mai Bayar da Sabis ya bayar wanda za a sake maimaita shi a cikin Rahoton Bayarwa. |
| sunan mai amfani | 100 | Bayar da azaman madadin HTTP Basic Athentication. |
| kalmar sirri | 100 | Bayar da azaman madadin HTTP Basic Athentication. |
6.4 Hanyoyin Neman HTTP
Don matsakaicin ma'amala, API ɗin yana goyan bayan hanyoyin HTTP GET da POST. Babu wasu hanyoyin HTTP da aka yarda.
6.4.1 SAMU
An haɗa igiyoyin tambaya da aka lulluɓe zuwa ga URL.
SAMU
https://europe.ipx.com/restapi/v1/sms/send?destinationAddress=461234
56789&messageText=Sannu+Duniya%21
Izini: Basic am9objpjaGFuZ2VtZSA=
6.4.2 POST
An ƙaddamar da igiyoyin tambaya da aka ɓoye a cikin jikin saƙon buƙatun HTTP. Nau'in abun ciki shine aikace-aikace/x-www-form-urlshigar.
POST https://europe.ipx.com/restapi/v1/sms/send
Mai watsa shiri: europe.ipx.com
Nau'in-Nau'in: aikace-aikace / x-www-form-urlshigar
Izini: Basic am9objpjaGFuZ2VtZSA=
Tsawon Abun ciki: 57
manufaAdress=46123456789&messageText=Sannu+Duniya%21
6.5 Kwanan wata da lokaci
Ma'auni a cikin REST API masu wakiltar kwanan wata da lokaci koyaushe suna cikin yankin lokacin UTC (Lokacin Haɗin Kan Duniya). Lokaciamps ana wakilta azaman kirtani tare da wannan ainihin tsari:
2017-04-25T23:20:50Z
Wannan yana wakiltar mintuna 20 da sakan 50 bayan awa 23rd na Afrilu 25th, 2017 a UTC.
7. Sakon amsawa
Bayan karɓa da fassara sakon buƙatun API ɗin yana amsawa tare da saƙon amsa HTTP.
7.1 HTTP lambar matsayi
API ɗin REST koyaushe yana mayar da lambar matsayin HTTP 200 OK don buƙatun da aka sarrafa. Jikin saƙon ya ƙunshi lambar amsa ma'auni wanda ake amfani da shi don tantance ainihin sakamakon.
7.2 Jikin saƙo
Ƙungiyar saƙon ta ƙunshi JSON da ke kwatanta sakamakon buƙatar.
http://json.org/
Link Motsi JSON ya dace da Jagorar Salon Google JSON.
https://google.github.io/styleguide/jsoncstyleguide.xml
7.3 Ma'aunin amsawa
| Suna | Matsakaicin tsayi | Bayani |
| Lambar amsawa | 3 | 0 yana nuna nasara ciniki. |
| Saƙon amsawa | 255 | Amsa bayanin rubutu, misali rubutun kuskure. |
| lokutaamp | 20 | Kwanan wata & lokaci lokacin da LINK Motsi ya aiwatar da buƙatar. (Dubi sashin tsarin kwanan wata/lokaci). |
| traceId | 36 | Link Motsi mai ganowa na ciki. Ana amfani da shi don tallafi da magance matsala. |
| sakonIds | 10 x 36 | Tsari na LINK Motsi na musamman ID na saƙo na kowane saƙo mai nasara (ana mayar da ID ɗin saƙo da yawa idan an haɗa saƙon). An tsallake idan an gaza. |
7.4 Fitampda jawabai
Nasara
HTTP/1.1 200 Ok
Nau'in abun ciki: aikace-aikace/json
Tsawon Abun ciki: 144
Rana: Alhamis, 15 ga Satumba, 2016 13:20:31 GMT
{"ResponseCode":0,"ResponseMessage":"Nasara","Lokaciamp”:”2016-09-15T13:20:31Z”, “traceId”:”f678d30879fd4adc25f2″,”messageIds”:[“1-4850879008”]}
Ga JSON iri ɗaya da aka tsara don iya karantawa:
{
"Lambar amsawa":0,
"Saƙon amsawa":"Nasara",
"lokutaamp“:”2016-0915T13:20:31Z”,
"traceId“:”f678d30879fd4adc25f2”,
"sakonIds": ["1-4850879008"]}
Kasawa
HTTP/1.1 200 Ok
Nau'in abun ciki: aikace-aikace/json
Tsawon Abun ciki: 148
Rana: Alhamis, 15 ga Satumba, 2016 13:20:31 GMT
{"ResponseCode":1,"ResponseMessage":" Shiga mara inganci ko amfani da API mara izini","Lokaciamp”:”2016-09-15T13:20:31Z”,”traceId”:”f678d30879fd4adc25f2″}
Nasara
HTTP/1.1 200 Ok
Nau'in abun ciki: aikace-aikace/json
Tsawon Abun ciki: 144
Rana: Alhamis, 15 ga Satumba, 2016 13:20:31 GMT
{"ResponseCode":0,"ResponseMessage":"Nasara","Lokaciamp”:”2016-09-15T13:20:31Z”, “traceId”:”f678d30879fd4adc25f2″,”messageIds”:[“1-4850879008”]}
Ga JSON iri ɗaya da aka tsara don iya karantawa:
{
"Lambar amsawa":0,
"Saƙon amsawa":"Nasara",
"lokutaamp“:”2016-0915T13:20:31Z”,
"traceId“:”f678d30879fd4adc25f2”,
"sakonIds": ["1-4850879008"]}
Kasawa
HTTP/1.1 200 Ok
Nau'in abun ciki: aikace-aikace/json
Tsawon Abun ciki: 148
Rana: Alhamis, 15 ga Satumba, 2016 13:20:31 GMT
{"ResponseCode":1,"ResponseMessage":" Shiga mara inganci ko amfani da API mara izini","Lokaciamp”:”2016-09-15T13:20:31Z”,”traceId”:”f678d30879fd4adc25f2″}
7.5 Lambobin amsawa
Ana iya dawo da lambobin amsawa masu zuwa a cikin martanin aika:
| Lambar | Rubutu | Bayani |
| 0 | Nasara | An yi nasara cikin nasara |
| 1 | Shiga mara inganci ko amfani da API mara izini | An hana sunan mai amfani ko kalmar sirri ko Mai ba da Sabis ta hanyar Motsi ta LINK. |
| 2 | Link Motsi ya toshe mabukaci | An katange mabukaci ta hanyar LINK Motsi. |
| 3 | Ba a samar da aikin ta hanyar LINK Motsi | An katange aikin don Mai Ba da Sabis. |
| 4 | Ba a san mabukaci ga LINK Motsi ba | LINK Motsin ba a san abokin ciniki ba. Ko kuma idan an yi amfani da laƙabi a cikin buƙatar; ba a samo laƙabi ba. |
| 5 | Mabukaci ya toshe wannan sabis ɗin a cikin LINK Motsi | Abokin ciniki ya toshe wannan sabis ɗin a cikin LINK Motsi. |
| 6 | Ba a tallafawa asalin adireshin | Ba a tallafawa asalin adireshin. |
| 7 | Asalin adireshin Alpha baya samun goyan bayan asusu | Asalin adireshin alfa baya samun tallafi ta asusu. |
| 8 | MSISDN asalin adireshin ba shi da tallafi | Ba a tallafawa asalin adireshin MSISDN. |
| 9 | GSM ya tsawaita baya goyan baya | GSM ya tsawaita baya goyan baya. |
| 10 | Unicode ba ta da tallafi | Unicode ba ta da tallafi. |
| 11 | Ba a tallafawa rahoton matsayi | Ba a tallafawa rahoton matsayi. |
| 12 | Ba a tallafawa iyawar da ake buƙata | Ba a tallafawa ikon da ake buƙata (banda na sama) don aika saƙon. |
| 13 | An ƙetare madaidaicin ƙimar mai bada abun ciki | Mai Ba da Sabis yana aika saƙonnin SMS zuwa LINK Motsi da sauri. |
| 14 | ID na yarjejeniya baya tallafawa ta asusu | Ba a tallafawa ID na yarjejeniya. |
| 15 | An wuce iyakar haɗin saƙo | Adadin saƙon da aka haɗa ya zarce adadin da ake buƙata. |
| 16 | Rashin hanyar saƙo. | Motsin LINK ɗin ya kasa tafiyar da saƙon. |
| 17 | Lokacin da aka haramta | Ba a yarda a aika saƙo a cikin lokacin lokaci ba |
| 18 | Ƙananan ma'auni akan asusun mai bada sabis | An katange mai bada sabis saboda ƙarancin ma'auni |
| 50 | Nasarar sashi | Babban nasara lokacin aika saƙon SMS zuwa masu karɓa da yawa. |
| 99 | Kuskuren na Cikin Saba | Sauran Kuskuren Motsin Hanya, tuntuɓi tallafin Motsi na LINK don ƙarin bayani. |
| 100 | Adireshin makoma mara inganci | Adireshin inda ake nufi (MSISDN, ko kuma wanda aka ce masa) ba shi da inganci. |
| 102 | ID mara inganci (mai alaƙa). | ID ɗin tunani ba shi da inganci, wataƙila an riga an yi amfani da ID ɗin tunani, tsoho ko ba a sani ba. |
| 103 | Sunan asusu mara inganci | Sunan asusun ba shi da inganci. |
| 105 | Bayanan meta na sabis mara inganci | Bayanan meta na sabis ba shi da inganci. |
| 106 | Adireshin asali mara inganci | Asalin adireshin bashi da inganci. |
| 107 | Adireshin asali na haruffa mara inganci | Asalin adireshin haruffa ba daidai bane. |
| 108 | Lokacin aiki mara inganci | Lokacin tabbatarwa ba shi da inganci. |
| 109 | Lokacin isarwa mara inganci | Lokacin isarwa ba shi da inganci. |
| 110 | Saƙo mara inganci/bayanin mai amfani | Bayanan mai amfani, watau saƙon SMS, ba shi da inganci. |
| 111 | Tsawon saƙo mara inganci | Tsawon saƙon SMS ba daidai ba ne. |
| 112 | Maganin bayanan mai amfani mara inganci | Kan bayanan mai amfani ba shi da inganci. |
| 113 | Tsarin coding bayanai mara inganci | DCS bata aiki. |
| 114 | ID na yarjejeniya mara inganci | PID ba daidai ba ne. |
| 115 | Tutocin rahoton matsayi mara inganci | Tutocin rahoton matsayi ba su da inganci. |
| 116 | TON mara inganci | Wanda ya kirkiro TON ba shi da inganci. |
| 117 | Ba daidai ba campaign name | Na campsunan aign ba shi da inganci. |
| 120 | Iyakar mara inganci don iyakar adadin saƙonnin da aka haɗa | Matsakaicin adadin saƙonnin da aka haɗa ba su da inganci. |
| 121 | Adireshin asalin msisdn mara inganci | Asalin adireshin MSISDN ba shi da inganci. |
| 122 | ID na daidaitawa mara inganci | ID ɗin daidaitawa mara inganci. |
8. Siffofin zaɓi
8.1 Gyaran MSISDN
Gyara MSISDN siffa ce ta zaɓi wacce za a iya kunna ta ta hanyar tallafin Motsi na LINK idan an buƙata.
Wannan fasalin zai gyara adiresoshin inda ake nufi kuma ya daidaita su zuwa tsarin E.164 da ake buƙata. Baya ga gyare-gyaren tsari tsarin kuma na iya yin takamaiman ayyuka na kasuwa kamar fassara lambobin Faransanci na duniya don gyara lambobi DOM-TOM (départements et territoires d'outre-mer) idan an zartar.
A ƙasa akwai adadin examples na gyarawa:
| An ƙaddamar da Adireshin Wuta | Adireshin Makomawa Mai Gyara |
| +46 (0) 702233445 | 46702233445 |
| (0046) 72233445 | 46702233445 |
| +460702233445 | 46702233445 |
| 46 (0) 702233445 | 46702233445 |
| 46070-2233445 | 46702233445 |
| 0046702233445 | 46702233445 |
| +46(0)702233445aa | 46702233445 |
| 336005199999 | 2626005199999 (Lambar Faransanci da aka fassara zuwa lambar DOM-TOM) |
Bugu da ƙari, yana yiwuwa a ba da izinin lambobin waya na ƙasa don zaɓaɓɓen kasuwa. Lokacin da aka kunna wannan fasalin kowane lambobi na ƙasashen waje na sauran kasuwanni dole ne a aika tare da alamar '+' ta farko don bambanta su da kasuwa da aka zaɓa.
A ƙasa akwai da yawa examples na gyare-gyaren da aka yi lokacin amfani da Sweden (lambar ƙasa 46) azaman tsohuwar kasuwa don lambobin ƙasa.
| An ƙaddamar da Adireshin Wuta | Adireshin Makomawa Mai Gyara |
| 0702233445 | 46702233445 |
| 070-2233 445 | 46702233445 |
| 070.2233.4455 | 46702233445 |
| 460702233445 | 46702233445 |
| +460702233445 | 46702233445 |
| +458022334455 | 458022334455 |
| 45802233445 | Ba daidai ba tunda alamar '+' ta ɓace |
Lura cewa MSISDN ɗin da aka gyara za a yi amfani da shi ta hanyar Motsi na LINK kuma za a dawo da shi a cikin rahotannin isarwa.
Da fatan za a tuntuɓi tallafin Motsi na LINK don ƙarin bayani.
8.2 Sauya Hali
Maye gurbin haruffa fasalin zaɓi ne wanda za a iya kunna shi ta hanyar tallafin Motsi na LINK idan an buƙata.
Wannan fasalin zai fassara haruffan haruffa waɗanda ba GSM ba a cikin bayanan mai amfani (rubutun SMS) zuwa haruffan haruffan GSM daidai lokacin da aka saita DCS zuwa “GSM” (17). Domin misaliample "Seqüência de teste em Português" za a fassara zuwa "Seqüencia de teste em Portugues".
9. Rahoton isarwa
Mai Ba da Sabis na iya, idan an tanadi, nemi rahotannin isar da saƙon SMS ko sanarwar isar da saƙon MT da aka aika. Ana haifar da waɗannan rahotanni a cikin Operator SMSC lokacin da aka isar da saƙon MT zuwa ga Abokin Ciniki da aka yi niyya ko kuma an share su, misali, ya ƙare ko, saboda wasu dalilai, ba mai sauƙi ba.
Matsayin ƙarshe na saƙon SMS kawai ake ba da rahoto ga Mai Ba da Sabis, watau, isarwa ko sharewa. Rahoto ɗaya ne kawai a kowane saƙon MT aka samar. Tare da matsayin da aka share, ana iya amfani da lambar dalili. Wannan lambar dalili ta ƙayyade dalilin rashin isar da saƙon SMS.
Ana fitar da rahotannin ta hanyar LINK Motsi kuma a aika zuwa Mai Ba da Sabis ta amfani da ka'idar HTTP.
Don karɓar rahotanni, Mai Ba da Sabis yana buƙatar aiwatarwa don exampzuwa Java Servlet ko shafin ASP.NET. Dukansu suna karɓar buƙatun HTTP GET ko POST.
Siga
Buƙatar ta ƙunshi sigogi masu zuwa:
| Siga | Nau'in | M/O/I* | Default Value | Matsakaicin tsayi | Bayani |
| MessageId | kirtani | M | - | 22 | ID ɗin saƙon saƙon MT wanda wannan rahoton yayi daidai da. |
| Adireshin Wuta | kirtani | M | - | 40 | MSISDN na Mabukaci, watau adireshin inda ainihin saƙon MT ya nufa. |
| Lambar matsayi | lamba | M | 1 | Lambar matsayi tana nuna matsayin saƙon MT. Lambobin matsayi masu amfani sune: 0 - An Isar 2 - Share (lambar dalili ya shafi) |
|
| TimeStamp | kirtani | M | - | 20 | Lokaci yana nuna lokacin da LINK Motsi ya karɓi rahoton isarwa. Yankin lokaci na lokutaamp shine CET ko CEST (tare da lokacin bazara kamar yadda aka ayyana don EU). Tsarin: yyyyMMdd HH:mm:ss. |
| Mai aiki | kirtani | M | - | 100 | Sunan Operator da ake amfani dashi lokacin aika saƙon SMS ko sunan asusun da aka yi amfani da shi lokacin aika saƙon SMS. Ana samar da jerin ma'aikatan da ke akwai ta tallafin Motsi na LINK. |
| Dalili Code | lamba | O | - | 3 | Lambar dalili tana nuna dalilin da yasa saƙon ya ƙare a matsayin da aka goge. Lambobin dalilai masu amfani sune: 100 - Ya ƙare 101 - An ƙi 102 - Kuskuren tsari 103 – Wasu kurakurai 110 - Abokin ciniki ba a sani ba 111 - An hana biyan kuɗi 112 - Ba a tanadar masu biyan kuɗi ba 113 - Babu mai biyan kuɗi 120 - gazawar SMSC 121 - SMSC cunkoso 122 - SMSC yawo 130 – Kuskuren wayar hannu 131 – Ƙwaƙwalwar wayar hannu ta wuce Halin na iya bambanta tare da haɗin gwiwar Mai aiki. |
| OperatorTimeStamp | kirtani | O | - | 20 | Lokaci yana nuna lokacin da aka kunna rahoton a cikin SMSC na Mai aiki (idan mai aiki ya bayar). Yankin lokaci na lokutaamp shine CET ko CEST (tare da lokacin bazara kamar yadda aka ayyana don EU). Tsarin: yyyyMMdd HH:mm:ss. |
| Matsayin rubutu | kirtani | O | - | 255 | Mai ɗaukar wuri don ƙarin bayani daga Mai aiki, misali bayyananne bayanin rubutu na matsayi/dalili. Halin na iya bambanta tare da haɗin gwiwar Mai aiki. |
| CorrelationId | kirtani | O | - | 100 | ID ɗin daidaitawa da aka bayar a cikin SendRequest ko AikaTsarinTsarin. |
| Lambar Operator | lamba | O | - | 6 | Lambar hanyar sadarwa ta Wayar hannu (MCC + MNC) na Operator. |
* M = Dole ne, O = Na zaɓi, I = Ban kula.
Dole ne Mai Ba da Sabis ya samar da Motsi na LINK tare da manufa URL don rahotannin isarwa (na zaɓi gami da takaddun shaida don ingantaccen ingantaccen HTTP). Mai Ba da Sabis na iya zaɓar hanyar HTTP da aka fi so don amfani da su:
HTTP POST (an bada shawarar)
HTTP GET.
Exampta amfani da HTTP GET (an isar cikin nasara):
https://user:password@www.serviceprovider.com/receivereport?%20MessageId=122&DestinationAddress=46762050312&Operator=Vodafone&TimeStamp=20100401%2007%3A47%3A44&StatusCode=0
Exampta amfani da HTTP GET (ba a isar da shi ba, Mai aiki ya kawo lokaciamp domin taron):
Siffofin su ne URL encodedi.
Rufin haruffa:
Mai Ba da Sabis na iya zaɓar wanne zaɓin haruffan da ya fi son amfani da shi:
UTF-8 (an bada shawarar)
ISO-8859-1.
9.1 Yarda da Mai Ba da Sabis
Ya kamata Mai Ba da Sabis ya amince da kowane rahoton isarwa. Amincewar na iya zama tabbatacce, watau rahoton isar da aka samu nasara, ko mara kyau, watau gazawa.
Lura: LINK Motsi yana da lokacin karantawa don amincewar daƙiƙa 30 don rahotannin isarwa. Ƙayyadaddun lokaci zai haifar da sake gwadawar isarwa (idan an sake gwadawa) ko sokewar isar (idan an kashe shi). Wannan yana nufin cewa dole ne aikace-aikacen Mai Ba da Sabis ya tabbatar da lokutan amsawa cikin sauri, musamman lokacin babban kaya.
Ana ba da shawarar sosai don amincewa da rahoton isarwa zuwa LINK Motsi kafin sarrafa shi.
An siffanta ka'idar tabbatacce da mara kyau kamar haka:
Kyakkyawan yarda, ACK, rahoton isarwa:
Lambar amsa kewayon HTTP 200 a haɗe tare da tsararrun abun ciki na XML mai zuwa:
Amincewa mara kyau, NAK, ba a isar da rahoton bayarwa ba:
Duk wata amsa ban da tabbataccen yarda, ga misaliampko, rashin yarda yana haifar da kowane lambar kuskuren HTTP ko abun ciki na XML mai zuwa:
Ana iya amfani da abun cikin XML don sarrafa tsarin sake gwada Motsi ta LINK. NAK zai haifar da sake gwadawa, idan an kunna. Ga Masu Ba da Sabis ba a saita don tsarin sake gwadawa ba, abun cikin XML na zaɓi ne.
A ƙasa akwai buƙatar HTTP POST da amsa exampna rahoton isarwa da aka bayar ga Mai Ba da Sabis:
Buƙatar HTTP:
POST /context/app HTTP/1.1
Nau'in-Nau'in: aikace-aikace / x-www-form-urlencoded; charset = utf-8
Mai watsa shiri: uwar garken: tashar jiragen ruwa
Tsawon Abun ciki: xx
MessageId=213123213&DestinationAddress=46762050312&Operator=Telia& OperatorTimeStamp=20130607%2010%3A45%3A00&TimeStamp=20130607%2010%3A 45%3A02&StatusCode=0
Jawabin HTTP:
HTTP/1.1 200 Ok
Nau'in Abun ciki: rubutu/bayani
9.2 Sake gwadawa
Tsarin Motsi na LINK na iya yin ƙoƙarin sake gwadawa don gazawar, watau ba a yarda ba, isar da rahoton isarwa. Mai Ba da Sabis na iya zaɓar halin sake gwadawa da aka fi so:
Babu sake gwadawa (tsoho) - za a watsar da saƙon idan yunƙurin haɗin gwiwa ya gaza, lokacin karantawa ko kowane lambar kuskuren HTTP.
Sake gwadawa - za a aika saƙon don kowane nau'in matsalar haɗin gwiwa, lokacin karantawa, ko rashin yarda.
Lokacin da aka kunna sake gwadawa don NAK, yana da mahimmanci a fahimci wane yanayi ne zai haifar da ƙoƙari na sake gwadawa daga LINK Motsi da yadda sake gwadawa ke aiki. Kowane Mai Ba da Sabis yana da nasa jerin gwano na sake gwadawa, inda ake yin odar saƙonni bisa ga lokutan saƙonamp. Link Motsi koyaushe yana ƙoƙarin isar da tsofaffin saƙonnin farko, duk da cewa kowane tsari na saƙonnin da aka aika zuwa Mai Ba da Sabis ba shi da garantin. Babban dalilin da yasa ake watsar da saƙon daga layin sake gwadawa shine ɗayan dalilai biyu: ko dai saƙon TTL ya ƙare ko kuma (a zahiri) layin sake gwadawa ya cika. TTL Operator ne kuma ya dogara da asusu, watau, na iya bambanta dangane da Mai aiki da nau'in saƙo, misali, SMS mai ƙima ko daidaitaccen saƙon SMS.
Masu ba da Sabis tare da kunna sake gwadawa dole ne su duba keɓaɓɓen ID na saƙon MT don tabbatar da cewa ba a riga an karɓi saƙon ba.
Yana da mahimmanci ga Mai Ba da Sabis ɗin ya bi waɗannan ƙa'idodi masu sauƙi lokacin da kuskure ya faru yayin aiwatar da rahoton isarwa idan dalilin kuskuren shine: Na ɗan lokaci, misali bayanan bayanai, yakamata a dawo da NAK. LINK Motsi zai sake aika saƙon.
Ƙoƙarin dindindin da sake gwadawa na iya haifar da irin wannan matsala, yakamata a mayar da ACK. Domin misaliample, lokacin da ba a iya rarraba saƙon daidai ba ko kuma ya haifar da kuskuren lokacin aiki da ba a zata ba.
Yin aiki yadda ya kamata zai tabbatar da cewa ba a haifar da toshewa ko lalata kayan aiki ba saboda rahoton isar da ake jin haushi akai-akai.
10. Nasihu na aiwatarwa
1. Yana yiwuwa a yi amfani da ku web mai lilo don ƙaddamar da buƙatun zuwa API. Wannan yana sa ya zama sauƙi don bincika da kimanta ayyukan ba tare da wani kayan aikin haɓakawa ba.
2. Ana ba da shawarar Chrome ko Firefox tare da tsawo kamar JSONView don nuna kyakkyawan tsari na JSON.
3. Mun yi amfani da SoapUI don gwada POST, Tabbatarwa na asali da kuma bincika ainihin buƙatar HTTP da saƙonnin amsawa.
4. Na cURL kayan aiki yana da amfani don ƙaddamar da buƙatun POST tare da Tabbatarwa na asali. Duba example kasa.
curl POST \
-H “Nau'in Abun ciki: aikace-aikace/x-www-form-urlencoded" \
-H "Izinin: Basic am9objpjaGFuZ2VtZSA=" \
https://europe.ipx.com/restapi/v1/sms/send \
–data “Address=46123456789&messageText=Hello+Duniya%21”
_______________
Canza Hanyoyin Sadarwa Na Keɓaɓɓen
Takardu / Albarkatu
 |
LINK Jagorar Aiwatar da Motsi REST API SMS [pdf] Jagorar mai amfani Jagorar Aiwatar da Motsi REST API SMS, Motsi, Jagoran Aiwatarwa REST API SMS, REST API SMS, API SMS, SMS |
