LINK موبلٽي پليپمينٽ گائيڊ REST API SMS
LINK Mobility پيغام پهچائڻ، مائڪرو ادائگي، ۽ مقام تي ٻڌل خدمتون مهيا ڪري ٿي. پليٽ فارم هڪ شفاف، وائيٽ ليبل مواد حاصل ڪندڙ ۽ ٽرانزيڪشن روٽر جي طور تي ڪم ڪري ٿو سروس فراهم ڪندڙن ۽ آپريٽرز جي وچ ۾.
LINK Mobility هڪ RESTful API مهيا ڪري ٿي جيڪا LINK موبلٽي سروسز تائين رسائي حاصل ڪرڻ لاءِ استعمال ٿي سگهي ٿي جيئن ايس ايم ايس موڪلڻ. هي API استعمال ڪرڻ ۾ آسان ۽ سڀني جديد ٻولين ۽ فريم ورڪ سان مطابقت رکي ٿي. توهان جي پسند جي ٻولي استعمال ڪندي توهان جي ايپليڪيشن استعمال ڪري سگهي ٿي Link Mobility 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
دستاويز جو دائرو
هي دستاويز بيان ڪري ٿو ته ڪيئن خدمت فراهم ڪندڙ LINK Mobility REST API استعمال ڪري ٿو ايس ايم ايس لاءِ. اهو مقصد آهي ٽيڪنيڪل آرڪيٽيڪٽس ۽ ڊزائنر جيڪي سروس فراهم ڪندڙ جي خدمتن کي لاڳو ڪن ٿا.
1. بنيادي استعمال
ايس ايم ايس موڪلڻ تمام آسان آهي. توهان هڪ HTTP درخواست موڪليندا آهيو LINK موبائيلٽي تي جيڪا صرف هڪ استعمال ڪندي پوري ٿي سگهي ٿي web برائوزر.
2. فنڪشنل اوورview
LINK موبلٽي سسٽم ايس ايم ايس پيغامن لاءِ هيٺين بنيادي ڪارڪردگي مهيا ڪري ٿو:
موڪلڻ موبائيل ختم ٿيل (MT) ايس ايم ايس پيغام، جهڙوڪ ٽيڪسٽ يا بائنري (مثال طور WAP پش) پريميئم ۽ معياري شرح پيغام.
جمع ٿيل MT پيغامن لاء ترسيل رپورٽون حاصل ڪرڻ.
موبائيل Originated (MO) ايس ايم ايس پيغام حاصل ڪرڻ، پريميئم ۽ معياري شرح.
ايس ايم ايس REST API معياري شرح MT ايس ايم ايس پيغام موڪلڻ لاء وقف آهي.
API سڀني ايس ايم ايس پيغامن کي غير هم وقتي طور تي موڪلي ٿو، خاصيتن کي فعال ڪرڻ جهڙوڪ:
”فائر-اينڊ-فرارجيٽ“ - سروس فراهم ڪندڙ چاهي ٿو ته وڌيڪ متوقع جوابي وقت هجي ۽ آپريٽر جي نتيجي جو انتظار نه ڪرڻ چاهي.
ڪارڪردگي جي ٻيهر ڪوشش ڪريو - LINK موبليٽي پيغام کي ٻيهر موڪليندو جيڪڏهن آپريٽر کي عارضي مسئلا آهن.
2.1 ايس ايم ايس پيغام موڪلڻ
خدمت مهيا ڪندڙ Netsize صارفين
- MT پيغام موڪليو
- واپسي پيغام جي ID
- ايس ايم ايس پيغام موڪليو
- پهچائڻ جي رپورٽ ڏيو
- ترسيل رپورٽ موڪليو
ايس ايم ايس پيغام موڪلڻ لاء بنيادي وهڪري هن ريت بيان ڪئي وئي آهي:
خدمت فراهم ڪندڙ LINK موبلٽي سسٽم ذريعي وصول ڪندڙ کي هڪ ايس ايم ايس پيغام موڪلڻ جي درخواست ڪري ٿو.
هڪ پيغام جي سڃاڻپ سروس فراهم ڪندڙ ڏانهن واپس ڪئي وئي آهي. هي ID استعمال ڪري سگهجي ٿي مثال طور پيغام کي صحيح پهچائڻ واري رپورٽ سان لاڳاپو.
LINK موبليٽي روٽنگ کي سنڀاليندو آهي ۽ ايس ايم ايس پيغام کي ايڊريس ٿيل صارف تائين پهچائيندو آهي.
ترسيل رپورٽ شروع ڪئي وئي آهي، مثال طور جڏهن ايس ايم ايس پيغام صارف جي ڊوائيس تائين پهچايو ويندو آهي.
پهچائڻ جي رپورٽ سروس فراهم ڪندڙ ڏانهن موڪلي وئي آهي. رپورٽ ۾ ساڳيو پيغام ID شامل آهي جيئن قدم 2 ۾ واپس آيو.
متبادل وهڪري: غلط درخواست
جيڪڏهن درخواست ۾ مهيا ڪيل پيرا ميٽرز يا صارف جي سندون غلط آهن هڪ غلطي خدمت فراهم ڪندڙ ڏانهن واپس ڪئي وئي آهي. غلطي رد ڪرڻ جو سبب ظاهر ڪري ٿي ۽ وهڪري ختم ٿي وڃي ٿي. ڪوبه پيغام ID واپس نه ڪيو ويو آهي.
3. آخر پوائنٽ
ايس ايم ايس وسيلن تائين رسائي آهي رستو استعمال ڪندي:
/restapi/v1/sms
Example URL
https://europe.ipx.com/restapi/v1/sms
ڪنيڪشن سيڪيورٽي لاءِ LINK Mobility REST API صرف HTTPS تي دستياب آهي.
لنڪ موبلٽي سرور سرٽيفڪيٽ تي دستخط ٿيل آهي Thawte Server CA.
4. آپريشنز
ايس ايم ايس سروس هيٺين عملن کي مهيا ڪري ٿي:
| نالو | رستو |
| موڪليو | /restapi/v1/sms/send |
4.1 موڪليو
موڪلڻ جو عمل استعمال ڪيو ويندو آھي ھڪڙي وصول ڪندڙ کي ايس ايم ايس موڪلڻ لاءِ.
هي آپريشن ٻنهي بنيادي ۽ ترقي يافته استعمال ڪندڙن لاء آهي. آسان ترين صورت ۾، صرف منزل جو پتو، ۽ پيغام جي متن کي ايس ايم ايس پهچائڻ جي ضرورت آهي. 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
مثال طورampلي، جيڪڏهن يوزرنيم جان آهي ۽ changeme پاسورڊ آهي ته پوءِ نتيجو اختيار ڪرڻ وارو هيڊر آهي:
اختيار ڏيڻ: بنيادي am9objpjaGFuZ2VtZSA=
واپسي جي طور تي صارف نالو ۽ پاسورڊ درخواست جي پيٽرولن جي طور تي پيش ڪري سگھجي ٿو. اهو صرف انهن گراهڪن لاءِ سفارش ڪئي وئي آهي جيڪي بنيادي سند کي سپورٽ نٿا ڪن.
6. درخواست جمع ڪرائڻ
6.1 پڇا ڳاڇا
درخواست جا پيرا ميٽر جمع ڪيا ويا آهن سوال اسٽرنگ جي طور تي جنهن ۾ نالو/قدر جوڙو شامل آهن. پڇا ڳاڇا اسٽرنگ کي استعمال ڪندي انڪوڊ ڪيو ويو آهي سيڪڙو انڪوڊنگ (URL انڪوڊنگ).
http://www.w3schools.com/tags/ref_urlencode.asp
مثال طورampلي، هيلو ورلڊ! هيلو + ورلڊ %21 طور انڪوڊ ٿيل آهي.
6.2 لازمي درخواست جا پيرا ميٽر
| نالو | وڌ ۾ وڌ ڊگھائي | وصف |
| منزل جو پتو | 40 | MSISDN جنهن کي ايس ايم ايس پيغام موڪليو وڃي، ملڪ جي ڪوڊ سان شروع ٿئي. مثالampلي: 46123456789. ڪجهه مارڪيٽن لاءِ (جتي صارفين MSISDN کي مبهم هجڻ گهرجي) هي قدر پڻ الفانميرڪ عرف ٿي سگهي ٿو، اڳي ئي "#" سان. |
| پيغام جو متن | 1600 | ايس ايم ايس پيغام جو مواد. |
6.3 اختياري درخواست جا پيرا ميٽر (اعلي استعمال لاءِ)
| نالو | وڌ ۾ وڌ ڊگھائي | وصف |
| originating address | 16 | نڪرندڙ ايس ايم ايس پيغام لاءِ اصلي پتو. ابتدائي پتي جو قسم originatorTON پيٽرولر طرفان بيان ڪيو ويو آهي. مختصر نمبر وڌ ۾ وڌ ڊگھائي 16 آھي. الفا عددي موڪليندڙ GSM ڊفالٽ الفابيٽ تائين محدود آهي وڌ ۾ وڌ 11 اکرن سان. MSISDN موڪليندڙ جي وڌ ۾ وڌ ڊيگهه 15 آهي (ساڳئي فارميٽ کي استعمال ڪندي destinationAddress عنصر). ختم ڪري سگھجي ٿو جڏهن originatingAddress ۽ originatingTON چونڊيو وڃي سسٽم طرفان. هي فنڪشن مارڪيٽ ۽ ترتيب تي منحصر آهي. آپريٽر جي انضمام سان رويو مختلف ٿي سگھي ٿو. |
| پيدا ڪندڙ TON | 1 | اصل پتو نمبر جو قسم (TON): 0 - مختصر نمبر 1 - الفا عددي (وڌ کان وڌ ڊگھائي 11) 2 - MSISDN ختم ڪري سگھجي ٿو جڏهن originatingAddress ۽ originatingTON چونڊيو ويندو سسٽم طرفان. هي فنڪشن مارڪيٽ ۽ ترتيب تي منحصر آهي. آپريٽر جي انضمام سان رويو مختلف ٿي سگھي ٿو. |
| userDataHeader | 280 | يوزر ڊيٽا هيڊر يوزر ڊيٽا سان گڏ ٿي سگھي ٿو 140 تائين، يعني 280 جڏهن هيڪس-انڪوڊ ٿيل، آڪٽٽس. هي پيٽرول هميشه هيڪس-انڪوڊ ٿيل آهي. |
| ڊي سي ايس | 3 | ڊيٽا ڪوڊنگ اسڪيم. آپريٽر جي انضمام سان رويو مختلف ٿي سگھي ٿو. |
| پي آءِ ڊي | 3 | پروٽوڪول ID. آپريٽر جي انضمام سان رويو مختلف ٿي سگھي ٿو. |
| لاڳاپيل صحيح وقت | 6 | لاڳاپو صحيح وقت سيڪنڊن ۾ (LINK موبلائيت کي جمع ڪرائڻ جي وقت سان لاڳاپيل). وڌ ۾ وڌ قدر 604800 (7 ڏينهن) آهي ۽ ڊفالٽ 48 ڪلاڪ آهي. آپريٽر جي انضمام سان رويو مختلف ٿي سگھي ٿو. |
| پهچائڻ وقت | 20 | ٽائيمسٽamp جڏهن ايس ايم ايس پيغام پهچائڻ گهرجي (ترسيل وقت دير سان). سيڪشن ڏسو تاريخ جي وقت جي فارميٽ تي. |
| statusReportFlags | 1 | رپورٽ پيش ڪرڻ جي درخواست: 0 - ڪابه ترسيل رپورٽ (ڊفالٽ) 1 - پهچائڻ جي رپورٽ جي درخواست ڪئي وئي 9 - سرور جي ترسيل رپورٽ جي درخواست ڪئي وئي (LINK موبليٽي رپورٽ کي سروس فراهم ڪندڙ ڏانهن نه موڪليو پر ان کي رپورٽن ۾ دستياب بڻائي ٿي وغيره) |
| campaign نالو | 50 | LINK موبلٽي ٽرانزيڪشن آهن tagهن نالي سان ged. اهو استعمال ڪيو ويندو آهي گروپ ٽرانزيڪشن کي لنڪ موبلٽي رپورٽن ۾. |
| maxConcatenatedMessages | 1 | 1 ۽ 10 جي وچ ۾ هڪ قدر جيڪا وضاحت ڪري ٿي ته ڪيترا گڏيل پيغام جيڪي اجازت ڏين ٿا. ڊفالٽ 3 آهي. |
| رابطي جي سڃاڻپ | 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 ٽائم زون (Coordinated Universal Time) ۾ هوندا آهن. ٽائمسٽamps هن صحيح فارميٽ سان هڪ اسٽرنگ جي طور تي نمائندگي ڪئي وئي آهي:
2017-04-25T23:20:50Z
هي UTC ۾ 20 اپريل 50 جي 23 ڪلاڪ کان پوءِ 25 منٽ ۽ 2017 سيڪنڊن جي نمائندگي ڪري ٿو.
7. جوابي پيغام
هڪ درخواست پيغام حاصل ڪرڻ ۽ تفسير ڪرڻ کان پوء API هڪ HTTP جوابي پيغام سان جواب ڏئي ٿو.
7.1 HTTP اسٽيٽس ڪوڊ
REST API هميشه پروسيس ٿيل درخواستن لاءِ HTTP اسٽيٽس ڪوڊ 200 OK موٽائي ٿو. پيغام جي جسم ۾ هڪ پيٽرولر جواب ڪوڊ شامل آهي جيڪو درست نتيجو کي طئي ڪرڻ لاء استعمال ڪيو ويندو آهي.
7.2 پيغام جو جسم
پيغام جو جسم JSON تي مشتمل آهي درخواست جو نتيجو بيان ڪري ٿو.
http://json.org/
لنڪ موبلٽي JSON Google JSON اسٽائل گائيڊ سان مطابقت رکي ٿي.
https://google.github.io/styleguide/jsoncstyleguide.xml
7.3 جوابي معيار
| نالو | وڌ ۾ وڌ ڊگھائي | وصف |
| جواب ڪوڊ | 3 | 0 ڪامياب ٽرانزيڪشن کي اشارو ڪري ٿو. |
| جوابي پيغام | 255 | جوابي متن جي وضاحت، مثال طور غلطي متن. |
| ٽائيمamp | 20 | تاريخ ۽ وقت جڏهن LINK موبلٽي درخواست تي عمل ڪيو. (تاريخ/وقت فارميٽ سيڪشن ڏانهن رجوع ڪريو). |
| traceId | 36 | لنڪ موبلٽي اندروني سڃاڻپ ڪندڙ. مدد ۽ مسئلا حل ڪرڻ لاء استعمال ڪيو. |
| پيغام آئي ڊي | 10 x 36 | هر ڪامياب پيغام لاءِ LINK موبائيلٽي منفرد پيغام جي IDs جو صف (ڪيترن پيغام جي IDs واپس اينديون آهن جيڪڏهن پيغام جوڙيو ويو آهي). ناڪامي جي صورت ۾ ختم ڪيو ويو. |
7.4 سابقampجوابن
ڪاميابي
HTTP/1.1 200 ٺيڪ
مواد جو قسم: ايپليڪيشن/json
مواد- ڊگھائي: 144
تاريخ: خميس، 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”,
“پيغام آئي ڊي":["1-4850879008"] }
ناڪامي
HTTP/1.1 200 ٺيڪ
مواد جو قسم: ايپليڪيشن/json
مواد- ڊگھائي: 148
تاريخ: خميس، 15 سيپٽمبر 2016 13:20:31 GMT
{"responseCode":1,"responseMessage":"غلط لاگ ان يا غير مجاز API استعمال","timestamp”:”2016-09-15T13:20:31Z”,”traceId”:”f678d30879fd4adc25f2″}
ڪاميابي
HTTP/1.1 200 ٺيڪ
مواد جو قسم: ايپليڪيشن/json
مواد- ڊگھائي: 144
تاريخ: خميس، 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”,
“پيغام آئي ڊي":["1-4850879008"] }
ناڪامي
HTTP/1.1 200 ٺيڪ
مواد جو قسم: ايپليڪيشن/json
مواد- ڊگھائي: 148
تاريخ: خميس، 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 Mobility کان اڻڄاتل آهي | صارف LINK موبلائيت کان اڻڄاتل آهي. يا جيڪڏهن عرف درخواست ۾ استعمال ڪيو ويو هو؛ عرف نه مليو. |
| 5 | صارفين هن سروس کي بلاڪ ڪيو آهي LINK موبلٽي ۾ | صارفين هن سروس کي بلاڪ ڪيو آهي LINK موبلٽي ۾. |
| 6 | شروعاتي ايڊريس سپورٽ نه آهي | شروعاتي ايڊريس سپورٽ نه آهي. |
| 7 | الفا اصلي پتو اڪائونٽ طرفان سهڪار نه ڪيو ويو آهي | الفا جي اصليت واري ايڊريس اڪائونٽ طرفان سهڪار نه ڪئي وئي آهي. |
| 8 | MSISDN اصلي پتو سپورٽ نه آهي | MSISDN اصلي پتو سپورٽ نه آهي. |
| 9 | GSM وڌايو ويو سپورٽ نه ڪئي وئي | GSM وڌايو ويو سپورٽ نه ڪئي وئي. |
| 10 | يونيڪوڊ سپورٽ ناهي | يونيڪوڊ سپورٽ ناهي. |
| 11 | اسٽيٽس رپورٽ سپورٽ ناهي | اسٽيٽس رپورٽ سپورٽ ناهي. |
| 12 | گهربل صلاحيت جي حمايت نه ڪئي وئي آهي | پيغام موڪلڻ لاءِ گهربل صلاحيت (مٿين کان سواءِ) سپورٽ نه ڪئي وئي آهي. |
| 13 | مواد فراهم ڪندڙ وڌ ۾ وڌ throttling جي شرح وڌي وئي آهي | خدمت فراهم ڪندڙ ايس ايم ايس پيغام موڪلي رهيو آهي LINK موبلٽي تي تمام تيز. |
| 14 | پروٽوڪول ID اڪائونٽ طرفان سهڪار نه آهي | پروٽوڪول ID سپورٽ ناهي. |
| 15 | ميسيج ڪنٽينشن جي حد وڌي وئي | گڏيل پيغامن جو تعداد درخواست ڪيل وڌ کان وڌ تعداد کان وڌيڪ آھي. |
| 16 | ميسيج روٽ ڪرڻ ۾ ناڪام. | LINK موبائيلٽي پيغام کي روٽ ڪرڻ جي قابل نه هئي. |
| 17 | منع ٿيل مدت | وقت جي دوران پيغام موڪلڻ جي اجازت ناهي |
| 18 | خدمت فراهم ڪندڙ جي اڪائونٽ تي تمام گهٽ بيلنس | تمام گھٽ بيلنس جي ڪري سروس فراهم ڪندڙ کي بلاڪ ڪيو ويو آھي |
| 50 | جزوي ڪاميابي | جزوي ڪاميابي جڏهن ڪيترن ئي وصول ڪندڙن ڏانهن ايس ايم ايس پيغام موڪلڻ. |
| 99 | اندروني سرور جي غلطي | ٻي لنڪ موبائيلٽي نقص، وڌيڪ معلومات لاءِ LINK موبلٽي سپورٽ سان رابطو ڪريو. |
| 100 | غلط منزل جو پتو | منزل جو پتو (MSISDN، يا عرف) غلط آهي. |
| 102 | غلط حوالو (ڳنڍيل) ID | حوالو ID غلط آهي، ٿي سگهي ٿو ته حوالو ID اڳ ۾ ئي استعمال ٿيل هجي، تمام پراڻي يا نامعلوم. |
| 103 | غلط اڪائونٽ جو نالو | اڪائونٽ جو نالو غلط آهي. |
| 105 | غلط سروس ميٽا ڊيٽا | سروس ميٽا ڊيٽا غلط آهي. |
| 106 | غلط اصلي پتو | اصلي پتو غلط آهي. |
| 107 | غلط الفانمياتي اصلي پتو | الفانومري جي اصلي پتو غلط آهي. |
| 108 | غلط صحيح وقت | صحيح وقت غلط آهي. |
| 109 | غلط ترسيل وقت | پهچائڻ وقت غلط آهي. |
| 110 | غلط پيغام مواد / استعمال ڪندڙ ڊيٽا | صارف ڊيٽا، يعني ايس ايم ايس پيغام، غلط آهي. |
| 111 | غلط پيغام ڊگھائي | ايس ايم ايس پيغام جي ڊيگهه غلط آهي. |
| 112 | غلط استعمال ڪندڙ ڊيٽا هيڊر | استعمال ڪندڙ ڊيٽا هيڊر غلط آهي. |
| 113 | غلط ڊيٽا ڪوڊنگ اسڪيم | DCS غلط آهي. |
| 114 | غلط پروٽوڪول ID | PID غلط آهي. |
| 115 | غلط اسٽيٽس رپورٽ جا جھنڊا | اسٽيٽس رپورٽ جا جھنڊا غلط آھن. |
| 116 | غلط TON | پيدا ڪندڙ TON غلط آهي. |
| 117 | غلط جampنالو | سيampaign نالو غلط آهي. |
| 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 |
| +460702233445 | 46702233445 |
| 46 (0) 702233445 | 46702233445 |
| 46070-2233445 | 46702233445 |
| 0046702233445 | 46702233445 |
| +46(0)702233445aaa | 46702233445 |
| 336005199999 | 2626005199999 (فرانسيسي نمبر هڪ DOM-TOM نمبر ۾ ترجمو ڪيو ويو) |
اضافي طور تي، اهو ممڪن آهي ته چونڊيل مارڪيٽ لاء قومي فون نمبرن کي اجازت ڏيو. جڏهن هي فيچر فعال ڪيو وڃي ته ٻين مارڪيٽن لاءِ ڪي به بين الاقوامي نمبر لازمي طور تي موڪليا وڃن هڪ ابتدائي `+' نشاني سان انهن کي منتخب ٿيل مارڪيٽ کان ڌار ڪرڻ لاءِ.
هيٺ ڏنل ڪيترائي مثال آهنampسويڊن (ملڪ ڪوڊ 46) کي قومي نمبرن لاءِ ڊفالٽ مارڪيٽ طور استعمال ڪرڻ وقت سڌارن جا les.
| جمع ٿيل منزل جو پتو | درست ڪيل منزل جو پتو |
| 0702233445 | 46702233445 |
| 070-2233 445 | 46702233445 |
| 070.2233.4455 | 46702233445 |
| 460702233445 | 46702233445 |
| +460702233445 | 46702233445 |
| +458022334455 | 458022334455 |
| 45802233445 | غلط آهي ڇاڪاڻ ته '+' نشان غائب آهي |
نوٽ ڪريو ته درست MSISDN استعمال ڪيو ويندو LINK Mobility ۽ ان کي واپس ڪيو ويندو ترسيل رپورٽن ۾.
مھرباني ڪري رابطو ڪريو LINK Mobility support وڌيڪ معلومات لاءِ.
8.2 ڪردار مٽائڻ
ڪردار جي بدلي هڪ اختياري خصوصيت آهي جيڪا LINK موبلٽي سپورٽ ذريعي فعال ٿي سگهي ٿي جيڪڏهن درخواست ڪئي وڃي.
هي مضمون غير GSM الفابيٽ جي اکرن کي يوزر ڊيٽا (SMS ٽيڪسٽ) جي برابر GSM الفابيٽ جي اکرن ۾ ترجمو ڪندو جڏهن DCS کي سيٽ ڪيو ويندو ”GSM“ (17). مثال لاءِample “Seqüência de teste em Português” ترجمو ڪيو ويندو “Seqüencia de teste em Portugues”.
9. پهچائڻ جون رپورٽون
خدمت فراهم ڪندڙ، جيڪڏهن مهيا ڪيل هجي، موڪليل ايم ٽي پيغامن لاءِ ايس ايم ايس پيغام پهچائڻ جي رپورٽ يا ترسيل اطلاعن جي درخواست ڪري سگهي ٿو. اهي رپورٽون آپريٽر ايس ايم ايس سي ۾ ان وقت شروع ٿينديون آهن جڏهن MT پيغام يا ته ٽارگيٽ ڪيل صارف تائين پهچايو ويندو آهي يا حذف ڪيو ويندو آهي، مثال طور، ختم ٿي چڪو آهي يا، ڪنهن سبب جي ڪري، روٽيبل نه آهي.
صرف ايس ايم ايس پيغام جي آخري صورتحال سروس فراهم ڪندڙ کي ٻڌايو ويندو آهي، يعني، پهچائي يا ختم ڪيو ويو. صرف هڪ رپورٽ في ايم ٽي پيغام ٺاهي وئي آهي. ختم ٿيل اسٽيٽس سان، هڪ سبب ڪوڊ لاڳو ٿي سگھي ٿو. اهو سبب ڪوڊ بيان ڪري ٿو ايس ايم ايس پيغام پهچائڻ جو سبب نه.
رپورٽون LINK موبلٽي ذريعي روٽ ڪيون وينديون آهن ۽ HTTP پروٽوڪول استعمال ڪندي سروس فراهم ڪندڙ ڏانهن موڪلي وينديون آهن.
رپورٽون حاصل ڪرڻ لاء، خدمت فراهم ڪندڙ کي لاڳو ڪرڻ جي ضرورت آهي example a Java Servlet يا ASP.NET صفحو. ٻئي وصول ڪندا HTTP GET يا پوسٽ درخواستون.
پيرا ميٽر
درخواست ھيٺ ڏنل پيراگراف شامل آھن:
| پيرا ميٽر | قسم | M/O/I* | ڊفالٽ قدر | وڌ ۾ وڌ ڊگھائي | وصف |
| MessageId | تار | M | – | 22 | ايم ٽي پيغام جو پيغام ID جيڪو هن رپورٽ سان لاڳاپيل آهي. |
| منزل جو پتو | تار | M | – | 40 | صارفين جو MSISDN، يعني اصل MT پيغام جي منزل جو پتو. |
| اسٽيٽس ڪوڊ | عدد | M | 1 | اسٽيٽس ڪوڊ اشارو ڪري ٿو ايم ٽي پيغام جي ڪيفيت. قابل اطلاق اسٽيٽس ڪوڊ آهن: 0 - پهچائڻ 2 - ختم ٿيل (سبب ڪوڊ لاڳو ٿئي ٿو) |
|
| ٽائم اسٽيٽamp | تار | M | – | 20 | وقت جو اشارو ڪيو ويو جڏهن ترسيل رپورٽ LINK موبلٽي پاران ملي ٿي. ٽائيم زون جو ٽائيم زونamp CET يا CEST آهي (اونهاري جي وقت سان جيئن EU لاءِ وضاحت ڪئي وئي آهي). فارميٽ: yyyyMMdd HH:mm:ss. |
| آپريٽر | تار | M | – | 100 | ايس ايم ايس پيغام موڪلڻ وقت استعمال ٿيل آپريٽر جو نالو يا ايس ايم ايس پيغام موڪلڻ وقت استعمال ٿيل اڪائونٽ جو نالو. دستياب آپريٽرز جي هڪ فهرست LINK موبلٽي سپورٽ پاران مهيا ڪئي وئي آهي. |
| سبب ڪوڊ | عدد | O | – | 3 | سبب ڪوڊ ظاهر ڪري ٿو ته پيغام ختم ٿيل اسٽيٽس ۾ ڇو ختم ٿيو. قابل اطلاق سبب ڪوڊ آهن: 100 - ختم ٿي ويو 101 - رد ٿيل 102 - فارميٽ جي غلطي 103 - ٻي غلطي 110 - رڪن نامعلوم 111 - سبسڪرائبر منع ٿيل 112 - رڪنيت نه ڏني وئي 113 - رڪن دستياب ناهي 120 - ايس ايم ايس سي ناڪامي 121 - ايس ايم ايس سي جي گنجائش 122 - ايس ايم ايس سي رومنگ 130 - هينڊ سيٽ جي غلطي 131 - هينڊ سيٽ ميموري وڌي وئي آپريٽر جي انضمام سان رويو مختلف ٿي سگھي ٿو. |
| OperatorTimeStamp | تار | O | – | 20 | وقت جو اشارو ڪيو ويو جڏهن رپورٽ آپريٽر جي ايس ايم ايس سي ۾ شروع ڪئي وئي (جيڪڏهن آپريٽر طرفان مهيا ڪيل هجي). ٽائيم زون جو ٽائيم زونamp CET يا CEST آهي (اونهاري جي وقت سان جيئن EU لاءِ وضاحت ڪئي وئي آهي). فارميٽ: yyyyMMdd HH:mm:ss. |
| اسٽيٽس ٽيڪسٽ | تار | O | – | 255 | آپريٽر کان اضافي معلومات لاءِ جڳھ ھولڊر، مثال طور واضح ٽيڪسٽ وضاحت جي اسٽيٽس/ سبب. آپريٽر جي انضمام سان رويو مختلف ٿي سگھي ٿو. |
| رابطي جي سڃاڻپ | تار | O | – | 100 | رابطي جي ID SendRequest يا SendTextRequest ۾ مهيا ڪئي وئي آهي. |
| آپريٽر نيٽ ورڪ ڪوڊ | عدد | O | – | 6 | آپريٽر جو موبائل نيٽ ورڪ ڪوڊ (MCC + MNC). |
* M = لازمي، O = اختياري، I = نظرانداز ڪيو ويو.
سروس فراهم ڪندڙ کي ھدف سان LINK موبليٽي مهيا ڪرڻي آھي URL ترسيل رپورٽن لاءِ (اختياري طور تي HTTP بنيادي تصديق لاءِ سندون شامل آهن). خدمت فراهم ڪندڙ چونڊي سگھي ٿو ڪھڙو ترجيح HTTP طريقو استعمال ڪرڻ لاءِ:
HTTP پوسٽ (سفارش ٿيل)
HTTP حاصل.
Example HTTP GET استعمال ڪندي (ڪاميابي سان پهچايو):
https://user:password@www.serviceprovider.com/receivereport?%20MessageId=122&DestinationAddress=46762050312&Operator=Vodafone&TimeStamp=20100401%2007%3A47%3A44&StatusCode=0
Example HTTP GET استعمال ڪندي (ترسيل نه ڪيو ويو، آپريٽر فراهم ڪيو آهي timestamp واقعي لاء):
پيراگراف آهن 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 درخواست:
پوسٽ /context/app HTTP/1.1
مواد جو قسم: ايپليڪيشن / x-www-form-urlencoded؛ charset=utf-8
ميزبان: سرور: پورٽ
مواد-ڊگھائي: xx
MessageId=213123213&Destination Address=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. Link Mobility هميشه ڪوشش ڪري ٿي پراڻا پيغام پهرين پهچائڻ جي، جيتوڻيڪ خدمت فراهم ڪندڙ ڏانهن موڪليل پيغامن جي انفرادي ترتيب جي ضمانت نه آهي. پيغامن جي ٻيهر ڪوشش جي قطار مان رد ٿيڻ جو بنيادي سبب ٻن سببن مان هڪ آهي: يا ته پيغام TTL ختم ٿئي ٿو يا (نظرياتي طور) ٻيهر ڪوشش جي قطار مڪمل ٿي وڃي ٿي. TTL آپريٽر آهي ۽ اڪائونٽ انحصار، يعني، آپريٽر ۽ يا پيغام جي قسم جي لحاظ کان مختلف ٿي سگهن ٿا، مثال طور، پريميئم ايس ايم ايس يا معياري شرح ايس ايم ايس پيغام.
هڪ سروس فراهم ڪندڙن کي ٻيهر ڪوشش ڪرڻ سان گڏ MT پيغام جي منفرد ID چيڪ ڪرڻ گهرجي انهي کي محفوظ ڪرڻ لاءِ ته پيغام اڳ ۾ ئي نه مليو آهي.
خدمت فراهم ڪندڙ لاءِ ضروري آهي ته انهن سادي ضابطن تي عمل ڪري جڏهن ڪا غلطي ٿئي ٿي جڏهن ترسيل رپورٽ جي پروسيسنگ دوران غلطي جو سبب هي آهي: عارضي، مثال طور ڊيٽابيس دستياب ناهي، هڪ NAK واپس ڪيو وڃي. LINK Mobility پيغام کي ٻيهر موڪليندو.
مستقل ۽ ٻيهر ڪوشش ڪرڻ جي ڪوشش ممڪن آهي ته ساڳئي قسم جو مسئلو پيدا ٿئي، هڪ ACK کي واپس ڪيو وڃي. مثال لاءِampلي، جڏهن پيغام صحيح طرح پارس نه ٿي سگهيو يا اڻڄاتل رن ٽائم جي غلطي جو سبب بڻيو.
ان مطابق عمل ڪرڻ يقيني بڻائيندو ته بار بار موڪلڻ واري رپورٽ کي رد ڪرڻ جي ڪري ڪو به بلاڪنگ يا ٿرو پُٽ خرابي نه ٿئي.
10. لاڳو ڪرڻ جا طريقا
1. اهو توهان جي استعمال ڪرڻ ممڪن آهي web برائوزر API ڏانهن درخواستون جمع ڪرڻ لاء. هي بغير ڪنهن ترقياتي اوزار جي خدمتن کي ڳولڻ ۽ جائزو وٺڻ تمام آسان بڻائي ٿو.
2. ڪروم يا فائر فاڪس جي سفارش ڪئي وئي آهي هڪ واڌ سان گڏ جيئن ته JSONView خوبصورت فارميٽ ٿيل JSON ڏيکارڻ لاءِ.
3. اسان استعمال ڪيو آهي SoapUI پوسٽ، بنيادي تصديق ۽ خام HTTP درخواست ۽ جوابي پيغامن جي چڪاس لاءِ.
4. سيURL اوزار بنيادي تصديق سان پوسٽ درخواستون جمع ڪرائڻ لاءِ ڪارائتو آهي. ڏسو exampهيٺان.
curl پوسٽ \
-H "مواد جو قسم: ايپليڪيشن/x-www-form-urlانڪوڊ ٿيل"\
-H "اختيار: بنيادي am9objpjaGFuZ2VtZSA=" \
https://europe.ipx.com/restapi/v1/sms/send \
ڊيٽا "منزل جو پتو = 46123456789 ۽ پيغام جو متن = هيلو + ورلڊ٪ 21"
_______________
ذاتي ٿيل ڪميونيڪيشن کي تبديل ڪرڻ
دستاويز / وسيلا
 |
LINK موبلٽي پليپمينٽ گائيڊ REST API SMS [pdf] استعمال ڪندڙ ھدايت موبليٽي امپليمينٽيشن گائيڊ REST API SMS, Mobility, Implementation Guide REST API SMS, REST API SMS, API SMS, SMS |
