د LINK د خوځښت پلي کولو لارښود REST API SMS
LINK حرکت د پیغام رسولو، کوچني تادیاتو، او د موقعیت پر بنسټ خدماتو لپاره خدمت وړاندې کوي. پلیټ فارم د خدماتو چمتو کونکو او آپریټرانو ترمینځ د شفاف ، سپینې لیبل مینځپانګې ترلاسه کونکي او د لیږد روټر په توګه کار کوي.
د لینک خوځښت یو آرام API وړاندې کوي چې د LINK خوځښت خدماتو ته د لاسرسي لپاره کارول کیدی شي لکه د SMS لیږل. دا API ډیزاین شوی ترڅو کارول اسانه وي او د ټولو عصري ژبو او چوکاټونو سره مطابقت ولري. ستاسو د خوښې ژبې په کارولو سره ستاسو غوښتنلیک کولی شي د پیاوړې پیغام رسولو او تادیاتو وړتیاو پلي کولو لپاره د لینک موبلیت REST API وکاروي
© LINK حرکت، د مارچ 10، 2021
حقوقي معلومات
په دې سند کې چمتو شوي معلومات د Netsize یوازینی ملکیت او کاپي حق دی. دا محرم دی او په کلکه د معلوماتو کارولو لپاره ټاکل شوی. دا پابند ندی او ممکن د خبرتیا پرته د بدلونونو تابع وي. هر ډول غیر مجاز افشا کول یا کارول باید غیرقانوني وګڼل شي.
Netsize™ او Linkmobility™ د فرانسوي، EEC او نړیوالو فکري ملکیت قوانینو لخوا خوندي شوي.
نورې ټولې سوداګریزې نښې چې حواله شوي د دوی د اړوندو مالکینو یوازینۍ ملکیت دی.
هیڅ شی چې پدې کې شامل نه وي باید د Netsize پیټینټ، کاپي حق، یا سوداګریزې نښې لاندې کوم جواز یا حق ورکړل شي.
NETSIZE
Société anonyme au capital de 5 478 070 یورو
سیج ټولنیز: 62، ایوینیو ایمیل زولا 92100 بولون - فرانسه
418 712 477 RCS Nanterre
http://www.LinkMobility.com
http://www.linkmobility.com
د سند ساحه
دا سند تشریح کوي چې څنګه د خدماتو چمتو کونکی د SMS لپاره د LINK Mobility REST API کاروي. دا د تخنیکي معمارانو او ډیزاینرانو لپاره دی چې د خدماتو چمتو کونکي خدمات پلي کوي.
1. بنسټیز کارول
د ایس ایم ایس لیږل خورا اسانه دي. تاسو د LINK خوځښت ته د HTTP غوښتنه لیږئ کوم چې یوازې د a په کارولو سره ترسره کیدی شي web براوزر
2. فعال اوورview
د LINK خوځښت سیسټم د SMS پیغامونو لپاره لاندې بنسټیز فعالیت چمتو کوي:
د ګرځنده ټرمینډ شوي (MT) ایس ایم ایس پیغامونه لیږل، لکه متن یا بائنری (د مثال په توګه WAP Push) پریمیم او د معیاري نرخ پیغامونه.
د سپارل شوي MT پیغامونو لپاره د تحویلي راپورونو ترلاسه کول.
د موبایل اصلي (MO) SMS پیغامونه، پریمیم او معیاري نرخ ترلاسه کول.
د SMS REST API د معیاري نرخ MT SMS پیغامونو لیږلو ته وقف شوی دی.
API ټول SMS پیغامونه په غیر متناسب ډول لیږي، د ځانګړتیاوو وړ کول لکه:
"وژل او هیرول" - د خدماتو چمتو کونکی غواړي د وړاندوینې وړ ځواب وخت ولري او نه غواړي د آپریټر څخه پایلې ته انتظار وباسي.
د فعالیت بیا هڅه وکړئ - د LINK خوځښت به پیغام بیرته واستوي که چیرې آپریټر لنډمهاله ستونزې ولري.
2.1 د SMS پیغام لیږل
د خدماتو چمتو کونکي Netsize مصرف کونکي
- د MT پیغام واستوئ
- د پیغام ID بیرته راستانه کړئ
- د SMS پیغام واستوئ
- د سپارلو راپور وړاندې کړئ
- د سپارلو راپور ولېږئ
د ایس ایم ایس پیغامونو لیږلو لپاره بنسټیز جریان په لاندې ډول تشریح شوی:
د خدماتو چمتو کونکی غوښتنه کوي چې د LINK حرکت سیسټم له لارې ترلاسه کونکي ته د SMS پیغام واستوي.
د پیغام ID د خدمت چمتو کونکي ته بیرته ورکول کیږي. دا ID د دې لپاره کارول کیدی شي د بیلګې په توګه پیغام د سم تحویلي راپور سره اړیکه ونیسي.
LINK موبیلیټ روټینګ اداره کوي او پته شوي مصرف کونکي ته د SMS پیغام رسوي.
د تحویلي راپور رامینځته کیږي ، د مثال په توګه کله چې د پیرودونکي وسیلې ته د SMS پیغام لیږل کیږي.
د سپارلو راپور د خدماتو چمتو کونکي ته لیږل کیږي. راپور د ورته پیغام ID لري لکه څنګه چې په 2 مرحله کې بیرته راستانه شوی.
بدیل جریان: ناسمه غوښتنه
که چیرې په غوښتنه کې چمتو شوي پیرامیټونه یا د کارونکي اعتبار غلط وي نو د خدماتو چمتو کونکي ته یوه تېروتنه بیرته ورکول کیږي. تېروتنه د ردولو لامل په ګوته کوي او جریان پای ته رسیږي. هیڅ پیغام ID بیرته نه دی راستانه شوی.
3. پای ټکی
د SMS سرچینې ته د لارې په کارولو سره لاسرسی کیږي:
/restapi/v1/sms
Example URL
https://europe.ipx.com/restapi/v1/sms
د پیوستون امنیت لپاره د LINK Mobility REST API یوازې په HTTPS کې د لاسرسي وړ دی.
د لینک متحرک سرور سند د تاویټ سرور CA لخوا لاسلیک شوی.
4. عملیات
د SMS خدمت لاندې عملیات وړاندې کوي:
| نوم | لاره |
| لیږل | /restapi/v1/sms/send |
4.1 لیږل
د لیږلو عملیات یو واحد ترلاسه کونکي ته د ایس ایم ایس لیږلو لپاره کارول کیږي.
دا عملیات د دواړو لومړني او پرمختللي کاروونکو لپاره دي. په ساده حالت کې، یوازې د منزل پته، او د پیغام متن د SMS وړاندې کولو لپاره اړین دی. د LINK خوځښت به د ډیټا کوډ کولو سکیم کشف کړي او د اړتیا په صورت کې به د پیغام ډیری برخو ته د پیغام اتوماتیک کنیټیشن ترسره کړي.
د پرمختللي کارونې لپاره، د خدماتو چمتو کونکی کولی شي د پیغام فارمیټینګ بشپړ کنټرول لپاره اختیاري پیرامیټونه وکاروي په شمول د کارونکي ډیټا سرلیک.
د خدماتو چمتو کونکی کولی شي متناسب پیغامونه واستوي، مګر د کارونکي ډیټا او د کارونکي ډیټا سرلیک چمتو کول باید د خدماتو چمتو کونکي لخوا رامینځته شي او پیغام باید د LINK حرکت ته د ډیری لیږلو غوښتنو له لارې واستول شي.
5. تصدیق کول
کارن-نوم او پټنوم د HTTP اساسی تصدیق سکیم په کارولو سره په هره غوښتنه کې سپارل کیږي.
https://www.w3.org/Protocols/HTTP/1.0/spec.html#BasicAA
اسناد د HTTP په غوښتنه کې د اختیار ورکولو سرلیک کې لیږل کیږي. پیرودونکي د سرلیک ساحه جوړوي لکه څنګه چې دلته تشریح شوي:
https://en.wikipedia.org/wiki/Basic_access_authentication#Client_side
د مثال لپارهample، که د کارن نوم جان وي او changeme پټنوم وي نو د اختیار ورکولو پایله دا ده:
واک ورکول: اساسی am9objpjaGFuZ2VtZSA=
د بیرته ستنیدو په توګه د کارن نوم او پټنوم د غوښتنې پیرامیټونو په توګه سپارل کیدی شي. دا یوازې د هغو پیرودونکو لپاره وړاندیز کیږي چې د بنسټیز سند ملاتړ نه کوي.
6. د غوښتنې سپارل
6.1 د پوښتنې تار
د غوښتنې پیرامیټونه د پوښتنې تار په توګه سپارل شوي چې نوم / ارزښت جوړه لري. د پوښتنې تار د فیصدي کوډ کولو په کارولو سره کوډ شوی دی (URL کوډ کول).
http://www.w3schools.com/tags/ref_urlencode.asp
د مثال لپارهampلی، سلام نړۍ! د هیلو + ورلډ٪ 21 په توګه کوډ شوی.
6.2 د اجباري غوښتنې پیرامیټونه
| نوم | اعظمي اوږدوالی | تفصیل |
| د منزل پته | 40 | MSISDN چې د SMS پیغام باید واستول شي، د هیواد کوډ سره پیل کیږي. Example: 46123456789 د ځینو بازارونو لپاره (چیرې چې د مصرف کونکي MSISDN باید مبهم وي) دا ارزښت هم د الفانومیریک عرف هم کیدی شي ، د "#" سره مخکینۍ. |
| د پیغام متن | 1600 | د SMS پیغام منځپانګه. |
6.3 اختیاري غوښتنې پیرامیټونه (د پرمختللي کارونې لپاره)
| نوم | اعظمي اوږدوالی | تفصیل |
| اصلي پته | 16 | د وتلو ایس ایم ایس پیغام لپاره اصلي پته. د اصلي پتې ډول د originatorTON پیرامیټر لخوا تعریف شوی. لنډ شمیره اعظمي اوږدوالی 16 دی. د الفا شمیرې لیږونکی د GSM ډیفالټ الفبا پورې محدود دی د اعظمي اوږدوالی 11 حروف سره. د MSISDN لیږونکي اعظمي اوږدوالی 15 دی (د منزل پته عنصر په څیر ورته فارمیټ کارول). کله چې اصلي پته او originatingTON د سیسټم لخوا غوره کیږي له مینځه وړل کیدی شي. دا فعالیت په بازار او ترتیب پورې اړه لري. چلند ممکن د آپریټر ادغام سره توپیر ولري. |
| اصليت کوونکی TON | 1 | د اصلي پته د شمېر ډول (TON): 0 – لنډه شمېره 1 – الفا عددي ( اعظمي اوږدوالی 11 ) 2 – MSISDN کله چې اصلي پته او originatingTON به د سیسټم لخوا غوره شي له مینځه وړل کیدی شي. دا فعالیت په بازار او ترتیب پورې اړه لري. چلند ممکن د آپریټر ادغام سره توپیر ولري. |
| د UserDataHeader | 280 | د کارونکي ډیټا سرلیک د کارونکي ډیټا سره یوځای کولی شي تر 140 پورې ولري ، یعنی 280 کله چې هیکس کوډ شوی وي ، اوکټیټ. دا پیرامیټر تل هیکس کوډ شوی وي. |
| DCS | 3 | د معلوماتو کوډ کولو سکیم. چلند ممکن د آپریټر ادغام سره توپیر ولري. |
| PID | 3 | د پروتوکول ID چلند ممکن د آپریټر ادغام سره توپیر ولري. |
| نسبتي اعتبار وخت | 6 | د اعتبار وړ وخت په ثانیو کې (د LINK حرکت ته د سپارلو وخت سره تړاو لري). اعظمي ارزښت 604800 (7 ورځې) دی او ډیفالټ 48 ساعته دی. چلند ممکن د آپریټر ادغام سره توپیر ولري. |
| د سپارلو وخت | 20 | مهال ویشamp کله چې د ایس ایم ایس پیغام باید وسپارل شي (د تحویل وخت ځنډول). د نیټې وخت په بڼه برخه وګورئ. |
| د وضعیت راپور بیرغونه | 1 | د راپور غوښتنې وړاندې کول: 0 - د تحویلي راپور نشته (ډیفالټ) 1 - د سپارلو راپور غوښتل شوی 9 - د سرور تحویلي راپور غوښتنه شوې (د لینک حرکت راپور د خدماتو چمتو کونکي ته نه لیږدوي مګر دا په راپورونو او نورو کې چمتو کوي) |
| campد نوم نوم | 50 | د LINK تحرک لیږدونه دي tagد دې نوم سره ged. دا د لینک متحرک راپورونو کې د ګروپ لیږد لپاره کارول کیږي. |
| maxConcatenatedMessages | 1 | د 1 او 10 ترمنځ یو ارزښت چې دا مشخصوي چې څومره متناسب پیغامونه اجازه لري. ډیفالټ 3 دی. |
| ارتباط ID | 100 | ID د خدمت چمتو کونکي لخوا چمتو شوی چې د تحویلي راپور کې به هم غږیږي. |
| کارن نوم | 100 | د HTTP اساسی تصدیق لپاره د بدیل په توګه چمتو شوی. |
| رمز | 100 | د HTTP اساسی تصدیق لپاره د بدیل په توګه چمتو شوی. |
6.4 د HTTP غوښتنې میتودونه
د اعظمي مداخلې لپاره ، API دواړه د HTTP GET او POST غوښتنې میتودونو ملاتړ کوي. هیڅ بل HTTP میتودونو ته اجازه نشته.
6.4.1 ترلاسه کړئ
د کوډ شوي پوښتنې تار په کې ضمیمه شوی URL.
ترلاسه کړئ
https://europe.ipx.com/restapi/v1/sms/send?destinationAddress=461234
56789&messageText=Hello+World%21
واک ورکول: اساسی am9objpjaGFuZ2VtZSA=
6.4.2 پوسټ
د کوډ شوي پوښتنې تار د HTTP غوښتنې پیغام په بدن کې سپارل شوی. د منځپانګې ډول غوښتنلیک/x-www-form- دیurlکوډ شوی
پوسټ https://europe.ipx.com/restapi/v1/sms/send
کوربه: europe.ipx.com
د مینځپانګې ډول: غوښتنلیک / x-www-form-urlکوډ شوی
واک ورکول: اساسی am9objpjaGFuZ2VtZSA=
د منځپانګې اوږدوالی: 57
د منزل پته=46123456789&messageText=Hello+World%21
6.5 نیټه او وخت
په REST API کې پیرامیټونه چې د نیټې او وخت استازیتوب کوي تل د UTC وخت زون کې وي (همغږي نړیوال وخت). Timestamps د دې دقیق شکل سره د تار په توګه ښودل کیږي:
2017-04-25T23:20:50Z
دا په UTC کې د اپریل 20th 50 د 23 ساعتونو وروسته 25 دقیقې او 2017 ثانیې استازیتوب کوي.
7. د ځواب پیغام
د غوښتنې پیغام ترلاسه کولو او تشریح کولو وروسته API د HTTP ځواب پیغام سره ځواب ورکوي.
7.1 د HTTP حالت کوډ
REST API تل د پروسس شوي غوښتنو لپاره د HTTP حالت کوډ 200 OK بیرته راګرځوي. د پیغام بدن د پیرامیټر ځواب کوډ لري چې د دقیقې پایلې ټاکلو لپاره کارول کیږي.
7.2 د پیغام بدن
د پیغام بدن د JSON څخه جوړ دی چې د غوښتنې پایله بیانوي.
http://json.org/
د لینک حرکت JSON د ګوګل JSON سټایل لارښود سره مطابقت لري.
https://google.github.io/styleguide/jsoncstyleguide.xml
7.3 د غبرګون پارامترونه
| نوم | اعظمي اوږدوالی | تفصیل |
| ځواب کوډ | 3 | 0 بریالۍ معامله ښیي. |
| ځواب پیغام | 255 | ځواب متني توضیحات، د بیلګې په توګه د خطا متن. |
| وختamp | 20 | نیټه او وخت کله چې د LINK خوځښت غوښتنه پروسس کړه. (د نیټې/وخت شکل برخې ته مراجعه وکړئ). |
| TraceId | 36 | د لینک خوځښت داخلي پیژندونکی. د ملاتړ او ستونزې حل کولو لپاره کارول کیږي. |
| پیغام IDs | 10 x 36 | د هر بریالي پیغام لپاره د LINK خوځښت ځانګړي پیغام IDs لړۍ (که چیرې پیغام یوځای شوی وي ډیری پیغام IDs بیرته راستانه کیږي). د ناکامۍ په صورت کې پریښودل. |
7.4 پخوانیampځوابونه
بریالیتوب
HTTP/1.1 200 سم
د منځپانګې ډول: غوښتنلیک/json
د منځپانګې اوږدوالی: 144
نېټه: Thu, 15 سپتمبر 2016 13:20:31 GMT
{"responseCode":0,"responseMessage":"بریالیتوب"،"timestamp”:”2016-09-15T13:20:31Z”, “traceId”:”f678d30879fd4adc25f2″,”messageIds”:[“1-4850879008”]}
دلته د لوستلو وړتیا لپاره ورته JSON فارمیټ دی:
{
“ځواب کوډ":0,
“ځواب پیغام":"بریالیتوب،
“وختamp“:”2016-0915T13:20:31Z”,
“TraceId“:”f678d30879fd4adc25f2”,
“پیغام IDs":["1-4850879008"] }
ناکامي
HTTP/1.1 200 سم
د منځپانګې ډول: غوښتنلیک/json
د منځپانګې اوږدوالی: 148
نېټه: Thu, 15 سپتمبر 2016 13:20:31 GMT
{"responseCode":1,"responseMessage":" ناسم ننوت یا غیر مجاز API کارول ","timestamp”:”2016-09-15T13:20:31Z”,”traceId”:”f678d30879fd4adc25f2″}
بریالیتوب
HTTP/1.1 200 سم
د منځپانګې ډول: غوښتنلیک/json
د منځپانګې اوږدوالی: 144
نېټه: Thu, 15 سپتمبر 2016 13:20:31 GMT
{"responseCode":0,"responseMessage":"بریالیتوب"،"timestamp”:”2016-09-15T13:20:31Z”, “traceId”:”f678d30879fd4adc25f2″,”messageIds”:[“1-4850879008”]}
دلته د لوستلو وړتیا لپاره ورته JSON فارمیټ دی:
{
“ځواب کوډ":0,
“ځواب پیغام":"بریالیتوب،
“وختamp“:”2016-0915T13:20:31Z”,
“TraceId“:”f678d30879fd4adc25f2”,
“پیغام IDs":["1-4850879008"] }
ناکامي
HTTP/1.1 200 سم
د منځپانګې ډول: غوښتنلیک/json
د منځپانګې اوږدوالی: 148
نېټه: Thu, 15 سپتمبر 2016 13:20:31 GMT
{"responseCode":1,"responseMessage":" ناسم ننوت یا غیر مجاز API کارول ","timestamp”:”2016-09-15T13:20:31Z”,”traceId”:”f678d30879fd4adc25f2″}
7.5 د ځواب کوډونه
لاندې ځواب کوډونه د لیږلو ځواب کې بیرته راستانه کیدی شي:
| کوډ | متن | تفصیل |
| 0 | بریالیتوب | په بریالیتوب سره اعدام شو. |
| 1 | ناسم ننوتل یا غیر مجاز API کارول | غلط کارن نوم یا پټنوم یا د خدماتو چمتو کونکي د LINK حرکت لخوا منع شوي. |
| 2 | مصرف کونکي د لینک حرکت لخوا بند شوي | مصرف کونکي د LINK حرکت لخوا بند شوي. |
| 3 | عملیات د LINK خوځښت لخوا ندي چمتو شوي | عملیات د خدماتو چمتو کونکي لپاره بند شوي دي. |
| 4 | مصرف کوونکی د LINK حرکت لپاره نامعلوم دی | مصرف کوونکی د LINK حرکت لپاره نامعلوم دی. یا که په غوښتنه کې عرف کارول شوی وي؛ عرف ونه موندل شو. |
| 5 | مصرف کونکي دا خدمت په LINK حرکت کې بند کړی دی | مصرف کونکي دا خدمت په LINK حرکت کې بند کړی دی. |
| 6 | اصلي پته نه ده تائید شوې | اصلي پته نه ده تائید شوې. |
| 7 | د الفا اصلي پته د حساب لخوا نه ملاتړ کیږي | د الفا اصلي پته د حساب لخوا نه ملاتړ کیږي. |
| 8 | د MSISDN اصلي پته ملاتړ نه کوي | د MSISDN اصلي پته ملاتړ نه کوي. |
| 9 | GSM غزول شوی نه ملاتړ شوی | GSM غزول شوی نه ملاتړ شوی. |
| 10 | یونیکوډ نه ملاتړ کیږي | یونیکوډ نه ملاتړ کیږي. |
| 11 | د وضعیت راپور ندی تائید شوی | د وضعیت راپور ندی تائید شوی. |
| 12 | د اړتیا وړ وړتیا نه ملاتړ کیږي | د پیغام لیږلو لپاره اړین وړتیا (د پورتني پرته) ملاتړ نه کوي. |
| 13 | د مینځپانګې چمتو کونکي اعظمي حد څخه تیریږي | د خدماتو وړاندې کوونکی د LINK موبلیت ته د SMS پیغامونه په چټکۍ سره لیږي. |
| 14 | د پروتوکول ID د حساب لخوا نه ملاتړ کیږي | د پروتوکول ID ملاتړ نه کوي. |
| 15 | د پیغام د نښلولو له حد څخه تېر شو | د متقابلو پیغامونو شمیر د غوښتل شوي شمیر څخه ډیر دی. |
| 16 | د پیغام رسولو توان نلري. | د LINK خوځښت د پیغام رسولو توان نه درلود. |
| 17 | ممنوع وخت موده | د وخت په جریان کې د پیغام لیږلو اجازه نشته |
| 18 | د خدمت چمتو کونکي حساب کې خورا ټیټ توازن | د خدمت چمتو کونکي د ډیر ټیټ توازن له امله بلاک شوي |
| 50 | جزوی بریالیتوب | جزوی بریالیتوب کله چې ډیری ترلاسه کونکو ته د SMS پیغام لیږل. |
| 99 | د داخلي سرور تېروتنه | د نورو لینک خوځښت تېروتنه، د نورو معلوماتو لپاره د LINK حرکت ملاتړ سره اړیکه ونیسئ. |
| 100 | د غلط منزل پته | د منزل پته (MSISDN، یا عرف) ناسمه ده. |
| 102 | ناسم راجع شوی (تړل شوی) ID | د حوالې ID غلط دی، شاید د حوالې ID لا دمخه کارول شوی وي، ډیر زوړ یا نامعلوم. |
| 103 | ناسم حساب نوم | د حساب نوم ناسم دی. |
| 105 | ناسم خدمت میټا ډاټا | د خدمت میټا ډاټا ناباوره ده. |
| 106 | ناسم اصلي آدرس | اصلي پته ناسمه ده. |
| 107 | غلط الفانومریک اصلي آدرس | د الفانومریک اصلي پته ناسمه ده. |
| 108 | د اعتبار وخت غلط | د اعتبار وخت باطل دی. |
| 109 | د سپارلو وخت ناسم | د سپارلو وخت ناباوره دی. |
| 110 | ناسم پیغام منځپانګه/د کاروونکي معلومات | د کارونکي ډاټا، د بیلګې په توګه د SMS پیغام، ناسم دی. |
| 111 | ناسم پیغام اوږدوالی | د SMS پیغام اوږدوالی ناسم دی. |
| 112 | د کارونکي د معلوماتو ناسم سرلیک | د کارونکي ډیټا سرلیک غلط دی. |
| 113 | د ناسم معلوماتو کوډ کولو سکیم | DCS باطل دی. |
| 114 | ناسم پروتوکول ID | PID ناسم دی. |
| 115 | د ناسم وضعیت راپور بیرغونه | د وضعیت راپور بیرغونه ناسم دي. |
| 116 | ناسم TON | پیل کونکی TON ناسم دی. |
| 117 | ناسم جampaign نوم | د سيampد اګن نوم ناسم دی. |
| 120 | د زیات شمیر مربوط پیغامونو لپاره ناسم حد | د راټول شوي پیغامونو اعظمي شمیر غلط دی. |
| 121 | ناسم Msisdn اصلي آدرس | د MSISDN اصلي پته ناسمه ده. |
| 122 | د ناسم ارتباط ID | د ارتباط ID ناسم دی. |
8. اختیاري ځانګړتیاوې
8.1 د MSISDN سمون
د MSISDN سمون یو اختیاري ځانګړتیا ده چې د غوښتنې په صورت کې د LINK خوځښت ملاتړ لخوا فعال کیدی شي.
دا فیچر به د منزل پته سمه کړي او د اړتیا وړ E.164 بڼه ته به یې سمون ورکړي. د فارمیټ سمون سربیره سیسټم ممکن د بازار ځانګړي فعالیت هم ترسره کړي لکه د DOM-TOM (départements et territoires d'outre-mer) شمیرو سمولو لپاره د نړیوالو فرانسوي شمیرو ژباړل کله چې پلي کیږي.
لاندې یو شمیر پخواني ديampد اصالحاتو لست:
| سپارل شوي منزل پته | د منزل پته سمه کړه |
| +46(0)702233445 | 46702233445 |
| (0046) 72233445 | 46702233445 |
| +۵۷ | 46702233445 |
| 46(0)702233445 | 46702233445 |
| 46070-2233445 | 46702233445 |
| 0046702233445 | 46702233445 |
| +46(0)702233445aaa | 46702233445 |
| 336005199999 | 2626005199999 (د فرانسوي شمیره د DOM-TOM شمیرې ته ژباړل شوې) |
سربیره پردې، دا ممکنه ده چې د ټاکل شوي بازار لپاره د ملي تلیفون شمیرو ته اجازه ورکړئ. کله چې دا خصوصیت فعال شي د نورو بازارونو لپاره کومې نړیوالې شمیرې باید د لومړني `+' نښه سره واستول شي ترڅو د ټاکل شوي بازار څخه توپیر وکړي.
لاندې څو پخواني ديampد ملي شمیرو لپاره د ډیفالټ بازار په توګه د سویډن (د هیواد کوډ 46) کارولو په وخت کې د اصالحاتو شمیر ترسره کیږي.
| سپارل شوي منزل پته | د منزل پته سمه کړه |
| 0702233445 | 46702233445 |
| 070-2233 445 | 46702233445 |
| 070.2233.4455 | 46702233445 |
| 460702233445 | 46702233445 |
| +۵۷ | 46702233445 |
| +۵۷ | 458022334455 |
| 45802233445 | ناسمه ده ځکه چې د '+' نښه ورکه ده |
په یاد ولرئ چې سم شوی MSISDN به د LINK خوځښت لخوا کارول کیږي او دا به د تحویلي راپورونو کې بیرته راستانه شي.
مهرباني وکړئ د نورو معلوماتو لپاره د LINK خوځښت ملاتړ سره اړیکه ونیسئ.
8.2 د کرکټر بدلول
د کرکټر بدلول یو اختیاري ځانګړتیا ده چې د غوښتنې په صورت کې د LINK خوځښت ملاتړ لخوا فعال کیدی شي.
دا فیچر به د کاروونکي ډیټا (SMS متن) کې د غیر GSM الفبا حروف د GSM الفبا سره مساوي ته وژباړي کله چې DCS "GSM" (17) ته ټاکل شوی وي. د مثال لپارهample "Seqüência de teste em Português" به "Seqüencia de teste em Portugues" ته ژباړل شي.
9. د سپارلو راپورونه
د خدماتو چمتو کونکی کولی شي، که چمتو شوي وي، د لیږل شوي MT پیغامونو لپاره د ایس ایم ایس پیغام رسولو راپورونو یا تحویلي خبرتیاو غوښتنه وکړي. دا راپورونه په آپریټر SMSC کې هغه وخت رامینځته کیږي کله چې د MT پیغام یا هدف شوي مصرف کونکي ته وسپارل شي یا حذف شي ، د مثال په توګه ، موده پای ته رسیدلې یا د کوم دلیل لپاره د روټ وړ نه وي.
یوازې د SMS پیغام وروستی حالت د خدماتو چمتو کونکي ته راپور ورکول کیږي، د بیلګې په توګه، سپارل شوی یا حذف شوی. په هر MT پیغام کې یوازې یو راپور جوړیږي. د حذف شوي حالت سره، د دلیل کوډ ممکن پلي شي. د دې دلیل کوډ د ایس ایم ایس پیغام نه رسولو لامل په ګوته کوي.
راپورونه د LINK خوځښت له لارې لیږدول کیږي او د HTTP پروتوکول په کارولو سره د خدماتو چمتو کونکي ته لیږل کیږي.
د راپورونو ترالسه کولو لپاره، د خدماتو چمتو کوونکی باید د پخوا لپاره پلي کړيampد Java Servlet یا ASP.NET پاڼه. دواړه د HTTP GET یا POST غوښتنې ترلاسه کوي.
پیرامیټونه
په غوښتنلیک کې لاندې پیرامیټونه شامل دي:
| پیرامیټر | ډول | M/O/I* | ډیفالټ ارزښت | اعظمي اوږدوالی | تفصیل |
| د پیغام ID | تار | M | – | 22 | د MT پیغام پیغام ID چې دا راپور ورته ورته دی. |
| د منزل پته | تار | M | – | 40 | د مصرف کونکي MSISDN، د بیلګې په توګه د اصلي MT پیغام د منزل پته. |
| د حالت کوډ | عدد | M | 1 | د وضعیت کوډ د MT پیغام حالت په ګوته کوي. د تطبیق وړ حالت کوډونه دي: 0 - سپارل شوی 2 - حذف شوی (د دلیل کوډ تطبیق کیږي) |
|
| TimeStamp | تار | M | – | 20 | وخت په ګوته کوي کله چې د تحویلي راپور د LINK حرکت لخوا ترلاسه شو. د وخت د وخت زونamp CET یا CEST دی (د دوبي وخت سره لکه څنګه چې د EU لپاره تعریف شوی). بڼه: yyyyMMdd HH:mm:ss. |
| چلوونکی | تار | M | – | 100 | د آپریټر نوم د SMS پیغام لیږلو پرمهال کارول کیږي یا د اکاونټ نوم د SMS پیغام لیږلو پرمهال کارول کیږي. د موجود آپریټرانو لیست د LINK حرکت ملاتړ لخوا چمتو شوی. |
| د دلیل کوډ | عدد | O | – | 3 | د دلیل کوډ په ګوته کوي چې ولې پیغام په حذف شوي حالت کې پای ته رسیدلی. د تطبیق وړ دلیل کوډونه دي: 100 - ختم شوی 101 - رد شوی 102 - د بڼې تېروتنه ۷ – بله تېروتنه 110 - پیرودونکي نامعلوم 111 - پیرودونکي منع شوي 112 - پیرودونکي چمتو شوي ندي 113 - پیرودونکي شتون نلري 120 - د SMSC ناکامي 121 – د SMSC ګڼه ګوڼه 122 - د SMSC رومینګ 130 - د لاسي غلطي 131 - د هینډسیټ حافظه ډیره شوې چلند ممکن د آپریټر ادغام سره توپیر ولري. |
| OperatorTimeStamp | تار | O | – | 20 | وخت په ګوته کوي کله چې راپور د آپریټر په SMSC کې رامینځته شوی (که د آپریټر لخوا چمتو شوی وي). د وخت د وخت زونamp CET یا CEST دی (د دوبي وخت سره لکه څنګه چې د EU لپاره تعریف شوی). بڼه: yyyyMMdd HH:mm:ss. |
| د وضعیت متن | تار | O | – | 255 | د آپریټر څخه د اضافي معلوماتو لپاره ځای لرونکی ، د مثال په توګه د وضعیت / دلیل روښانه متن توضیحات. چلند ممکن د آپریټر ادغام سره توپیر ولري. |
| د ارتباط ID | تار | O | – | 100 | د ارتباط ID په SendRequest یا SendTextRequest کې چمتو شوی. |
| OperatorNetworkCode | عدد | O | – | 6 | د آپریټر د ګرځنده شبکې کوډ (MCC + MNC). |
* M = لازمي، O = اختیاري، I = له پامه غورځول شوی.
د خدماتو چمتو کونکی باید د هدف سره د LINK خوځښت چمتو کړي URL د تحویلي راپورونو لپاره (په اختیاري توګه د HTTP لومړني تصدیق لپاره اسناد شامل دي). د خدماتو چمتو کونکی کولی شي غوره کړي چې کوم غوره HTTP میتود وکاروي:
HTTP پوسټ (سپارښتنه)
HTTP ترلاسه کړئ.
Exampد HTTP GET په کارولو سره (په بریالیتوب سره سپارل شوی):
https://user:password@www.serviceprovider.com/receivereport?%20MessageId=122&DestinationAddress=46762050312&Operator=Vodafone&TimeStamp=20100401%2007%3A47%3A44&StatusCode=0
Exampد HTTP GET په کارولو سره (نه سپارل شوی، آپریټر تر ټولو وخته چمتو کړی دیamp د پیښې لپاره):
پیرامیټونه دي URL انکوډی
د کرکټر کوډ کول:
د خدماتو چمتو کونکی کولی شي غوره کړي چې کوم غوره کرکټر کوډ کول کارول کیږي:
UTF-8 (سپارښتنه)
ISO-8859-1.
9.1 د خدماتو چمتو کونکي اعتراف
د خدماتو چمتو کونکی باید د تحویلي هر راپور ومني. اعتراف مثبت وي، د بیلګې په توګه د سپارلو راپور په بریالیتوب سره ترلاسه شوی، یا منفي، د بیلګې په توګه ناکامي.
مهرباني وکړئ په یاد ولرئ: د LINK حرکت د سپارلو راپورونو لپاره د 30 ثانیو اعترافونو لپاره د لوستلو وخت لري. یو مهال ویش به د تحویلي بیا هڅه پیل کړي (که بیا هڅه فعاله وي) یا د تحویلي لغوه کول (که بیا هڅه غیر فعاله وي). دا پدې مانا ده چې د خدماتو چمتو کونکي غوښتنلیک باید د چټک غبرګون وخت ډاډمن کړي، په ځانګړې توګه د لوړ بار په وخت کې.
دا ډیره توصیه کیږي چې د پروسس کولو دمخه د LINK حرکت په لور د تحویلي راپور تسلیم کړئ.
د مثبت او منفي اعتراف اصول په لاندې ډول بیان شوي:
مثبت اعتراف، ACK، د سپارلو راپور وړاندې شوی:
د HTTP 200 رینج ځواب کوډ د لاندې XML فارمیټ شوي مینځپانګې سره په ترکیب کې:
منفي اعتراف، NAK، د سپارلو راپور ندی سپارل شوی:
د مثبت اعتراف پرته بل کوم ځواب، د مثال لپارهample، منفي اعتراف د هر ډول HTTP تېروتنې کوډ یا لاندې XML منځپانګې لخوا رامینځته کیږي:
د XML منځپانګې د LINK د خوځښت بیاکتنې میکانیزم کنټرول لپاره کارول کیدی شي. NAK به د بیا هڅه کولو هڅه وکړي، که فعاله شي. د خدماتو چمتو کونکو لپاره چې د بیا هڅه کولو میکانیزم لپاره ندي ترتیب شوي، د XML مینځپانګه اختیاري ده.
لاندې د HTTP پوسټ غوښتنه او ځواب مثال دیampد خدمت چمتو کونکي ته د تحویلي راپور لیږل:
د HTTP غوښتنه:
POST/context/app HTTP/1.1
د مینځپانګې ډول: غوښتنلیک / x-www-form-urlکوډ شوی؛charset=utf-8
کوربه: سرور: پورټ
د منځپانګې اوږدوالی: xx
MessageId=213123213&DestinationAddress=46762050312&Operator=Telia& OperatorTimeStamp=20130607%2010%3A45%3A00&TimeStamp=20130607%2010%3A 45%3A02&StatusCode=0
د HTTP ځواب:
HTTP/1.1 200 سم
د منځپانګې ډول: متن / ساده
9.2 بیا هڅه وکړئ
د LINK خوځښت سیسټم کولی شي د ناکامۍ لپاره د بیا هڅې هڅې ترسره کړي، د بیلګې په توګه نه منل شوي، د سپارلو راپور وړاندې کول. د خدماتو چمتو کونکی کولی شي د غوره بیاکتنې چلند غوره کړي:
بیا هڅه نه ده (ډیفالټ) - پیغام به رد شي که چیرې د پیوستون هڅه ناکامه شي، د وخت پای ته رسیدو یا د HTTP غلطی کوډ لپاره لوستل شي.
بیا هڅه وکړئ - پیغام به د هر ډول پیوستون ستونزې، د لوستلو وخت پای، یا منفي اعتراف لپاره بیا واستول شي.
کله چې د NAK لپاره بیا هڅه فعاله شي، نو دا مهمه ده چې پوه شئ چې کوم سناریوګانې به د LINK حرکت څخه د بیا هڅه کولو هڅه رامینځته کړي او بیا هڅه څنګه کار کوي. هر خدمت چمتو کونکی خپل د بیاکتنې کتار لري، چیرې چې پیغامونه د پیغام وخت سره سم ترتیب شويamp. د لینک حرکت تل هڅه کوي چې زاړه پیغامونه لومړی وړاندې کړي، که څه هم د خدماتو چمتو کونکي ته د پیغامونو انفرادي ترتیب تضمین ندی. د بیاکتنې کتار څخه د پیغامونو د ایستلو اصلي دلیل د دوو دلیلونو څخه یو دی: یا د پیغام TTL پای ته رسیږي یا (په تیوریکي توګه) د بیاکتنې کتار ډک کیږي. TTL چلونکی دی او حساب پورې اړه لري، د بیلګې په توګه، کیدای شي د آپریټر او یا د پیغام ډول پورې اړه ولري، د بیلګې په توګه، د پریمیم ایس ایم ایس یا معیاري نرخ SMS پیغام.
د خدماتو چمتو کونکي چې بیا هڅه یې فعاله شوې باید د MT پیغام ځانګړي ID چیک کړي ترڅو ډاډ ترلاسه کړي چې پیغام لا دمخه نه دی ترلاسه شوی.
د خدماتو چمتو کونکي لپاره دا مهمه ده چې د دې ساده مقرراتو سره سم عمل وکړي کله چې د تحویلي راپور پروسس کولو پرمهال کومه تېروتنه رامنځته شي که چیرې د غلطۍ لامل دا وي: لنډمهاله، د بیلګې په توګه ډیټابیس شتون نلري، NAK باید بیرته راستانه شي. LINK خوځښت به پیغام بیا واستوي.
دایمي او د بیا ځلي هڅې احتمال د ورته ستونزې لامل کیږي، ACK باید بیرته راستانه شي. د مثال لپارهample، کله چې پیغام په سمه توګه تجزیه نشي یا د ناڅاپه چلولو وخت تېروتنه رامنځته کړي.
د دې مطابق عمل کول به ډاډ ترلاسه کړي چې د تحویلي راپور په مکرر ډول لیږل کیدو له امله هیڅ ډول بلاک کول یا د تخریب لامل نه کیږي.
10. د تطبیق لارښوونې
1. دا ممکنه ده چې ستاسو څخه کار واخلئ web براؤزر API ته د غوښتنې سپارلو لپاره. دا پرته له کوم پرمختیایی وسیلو څخه د خدماتو سپړنه او ارزونه خورا اسانه کوي.
2. کروم یا فایرفوکس د توسیع سره یوځای وړاندیز کیږي لکه JSONView د ښکلي بڼه شوي JSON ښودلو لپاره.
3. موږ د POST ازموینې، بنسټیز تصدیق او د خام HTTP غوښتنې او ځواب پیغامونو معاینه کولو لپاره SoapUI کارولی دی.
4. د سيURL وسیله د اساسی تصدیق سره د POST غوښتنې سپارلو لپاره ګټوره ده. وګورئ exampلاندې.
curl پوسټ \
-H "د منځپانګې ډول: غوښتنلیک/x-www-form-urlکوډ شوی" \
-H "اختیار: اساسی am9objpjaGFuZ2VtZSA=" \
https://europe.ipx.com/restapi/v1/sms/send \
-ډاټا "د منزل پته=46123456789&messageText=Hello+World%21"
_______________
د شخصي اړیکو بدلول
اسناد / سرچینې
 |
د LINK د خوځښت پلي کولو لارښود REST API SMS [pdf] د کارونکي لارښود د حرکت پلي کولو لارښود REST API SMS, حرکت, د پلي کولو لارښود REST API SMS, REST API SMS, API SMS, SMS |
