RÁNṢẸ Itọsọna imuse arinbo REST API SMS
Ilọsiwaju LINK n pese iṣẹ kan fun ifijiṣẹ ifiranṣẹ, awọn sisanwo micro, ati awọn iṣẹ orisun ipo. Syeed n ṣiṣẹ bi ṣiṣafihan, akopa akoonu aami-funfun ati olulana idunadura laarin Awọn olupese Iṣẹ ati Awọn oniṣẹ.
LINK Mobility n pese API RESTful ti o le ṣee lo lati wọle si awọn iṣẹ arinbo LINK gẹgẹbi fifiranṣẹ SMS. API yii jẹ apẹrẹ lati rọrun lati lo ati ibaramu pẹlu gbogbo awọn ede igbalode ati awọn ilana. Lilo ede ti o fẹ ohun elo rẹ le lo Ọna asopọ Mobility REST API lati ṣe fifiranšẹ ti o lagbara ati awọn agbara isanwo ṣiṣẹ
© RÁNṢẸ arinbo, Oṣù 10, 2021
Ofin Alaye
Alaye ti o wa ninu iwe yii jẹ ohun-ini nikan ati aṣẹ lori ara ti Netsize. O jẹ asiri ati ipinnu fun lilo alaye to muna. Ko ṣe abuda ati pe o le jẹ koko ọrọ si awọn ayipada laisi akiyesi. Eyikeyi ifihan laigba aṣẹ tabi lilo ni ao gba bi arufin.
Netsize™ ati linkmobility™ jẹ aabo nipasẹ Faranse, EEC ati awọn ofin ohun-ini ọgbọn kariaye.
Gbogbo awọn aami-išowo miiran ti a sọ ni ohun-ini ti awọn oniwun wọn.
Ko si ohun ti o wa ninu rẹ yoo tumọ bi fifun eyikeyi iwe-aṣẹ tabi ẹtọ labẹ itọsi Netsize, aṣẹ-lori tabi aami-iṣowo.
NETSIZE
Société anonyme au olu de 5 478 070 yuroopu
Siège awujo: 62, ona Emile Zola92100 Boulogne – France
418 712 477 RCS Nanterre
http://www.LinkMobility.com
http://www.linkmobility.com
Dopin ti Iwe
Iwe yii ṣe apejuwe bi Olupese Iṣẹ ṣe nlo LINK Mobility REST API fun SMS. O jẹ ipinnu fun awọn ayaworan imọ-ẹrọ ati awọn apẹẹrẹ ti o ṣe awọn iṣẹ ti Olupese Iṣẹ.
1. Ipilẹ Lilo
O rọrun pupọ lati firanṣẹ SMS kan. O fi ibeere HTTP ranṣẹ si RÁNṢẸ Iṣipopada eyiti o le ṣe aṣeyọri ni lilo kan web kiri ayelujara.
2. Iṣẹ-ṣiṣe Loriview
Eto iṣipopada LINK n pese iṣẹ ṣiṣe ipilẹ atẹle fun awọn ifiranṣẹ SMS:
Fifiranṣẹ Alagbeka Ti pari (MT) awọn ifiranṣẹ SMS, gẹgẹbi ọrọ tabi alakomeji (fun apẹẹrẹ WAP Push) Ere ati awọn ifiranṣẹ oṣuwọn boṣewa.
Ngba awọn ijabọ ifijiṣẹ fun awọn ifiranṣẹ MT ti a fi silẹ.
Gbigba Awọn ifiranṣẹ SMS ti ipilẹṣẹ (MO) Alagbeka, Ere ati oṣuwọn boṣewa.
SMS REST API jẹ igbẹhin si fifiranṣẹ oṣuwọn boṣewa MT SMS awọn ifiranṣẹ.
API rán gbogbo awọn ifiranšẹ SMS ranṣẹ ni aiṣiṣẹpọ, ṣiṣe awọn ẹya bii:
"Ina-ati-gbagbe" - Olupese Iṣẹ nfẹ lati ni awọn akoko idahun asọtẹlẹ diẹ sii ati pe ko fẹ lati duro fun abajade lati ọdọ oniṣẹ.
Tun iṣẹ ṣiṣe gbiyanju – LINK Aarin yoo tun fi ifiranṣẹ ranṣẹ ti oniṣẹ ba ni awọn iṣoro igba diẹ.
2.1 Fifiranṣẹ SMS kan
Olupese Nẹtiwọki onibara
- Firanṣẹ MT ifiranṣẹ
- Da ID ifiranṣẹ pada
- Fi SMS ranṣẹ
- Fi iroyin ifijiṣẹ
- Fi ijabọ ifijiṣẹ ranṣẹ
Sisan ipilẹ fun fifiranṣẹ awọn ifiranṣẹ SMS jẹ apejuwe bi atẹle:
Olupese Iṣẹ n beere lati fi ifiranṣẹ SMS ranṣẹ si olugba nipasẹ ọna ẹrọ Iṣipopada LINK.
A pada ID ifiranṣẹ si Olupese Iṣẹ. ID yii le ṣee lo fun apẹẹrẹ mu ifiranṣẹ naa pọ pẹlu ijabọ ifijiṣẹ to pe.
RÁNṢẸ arinbo n ṣakoso ipa-ọna ati jiṣẹ ifiranṣẹ SMS si Olumulo ti a koju.
Ijabọ ifijiṣẹ kan nfa, fun apẹẹrẹ nigbati ifiranṣẹ SMS ba ti jiṣẹ si ẹrọ alabara.
Iroyin ifijiṣẹ naa ni a firanṣẹ si Olupese Iṣẹ. Ijabọ naa ni ID ifiranṣẹ kanna ni bi a ti da pada ni igbese 2.
Sisan omiran: Ibere ti ko tọ
Ti awọn paramita ti a pese tabi awọn iwe-ẹri olumulo ninu ibeere naa jẹ aiṣedeede aṣiṣe yoo pada si Olupese Iṣẹ. Aṣiṣe tọkasi idi fun ijusile ati sisan pari. Ko si awọn ID ifiranṣẹ ti a da pada.
3. Ipari
Awọn orisun SMS ti wọle nipa lilo ọna:
/restapi/v1/sms
Example URL
https://europe.ipx.com/restapi/v1/sms
Fun aabo asopọ LINK Mobility REST API jẹ wiwọle nikan lori HTTPS.
Ijẹrisi olupin Iṣipopada Ọna asopọ jẹ fowo si nipasẹ Thawte Server CA.
4. Awọn isẹ
Iṣẹ SMS pese awọn iṣẹ wọnyi:
| Oruko | Ona |
| Firanṣẹ | /restapi/v1/sms/firanṣẹ |
4.1 Firanṣẹ
Iṣẹ fifiranṣẹ jẹ lilo lati fi SMS ranṣẹ si olugba kan.
Iṣiṣẹ yii jẹ ipinnu fun ipilẹ mejeeji ati awọn olumulo ti ilọsiwaju. Ninu ọran ti o rọrun julọ, adirẹsi ibi nikan, ati ọrọ ifiranṣẹ ni a nilo lati fi SMS ranṣẹ. Iṣipopada LINK yoo rii Ero Ifaminsi Data ati ṣe isomọ aifọwọyi ti ifiranṣẹ kan sinu awọn apakan ifiranṣẹ lọpọlọpọ ti o ba jẹ dandan.
Fun lilo ilọsiwaju, Olupese Iṣẹ le lo awọn paramita iyan fun iṣakoso lapapọ ti ọna kika ifiranṣẹ pẹlu akọsori data olumulo.
Olupese Iṣẹ le firanṣẹ awọn ifiranšẹ ti o ni asopọ, ṣugbọn igbaradi ti data olumulo ati akọsori data olumulo gbọdọ jẹ nipasẹ Olupese Iṣẹ ati pe ifiranṣẹ naa gbọdọ wa ni fifiranṣẹ nipasẹ awọn ibeere fifiranṣẹ lọpọlọpọ si ọna Iṣipopada LINK.
5. Ijeri
Orukọ olumulo ati ọrọ igbaniwọle ni a fi silẹ ni gbogbo ibeere nipa lilo Eto Ijeri Ipilẹ HTTP.
https://www.w3.org/Protocols/HTTP/1.0/spec.html#BasicAA
Awọn iwe-ẹri ni a firanṣẹ ni akọsori Aṣẹ ni ibeere HTTP. Onibara kọ aaye akọsori bi a ti ṣalaye nibi:
https://en.wikipedia.org/wiki/Basic_access_authentication#Client_side
Fun example, ti orukọ olumulo ba jẹ john ati changeme jẹ ọrọ igbaniwọle lẹhinna akọle Aṣẹ ti o yọrisi jẹ:
Aṣẹ: Am9objpjaGFuZ2VtZSA ipilẹ
Bi awọn kan isubu-pada awọn orukọ olumulo ati ọrọigbaniwọle le wa ni silẹ bi ìbéèrè sile. Eyi ni iṣeduro nikan fun awọn alabara ti ko ṣe atilẹyin Ipilẹ Ipilẹṣẹ.
6. Ifakalẹ a ìbéèrè
6.1 Okun ìbéèrè
Awọn paramita ibeere ni a fi silẹ bi okun ibeere ti o ni orukọ/awọn orisii iye ninu. Okun ibeere ti wa ni koodu nipa lilo fifi koodu ogorun (URL fifi koodu).
http://www.w3schools.com/tags/ref_urlencode.asp
Fun example, Hello World! ti wa ni koodu bi Hello+Agbaye%21.
6.2 dandan ìbéèrè sile
| Oruko | Ipari to pọju | Apejuwe |
| nloAdirẹsi | 40 | MSISDN ti o yẹ ki o fi ifiranṣẹ SMS ranṣẹ si, bẹrẹ pẹlu koodu orilẹ-ede. Example: 46123456789. Fun diẹ ninu awọn ọja (nibiti Olumulo MSISDN gbọdọ jẹ obfuscated) iye yii tun le jẹ inagijẹ alphanumeric, ti iṣaaju pẹlu “#”. |
| Ifọrọranṣẹ | 1600 | Awọn akoonu ifiranṣẹ SMS. |
6.3 Awọn aye ibeere iyan (fun lilo ilọsiwaju)
| Oruko | Ipari to pọju | Apejuwe |
| atilẹbaAdirẹsi | 16 | Adirẹsi ti ipilẹṣẹ fun ifiranṣẹ SMS ti njade. Iru adirẹsi ti ipilẹṣẹ jẹ asọye nipasẹ paramita originatorTON. Nọmba kukuru ti o pọju gigun jẹ 16. Olufi nọmba Alfa ni opin si GSM aiyipada Alphabet pẹlu ipari gigun 11 ohun kikọ. Olufiranṣẹ MSISDN max gigun jẹ 15 (lilo ọna kika kanna gẹgẹbi anoAdirẹsi ibi). O le yọkuro nigbati ipilẹṣẹAdirẹsi ati ipilẹṣẹTON jẹ yiyan nipasẹ eto naa. Iṣẹ yii jẹ ọja ati iṣeto ni igbẹkẹle. Iwa le yatọ pẹlu awọn iṣọpọ Onišẹ. |
| olupilẹṣẹTON | 1 | Adirẹsi ti ipilẹṣẹ' iru nọmba (TON): 0 - Nọmba kukuru 1 – Nọmba Alpha (ipari 11 ti o pọju) 2 – MSISDN O le yọkuro nigbati ipilẹṣẹAdirẹsi ati ipilẹṣẹTON yoo jẹ yiyan nipasẹ eto naa. Iṣẹ yii jẹ ọja ati igbẹkẹle iṣeto ni. Iwa le yatọ pẹlu awọn iṣọpọ Onišẹ. |
| olumuloDataHeader | 280 | Akọsori Data Olumulo pẹlu Data Olumulo le ni to 140, ie 280 nigbati hex-encoded, octets. Paramita yii jẹ koodu hex nigbagbogbo. |
| DCS | 3 | Ilana ifaminsi data. Iwa le yatọ pẹlu awọn iṣọpọ Onišẹ. |
| PID | 3 | ID Ilana. Iwa le yatọ pẹlu awọn iṣọpọ Onišẹ. |
| ojulumoValidityTime | 6 | Ojulumo Wiwulo akoko ni aaya (ojulumo si akoko fun ifakalẹ si RÁNṢẸ arinbo). Iwọn to pọju jẹ 604800 (ọjọ 7) ati aiyipada jẹ awọn wakati 48. Iwa le yatọ pẹlu awọn iṣọpọ Onišẹ. |
| akoko Ifijiṣẹ | 20 | Akokoamp nigbati ifiranṣẹ SMS yẹ ki o fi jiṣẹ (akoko ifijiṣẹ idaduro). Wo apakan lori ọna kika akoko ọjọ. |
| statusReportFlags | 1 | Pese ibeere ijabọ: 0 - Ko si ijabọ ifijiṣẹ (aiyipada) 1 - Iroyin ifijiṣẹ ti a beere 9 - Iroyin ifijiṣẹ olupin ti a beere (Iṣipopada RÁNṢẸ ko ṣe firanṣẹ ijabọ naa si Olupese Iṣẹ ṣugbọn jẹ ki o wa ni awọn ijabọ ati bẹbẹ lọ) |
| campaignname | 50 | Awọn iṣowo arinbo RÁNṢẸ tagged pẹlu orukọ yi. O ti wa ni lilo lati ṣe akojọpọ awọn iṣowo ni awọn ijabọ Iṣipopada Ọna asopọ. |
| maxConcatenatedMessages | 1 | A iye laarin 1 ati 10 eyi ti o asọye bi ọpọlọpọ awọn concatenated awọn ifiranṣẹ ti o ti wa ni laaye. Aiyipada jẹ 3. |
| correlationId | 100 | ID ti a pese nipasẹ Olupese Iṣẹ ti yoo jẹ atunwi ni Iroyin Ifijiṣẹ. |
| orukọ olumulo | 100 | Pese bi yiyan si HTTP Ijeri Ipilẹ. |
| ọrọigbaniwọle | 100 | Pese bi yiyan si HTTP Ijeri Ipilẹ. |
6.4 HTTP Awọn ọna ìbéèrè
Fun ibaraenisepo ti o pọju, API ṣe atilẹyin mejeeji HTTP GET ati awọn ọna ibeere POST. Ko si awọn ọna HTTP miiran ti o gba laaye.
6.4.1 Gba
Okun ibeere ti a fi koodu pamọ si URL.
GBA
https://europe.ipx.com/restapi/v1/sms/send?destinationAddress=461234
56789&messageText=Hello+Agbaye%21
Aṣẹ: Am9objpjaGFuZ2VtZSA ipilẹ
6.4.2 Ifiweranṣẹ
Okun ibeere ti a fi koodu sii ti wa ni ifisilẹ ninu ẹgbẹ ifiranse HTTP. Akoonu-Iru jẹ ohun elo/x-www-fọọmu-urlkooduopo.
POST https://europe.ipx.com/restapi/v1/sms/send
Alejo: europe.ipx.com
Akoonu-Iru: ohun elo / x-www-form-urlkooduopo
Aṣẹ: Am9objpjaGFuZ2VtZSA ipilẹ
Akoonu-Ipari: 57
nloAddress=46123456789&messageText=Hello+Agbaye%21
6.5 Ọjọ ati akoko
Awọn paramita inu API REST ti o nsoju ọjọ ati aago wa nigbagbogbo ni agbegbe aago UTC (Aago Iṣọkan Gbogbo agbaye). Àkókòamps jẹ aṣoju bi okun pẹlu ọna kika gangan yii:
2017-04-25T23:20:50Z
Eyi duro fun iṣẹju 20 ati iṣẹju-aaya 50 lẹhin wakati 23rd ti Kẹrin 25th, 2017 ni UTC.
7. Ifiranṣẹ idahun
Lẹhin gbigba ati itumọ ifiranṣẹ ibeere kan API ṣe idahun pẹlu ifiranṣẹ esi HTTP kan.
7.1 HTTP koodu ipo
API REST nigbagbogbo n da koodu ipo HTTP pada 200 O dara fun awọn ibeere ti a ṣe ilana. Ara ifiranṣẹ ni koodu idahun paramita kan ti o lo lati pinnu abajade gangan.
7.2 Ara ifiranṣẹ
Ara ifiranṣẹ naa ni JSON ti n ṣapejuwe abajade ti ibeere naa.
http://json.org/
Ọna asopọ Mobility JSON ni ibamu pẹlu Itọsọna Ara Google JSON.
https://google.github.io/styleguide/jsoncstyleguide.xml
7.3 Idahun sile
| Oruko | Ipari to pọju | Apejuwe |
| koodu idahun | 3 | 0 tọkasi idunadura aṣeyọri. |
| Ifọrọranṣẹ idahun | 255 | Apejuwe ọrọ idahun, fun apẹẹrẹ ọrọ aṣiṣe. |
| igbaamp | 20 | Ọjọ & akoko nigbati LINK Mobility ṣe ilana ibeere naa. (Tọkasi si apakan ọna kika ọjọ/akoko). |
| traceId | 36 | Ọna asopọ Mobility ti abẹnu idamo. Ti a lo fun atilẹyin ati laasigbotitusita. |
| IfiranṣẹIds | 10 x 36 | Opo ti RÁNṢẸ Awọn ID ifiranṣẹ alailẹgbẹ arinbo fun ifiranṣẹ aṣeyọri kọọkan (awọn ID ifiranṣẹ lọpọlọpọ ni a da pada ti ifiranṣẹ naa ba ni idapọ). Omited ni irú ti ikuna. |
7.4 Eksample awọn idahun
Aseyori
HTTP / 1.1 200 O dara
Akoonu-Iru: ohun elo/json
Akoonu-Ipari: 144
Ọjọ: Ọjọbọ, Oṣu Kẹsan 15, ọdun 2016 13:20:31 GMT
{"ResponseCode":0,"Ifiranṣẹ esi":"Aseyori","akokoamp”:”2016-09-15T13:20:31Z”, “traceId”:”f678d30879fd4adc25f2″,”messageIds”:[“1-4850879008”]}
Eyi ni ọna kika JSON kanna fun kika:
{
“koodu idahun":0,
“Ifọrọranṣẹ idahun":"Aseyori",
“igbaamp“:”2016-0915T13:20:31Z”,
“traceId“:”f678d30879fd4adc25f2”,
“IfiranṣẹIds":["1-4850879008"]}
Ikuna
HTTP / 1.1 200 O dara
Akoonu-Iru: ohun elo/json
Akoonu-Ipari: 148
Ọjọ: Ọjọbọ, Oṣu Kẹsan 15, ọdun 2016 13:20:31 GMT
{"ResponseCode":1,"Ifiranṣẹ esi":" Wiwọle ti ko tọ tabi lilo API ti a ko fun ni aṣẹ","akokoamp”:”2016-09-15T13:20:31Z”,”traceId”:”f678d30879fd4adc25f2″}
Aseyori
HTTP / 1.1 200 O dara
Akoonu-Iru: ohun elo/json
Akoonu-Ipari: 144
Ọjọ: Ọjọbọ, Oṣu Kẹsan 15, ọdun 2016 13:20:31 GMT
{"ResponseCode":0,"Ifiranṣẹ esi":"Aseyori","akokoamp”:”2016-09-15T13:20:31Z”, “traceId”:”f678d30879fd4adc25f2″,”messageIds”:[“1-4850879008”]}
Eyi ni ọna kika JSON kanna fun kika:
{
“koodu idahun":0,
“Ifọrọranṣẹ idahun":"Aseyori",
“igbaamp“:”2016-0915T13:20:31Z”,
“traceId“:”f678d30879fd4adc25f2”,
“IfiranṣẹIds":["1-4850879008"]}
Ikuna
HTTP / 1.1 200 O dara
Akoonu-Iru: ohun elo/json
Akoonu-Ipari: 148
Ọjọ: Ọjọbọ, Oṣu Kẹsan 15, ọdun 2016 13:20:31 GMT
{"ResponseCode":1,"Ifiranṣẹ esi":" Wiwọle ti ko tọ tabi lilo API ti a ko fun ni aṣẹ","akokoamp”:”2016-09-15T13:20:31Z”,”traceId”:”f678d30879fd4adc25f2″}
7.5 Awọn koodu idahun
Awọn koodu esi wọnyi le jẹ pada ninu esi fifiranṣẹ:
| Koodu | Ọrọ | Apejuwe |
| 0 | Aseyori | Aṣeyọri ṣiṣe. |
| 1 | Wiwọle ti ko tọ tabi lilo API ti a ko fun ni aṣẹ | Orukọ olumulo ti ko tọ tabi ọrọ igbaniwọle tabi Olupese Iṣẹ ti ni idinamọ nipasẹ LINK Mobility. |
| 2 | Olumulo ti dina mọ nipasẹ Ọna asopọ | Olumulo naa ti dinamọ nipasẹ LINK Mobility. |
| 3 | Isẹ ti ko ba wa ni ipese nipasẹ RÁNṢẸ arinbo | Iṣẹ naa ti dina fun Olupese Iṣẹ. |
| 4 | Olumulo naa jẹ aimọ si Iṣipopada RÁNṢẸ | Olumulo naa jẹ aimọ si Iṣipopada RÁNṢẸ. Tabi ti o ba ti lo inagijẹ ninu ibeere naa; inagijẹ ko ri. |
| 5 | Onibara ti dina iṣẹ yii ni LINK Mobility | Olumulo ti dina iṣẹ yii ni LINK Mobility. |
| 6 | Adirẹsi ti ipilẹṣẹ ko ni atilẹyin | Adirẹsi ti ipilẹṣẹ ko ni atilẹyin. |
| 7 | Adirẹsi ti ipilẹṣẹ Alpha ko ṣe atilẹyin nipasẹ akọọlẹ | Adirẹsi ti ipilẹṣẹ alfa ko ṣe atilẹyin nipasẹ akọọlẹ. |
| 8 | Adirẹsi ti ipilẹṣẹ MSISDN ko ni atilẹyin | Adirẹsi ti ipilẹṣẹ MSISDN ko ni atilẹyin. |
| 9 | GSM gbooro ko ni atilẹyin | GSM gbooro ko ni atilẹyin. |
| 10 | Unicode ko ni atilẹyin | Unicode ko ni atilẹyin. |
| 11 | Iroyin ipo ko ni atilẹyin | Iroyin ipo ko ni atilẹyin. |
| 12 | Agbara ti a beere ko ni atilẹyin | Agbara ti a beere (miiran ju loke) fun fifiranṣẹ ifiranṣẹ ko ni atilẹyin. |
| 13 | Olupese akoonu ti o pọju oṣuwọn fifunni ti kọja | Olupese Iṣẹ naa nfi awọn ifiranṣẹ SMS ranṣẹ si RÁNṢẸ Ilọsiwaju ju. |
| 14 | ID Protocol ko ni atilẹyin nipasẹ akọọlẹ | ID Protocol ko ni atilẹyin. |
| 15 | Ifiranṣẹ ti o pọ ju opin lọ | Nọmba awọn ifiranšẹ isomọ ti kọja nọmba ti o pọju ti o beere. |
| 16 | Ko le ṣe ipa ọna ifiranṣẹ. | Ilọ kiri LINK ko lagbara lati da ọna ifiranṣẹ naa. |
| 17 | Ewọ akoko akoko | Ko gba ọ laaye lati firanṣẹ ni akoko akoko |
| 18 | Iwontunwonsi ti o kere ju lori akọọlẹ olupese iṣẹ | Olupese iṣẹ ti dinamọ nitori iwọntunwọnsi kekere pupọ |
| 50 | Aseyori apa kan | Aṣeyọri apakan nigba fifiranṣẹ ifiranṣẹ SMS si ọpọlọpọ awọn olugba. |
| 99 | Asa | Aṣiṣe Iṣipopada Ọna asopọ miiran, Olubasọrọ RÁNṢẸ atilẹyin arinbo fun alaye diẹ sii. |
| 100 | Adirẹsi opin irin ajo ti ko tọ | Adirẹsi opin irin ajo naa (MSISDN, tabi inagijẹ) ko wulo. |
| 102 | ID ti a tọka si (ti o ni asopọ) ti ko tọ | ID itọkasi ko wulo, boya ID itọkasi ti lo tẹlẹ, ti atijọ tabi aimọ. |
| 103 | Orukọ akọọlẹ ti ko tọ | Orukọ akọọlẹ naa ko wulo. |
| 105 | Awọn data iṣẹ akanṣe ti ko tọ | Data meta iṣẹ ko wulo. |
| 106 | Adirẹsi ipilẹṣẹ ti ko tọ | Adirẹsi ti ipilẹṣẹ ko wulo. |
| 107 | Adirẹsi ipilẹṣẹ alphanumeric ti ko tọ | Adirẹsi alphanumeric ti ipilẹṣẹ ko wulo. |
| 108 | Akoko ti ko wulo | Akoko wiwulo ko wulo. |
| 109 | Akoko ifijiṣẹ ti ko tọ | Akoko ifijiṣẹ ko wulo. |
| 110 | Akoonu ifiranṣẹ ti ko tọ/data olumulo | Data olumulo, ie ifiranṣẹ SMS, ko wulo. |
| 111 | Ifiranṣẹ ti ko tọ | Ifiranṣẹ SMS gigun ko wulo. |
| 112 | Akọsori data olumulo ti ko tọ | Akọsori data olumulo ko wulo. |
| 113 | Eto ifaminsi data ti ko tọ | DCS ko wulo. |
| 114 | ID Ilana ti ko tọ | PID ko wulo. |
| 115 | Awọn asia ijabọ ipo ti ko tọ | Awọn asia ijabọ ipo ko wulo. |
| 116 | TON ti ko tọ | Olupilẹṣẹ TON ko wulo. |
| 117 | Ti ko tọ campaign orukọ | Awọn camporuko aign ko wulo. |
| 120 | Iwọn ailopin ti ko tọ fun nọmba ti o pọ julọ ti awọn ifiranšẹ iṣọpọ | Nọmba ti o pọ julọ ti awọn ifiranšẹ iṣọpọ ko wulo. |
| 121 | Adirẹsi ipilẹṣẹ msisdn ti ko tọ | Adirẹsi ti ipilẹṣẹ MSISDN ko wulo. |
| 122 | ID ibamu ti ko tọ | ID ibamu ko wulo. |
8. Awọn ẹya ara ẹrọ aṣayan
8.1 MSISDN Atunse
Atunse MSISDN jẹ ẹya iyan ti o le mu ṣiṣẹ nipasẹ atilẹyin Ilọpo LINK ti o ba beere.
Ẹya yii yoo ṣe atunṣe awọn adirẹsi ibi-afẹde yoo si ṣe deede wọn si ọna kika E.164 ti o nilo. Ni afikun ti atunṣe ọna kika eto naa le tun ṣe iṣẹ ṣiṣe kan pato ọja gẹgẹbi itumọ awọn nọmba Faranse kariaye lati ṣe atunṣe awọn nọmba DOM-TOM (départements et territoires d'outre-mer) nigbati o ba wulo.
Isalẹ wa ni nọmba kan ti Mofiampawọn atunṣe:
| Ti a fi silẹ Destination adirẹsi | Adirẹsi Ibi Atunse |
| + 46 (0) 702233445 | 46702233445 |
| (0046)72233445 | 46702233445 |
| + 460702233445 | 46702233445 |
| 46 (0)702233445 | 46702233445 |
| 46070-2233445 | 46702233445 |
| 0046702233445 | 46702233445 |
| +46 (0) 702233445aa | 46702233445 |
| 336005199999 | 2626005199999 (Nọmba Faranse tumọ si nọmba DOM-TOM) |
Ni afikun, o ṣee ṣe lati gba awọn nọmba foonu orilẹ-ede laaye fun ọja ti o yan. Nigbati ẹya yii ba ti ṣiṣẹ eyikeyi awọn nọmba ilu okeere fun awọn ọja miiran gbọdọ wa ni fifiranṣẹ pẹlu ami ibẹrẹ '+' lati ṣe iyatọ wọn si ọja ti o yan.
Isalẹ wa ni orisirisi awọn MofiampAwọn atunṣe ti a ṣe nigba lilo Sweden (koodu orilẹ-ede 46) bi ọja aiyipada fun awọn nọmba orilẹ-ede.
| Ti a fi silẹ Destination adirẹsi | Adirẹsi Ibi Atunse |
| 0702233445 | 46702233445 |
| 070-2233 445 | 46702233445 |
| 070.2233.4455 | 46702233445 |
| 460702233445 | 46702233445 |
| + 460702233445 | 46702233445 |
| + 458022334455 | 458022334455 |
| 45802233445 | Ti ko wulo lati igba ti ami '+' ti nsọnu |
Ṣe akiyesi pe MSISDN ti a ṣe atunṣe yoo jẹ lilo nipasẹ LINK Mobility ati pe yoo da pada ninu awọn ijabọ ifijiṣẹ.
Jọwọ kan si LINK Atilẹyin arinbo fun alaye diẹ sii.
8.2 Ohun kikọ Rirọpo
Rirọpo ohun kikọ jẹ ẹya iyan ti o le ṣiṣẹ nipasẹ atilẹyin Iṣipopada LINK ti o ba beere.
Ẹya yii yoo tumọ awọn ohun kikọ alfabeti ti kii ṣe GSM ninu data olumulo (ọrọ SMS) si awọn ohun kikọ GSM deede nigbati a ṣeto DCS si “GSM” (17). Fun example “Seqüência de teste em Português” ni ao tumọ si “Seqüencia de teste em Portugues”.
9. Ifijiṣẹ iroyin
Olupese Iṣẹ le, ti o ba pese, beere awọn ijabọ ifiranšẹ SMS tabi awọn ifitonileti ifijiṣẹ fun awọn ifiranṣẹ MT ti a fi ranṣẹ. Awọn ijabọ wọnyi jẹ okunfa ni SMSC oniṣẹ nigbati ifiranṣẹ MT ba jẹ boya jiṣẹ si Olumulo ti a fojusi tabi paarẹ, fun apẹẹrẹ, pari tabi, fun idi kan, kii ṣe ipa ọna.
Ipo ikẹhin nikan ti ifiranṣẹ SMS ni a royin si Olupese Iṣẹ, ie, jiṣẹ tabi paarẹ. Ijabọ kan ṣoṣo fun ifiranṣẹ MT jẹ ipilẹṣẹ. Pẹlu ipo ti paarẹ, koodu idi le waye. Idi eyi koodu pato idi ti awọn SMS ifiranṣẹ ko wa ni jišẹ.
Awọn ijabọ naa jẹ ipasẹ nipasẹ LINK Mobility ati firanṣẹ si Olupese Iṣẹ nipa lilo ilana HTTP.
Lati gba awọn ijabọ, Olupese Iṣẹ nilo lati ṣe fun example Java Servlet tabi oju-iwe ASP.NET kan. Awọn mejeeji gba HTTP GET tabi awọn ibeere POST.
Awọn paramita
Ibeere naa pẹlu awọn paramita wọnyi:
| Paramita | Iru | M/O/I* | Aiyipada Iye | Ipari to pọju | Apejuwe |
| IfiranṣẹId | okun | M | – | 22 | ID ifiranṣẹ ti ifiranṣẹ MT ti ijabọ yii baamu. |
| Adirẹsi Destination | okun | M | – | 40 | MSISDN Olumulo naa, ie adirẹsi ibi ti ifiranṣẹ MT atilẹba naa. |
| Koodu ipo | odidi | M | 1 | Koodu ipo tọkasi ipo ifiranṣẹ MT naa. Awọn koodu ipo to wulo ni: 0 – Ti firanṣẹ 2 - Paarẹ (koodu idi kan) |
|
| TimeStamp | okun | M | – | 20 | Akoko ti n tọka nigbati ijabọ ifijiṣẹ ti gba nipasẹ LINK Mobility. Awọn agbegbe aago ti awọn igbaamp jẹ CET tabi CEST (pẹlu akoko ooru bi a ti ṣalaye fun EU). Ọna kika: yyyyMMdd HH:mm:ss. |
| Onišẹ | okun | M | – | 100 | Orukọ oniṣẹ ti a lo nigba fifiranṣẹ ifiranṣẹ SMS tabi orukọ akọọlẹ ti a lo nigba fifiranṣẹ ifiranṣẹ SMS naa. Atokọ ti Awọn oniṣẹ ti o wa ni a pese nipasẹ LINK support Mobility. |
| IdiCode | odidi | O | – | 3 | Idi koodu tọkasi idi ti ifiranṣẹ pari soke ni ipo ti paarẹ. Awọn koodu idi to wulo ni: 100 – Ipari 101 – Kọ 102 - Aṣiṣe kika 103 – Miiran aṣiṣe 110 - Alabapin aimọ 111 – Alabapin idinamọ 112 - Alabapin ko pese 113 – Alabapin ko si 120 - SMSC ikuna 121 - SMSC idaduro 122 - SMSC lilọ kiri 130 – Aṣiṣe foonu 131 – Iranti foonu ti kọja Iwa le yatọ pẹlu awọn iṣọpọ Onišẹ. |
| OnišẹTimeStamp | okun | O | – | 20 | Aago ti o nfihan nigbati ijabọ naa jẹ okunfa ni SMSC ti oniṣẹ (ti o ba pese nipasẹ oniṣẹ). Awọn agbegbe aago ti awọn igbaamp jẹ CET tabi CEST (pẹlu akoko ooru bi a ti ṣalaye fun EU). Ọna kika: yyyyMMdd HH:mm:ss. |
| IpoText | okun | O | – | 255 | Ibi ipamọ fun alaye ni afikun lati ọdọ oniṣẹ, fun apẹẹrẹ apejuwe ọrọ ko o ti ipo/idi. Iwa le yatọ pẹlu awọn iṣọpọ Onišẹ. |
| CorrelationId | okun | O | – | 100 | ID ibamu ti a pese ni SendIbeere tabi FiranṣẹTextIbeere. |
| OnišẹNetworkCode | odidi | O | – | 6 | Koodu Nẹtiwọọki Alagbeka (MCC + MNC) ti oniṣẹ. |
* M = Dandan, O = Yiyan, I = Aibikita.
Olupese Iṣẹ ni lati pese Iṣipopada LINK pẹlu ibi-afẹde URL fun awọn ijabọ ifijiṣẹ (iyan pẹlu awọn iwe-ẹri fun ijẹrisi ipilẹ HTTP). Olupese Iṣẹ le yan ọna HTTP ti o fẹ lati lo:
HTTP POST (a ṣe iṣeduro)
HTTP GET.
Example lilo HTTP GET (fijiṣẹ ni aṣeyọri):
https://user:password@www.serviceprovider.com/receivereport?%20MessageId=122&DestinationAddress=46762050312&Operator=Vodafone&TimeStamp=20100401%2007%3A47%3A44&StatusCode=0
Examplilo HTTP GET (kii ṣe jiṣẹ, oniṣẹ ti pese awọn akokoamp fun iṣẹlẹ naa):
Awọn paramita ni o wa URL encodedi.
Iyipada kikọ:
Olupese Iṣẹ le yan eyi ti fifi koodu kikọ silẹ ti o fẹ lati lo:
UTF-8 (a ṣe iṣeduro)
ISO-8859-1.
9.1 Olupese iṣẹ afọwọsi
Olupese Iṣẹ yẹ ki o jẹwọ ijabọ ifijiṣẹ kọọkan. Ijẹwọgba le jẹ rere, ie ijabọ ifijiṣẹ ni aṣeyọri ti gba, tabi odi, ie ikuna.
Jọwọ ṣakiyesi: LINK Mobility ni akoko ipari kika fun awọn ijẹwọ ti awọn aaya 30 fun awọn ijabọ ifijiṣẹ. Ipari akoko kan yoo ṣe okunfa atunṣe ifijiṣẹ (ti o ba tun gbiyanju) tabi ifagile ifijiṣẹ (ti o ba tun gbiyanju alaabo). Eyi tumọ si pe ohun elo Olupese Iṣẹ gbọdọ rii daju awọn akoko idahun ni iyara, paapaa lakoko fifuye giga.
O jẹ iṣeduro gaan lati jẹwọ ijabọ ifijiṣẹ si ọna Ilọsiwaju LINK ṣaaju ṣiṣe rẹ.
Ofin fun idaniloju rere ati odi jẹ apejuwe bi atẹle:
Ijẹwọgba to dara, ACK, ijabọ ifijiṣẹ ti a firanṣẹ:
Koodu idahun ibiti HTTP 200 ni apapọ pẹlu akoonu akoonu XML ti o tẹle:
Ijẹwọgba odi, NAK, ijabọ ifijiṣẹ ko jiṣẹ:
Idahun eyikeyi yatọ si idaniloju idaniloju, fun exampLe, ifitonileti odi jẹ okunfa nipasẹ eyikeyi koodu aṣiṣe HTTP tabi akoonu XML atẹle:
Akoonu XML le ṣee lo fun iṣakoso ọna ṣiṣe atunyanju Iṣipopada RÁNṢẸ. NAK yoo fa igbiyanju igbiyanju, ti o ba ṣiṣẹ. Fun Awọn Olupese Iṣẹ ko tunto fun ẹrọ atunwo, akoonu XML jẹ iyan.
Ni isalẹ ni ibeere HTTP POST ati esi example ti ijabọ ifijiṣẹ ti a firanṣẹ si Olupese Iṣẹ kan:
Ibere HTTP:
POST /context/app HTTP/1.1
Akoonu-Iru: ohun elo / x-www-form-urlencoded;charset=utf-8
Olugbalejo: olupin: ibudo
Akoonu-Ipari: xx
MessageId=213123213&DestinationAddress=46762050312&Operator=Telia&OṣiṣẹTimeStamp=20130607%2010%3A45%3A00&TimeStamp=20130607%2010%3A 45%3A02&StatusCode=0
Idahun HTTP:
HTTP / 1.1 200 O dara
Akoonu-Iru: ọrọ/pele
9.2 Tun gbiyanju
Eto arinbo LINK le ṣe awọn igbiyanju atunda fun ikuna, ie ko jẹwọ, awọn ifijiṣẹ ijabọ ifijiṣẹ. Olupese Iṣẹ le yan ihuwasi tun gbiyanju:
Ko si tun gbiyanju (aiyipada) - ifiranṣẹ naa yoo sọnù ti igbiyanju asopọ ba kuna, akoko ka-to tabi fun eyikeyi koodu aṣiṣe HTTP.
Tun gbiyanju - Ifiranṣẹ naa yoo jẹ resent fun gbogbo iru iṣoro asopọ, akoko ipari kika, tabi ifọwọsi odi.
Nigbati o ba tun gbiyanju fun NAK ti ṣiṣẹ, o ṣe pataki lati ni oye iru awọn oju iṣẹlẹ ti yoo ṣe igbiyanju igbiyanju lati Iṣipopada RÁNṢẸ ati bii atunbi naa ṣe n ṣiṣẹ. Olupese Iṣẹ kọọkan ni isinyi tun gbiyanju tirẹ, nibiti awọn ifiranṣẹ ti paṣẹ ni ibamu si akoko ifiranṣẹ naaamp. Ilọsiwaju Ọna asopọ nigbagbogbo n gbiyanju lati fi awọn ifiranṣẹ agbalagba ranṣẹ ni akọkọ, botilẹjẹpe aṣẹ kọọkan ti awọn ifiranṣẹ ti a firanṣẹ si Olupese Iṣẹ ko ni iṣeduro. Idi akọkọ fun awọn ifiranšẹ ti a da silẹ lati isinyi igbiyanju jẹ ọkan ninu awọn idi meji: boya ifiranṣẹ TTL dopin tabi (ijinlẹ) isinyi igbiyanju yoo kun. TTL jẹ oniṣẹ ati ti o gbẹkẹle akọọlẹ, ie, le yatọ si da lori oniṣẹ ati tabi iru ifiranṣẹ, fun apẹẹrẹ, SMS Ere tabi ifiranṣẹ SMS oṣuwọn boṣewa.
Olupese Iṣẹ pẹlu tun gbiyanju gbọdọ ṣayẹwo ID alailẹgbẹ ti ifiranṣẹ MT lati ni aabo pe ifiranṣẹ ko ti gba tẹlẹ.
O ṣe pataki fun Olupese Iṣẹ lati ni ibamu pẹlu awọn ofin ti o rọrun nigbati aṣiṣe ba waye lakoko sisẹ ijabọ ifijiṣẹ kan ti idi fun aṣiṣe naa ba jẹ: Igba diẹ, fun apẹẹrẹ data data ko si, NAK yẹ ki o pada. RÁNṢẸ Arinrin yoo tun fi ifiranṣẹ ranṣẹ.
Yẹ ati igbiyanju igbiyanju kan le fa iru iṣoro kanna, ACK yẹ ki o pada. Fun example, nigbati ifiranṣẹ ko le ṣe atuntu ni deede tabi fa aṣiṣe asiko asiko airotẹlẹ.
Ṣiṣe ni ibamu yoo rii daju pe ko si idinamọ tabi ibajẹ iṣelọpọ ti o ṣẹlẹ nitori ijabọ ifijiṣẹ ti n binu leralera.
10. Awọn imọran imuse
1. O ṣee ṣe lati lo rẹ web ẹrọ aṣawakiri lati fi awọn ibeere ranṣẹ si API. Eyi jẹ ki o rọrun pupọ lati ṣawari ati ṣe iṣiro awọn iṣẹ laisi awọn irinṣẹ idagbasoke eyikeyi.
2. Chrome tabi Firefox ni a ṣe iṣeduro papọ pẹlu itẹsiwaju bii JSONView lati ṣe afihan ọna kika lẹwa JSON.
3. A ti lo SoapUI fun idanwo POST, Ijeri Ipilẹ ati fun ayewo ibeere HTTP aise ati awọn ifiranṣẹ esi.
4. Awọn cURL ọpa wulo fun fifiranṣẹ awọn ibeere POST pẹlu Ijeri Ipilẹ. Wo example isalẹ.
curl Ifiweranṣẹ \
-H “Iru-Akoonu: ohun elo/x-www-fọọmu-urlni koodu" \
-H "Aṣẹ: Ipilẹ am9objpjaGFuZ2VtZSA=" \
https://europe.ipx.com/restapi/v1/sms/send \
–data “Address destination=46123456789&messageText=Hello+Agbaye%21”
_______________
Iyipada Awọn ibaraẹnisọrọ ti ara ẹni
Awọn iwe aṣẹ / Awọn orisun
 |
RÁNṢẸ Itọsọna imuse arinbo REST API SMS [pdf] Itọsọna olumulo Itọnisọna imuse iṣipopada REST API SMS, Gbigbe, Itọsọna imuse REST API SMS, REST API SMS, API SMS, SMS |
