ايس ايم ايس API، SMPP API MS شيڊيولر API
استعمال ڪندڙ ھدايت
ايس ايم ايس API، SMPP API MS شيڊيولر API
| تبديل ٿيل: | 6/24/2025 |
| نسخو: | 1.7 |
| ليکڪ: | ڪيني ڪولينڊر نورڊن، ڪي سي اين |
هي دستاويز صرف نامزد ڪيل وصول ڪندڙ لاءِ آهي ۽ شايد ان ۾ امتيازي، ملڪيتي، يا ٻي صورت ۾ خانگي معلومات هجي. جيڪڏھن توھان اھو غلطي سان حاصل ڪيو آھي، مھرباني ڪري فوري طور تي موڪليندڙ کي مطلع ڪريو ۽ اصل کي حذف ڪريو. توھان جي طرفان دستاويز جو ڪو ٻيو استعمال منع ٿيل آھي.
تاريخ تبديل ڪريو
| Rev | تاريخ | By | پوئين رليز کان تبديليون |
| 1.0 | 2010-03-16 | ڪي سي اين | ٺاهيل |
| 1. | 2019-06-11 | ٽي پي اي | اپڊيٽ ٿيل LINK لوگو |
| 1. | 2019-09-27 | PNI | SMPP 3.4 وضاحتن جو حوالو شامل ڪيو ويو |
| 1. | 2019-10-31 | EP | جائزي جي مدت بابت مشاهدو tag |
| 1. | 2020-08-28 | ڪي سي اين | سپورٽ ٿيل TLS ورزن بابت معلومات شامل ڪئي وئي |
| 2. | 2022-01-10 | ڪي سي اين | پهچائڻ جي رپورٽن جي حوالي سان اضافي معلومات شامل ڪئي وئي TLS 1.3 جي حوالي سان تازه ڪاري معلومات |
| 2. | 2025-06-03 | GM | نتيجو ڪوڊ 2108 شامل ڪيو ويو |
| 2. | 2025-06-24 | AK | شامل ٿيل ڪوٽا |
تعارف
LINK موبليٽي 2001 کان هڪ ايس ايم ايس ڊسٽريبيوٽر آهي ۽ ٻنهي آپريٽرز ۽ ڪنيڪشن ايگريگيٽرن سان ڪم ڪرڻ ۾ تمام گهڻو تجربو آهي. هي پليٽ فارم وڏي ٽرئفڪ جي مقدار کي سنڀالڻ، اعلي دستيابي کي برقرار رکڻ ۽ ڪيترن ئي ڪنيڪشن ذريعي ٽرئفڪ کي آسان ڪرڻ لاء ٺهيل آهي.
هي دستاويز SMSC-پليٽ فارم جي SMPP انٽرفيس کي بيان ڪري ٿو ۽ ڪهڙا پيرا ميٽر ۽ ڪمانڊ گهربل آهن ۽ ڪهڙا پيرا ميٽر سپورٽ ٿيل آهن.
هي دستاويز مخصوص استعمال جي ڪيسن کي سنڀاليندو نه جيئن ته گڏيل پيغام، WAPpush، Flash SMS، وغيره. انهن ڪيسن بابت وڌيڪ معلومات سپورٽ سان رابطو ڪندي مهيا ڪري سگهجي ٿي.
سپورٽ ڪيل حڪم
LINK موبيلٽي جي سرور کي SMPP 3.4 طور سمجهيو وڃي. سرڪاري وضاحتن تي ڳولي سگھجي ٿو https://smpp.org/SMPP_v3_4_Issue1_2.pdf.
سڀ طريقا سپورٽ نه آھن، ۽ سڀ اختلاف ھيٺ بيان ڪيا ويا آھن.
4.1 پابند
ھيٺ ڏنل پابند حڪمن جي حمايت ڪئي وئي آھي.
- ٽرانسميٽر
- ٽرانسائيور
- وصول ڪندڙ
گهربل پيٽرولر:
- system_id - حمايت مان حاصل ڪيل
- پاسورڊ - حمايت مان حاصل ڪيل
اختياري پيراگراف:
- addr_ton - ڊفالٽ قيمت جيڪڏهن TON جمع ڪرڻ دوران نامعلوم تي مقرر ڪئي وئي آهي.
- addr_npi - ڊفالٽ قيمت جيڪڏهن NPI جمع ڪرڻ دوران نامعلوم تي مقرر ڪئي وئي آهي.
غير معاون پيرا ميٽر:
- address_range
4.2 بند ڪريو
Unbind حڪم جي حمايت ڪئي وئي آهي.
4.3 انڪوائري لنڪ
انڪوائري لنڪ ڪمانڊ سپورٽ ڪئي وئي آهي ۽ هر 60 سيڪنڊن کي سڏيو وڃي ٿو.
4.4 جمع ڪرايو
جمع ڪرڻ جو طريقو پيغام پهچائڻ لاء استعمال ڪيو وڃي.
گهربل پيٽرولر:
- ذريعو_addr_ton
- ذريعو_addr_npi
- source_addr
- dest_addr_ton
- dest_addr_npi
- dest_addr
- esm_class
- ڊيٽا_ڪوڊنگ
- sm_length
- مختصر_پيغام
غير معاون پيرا ميٽر:
- خدمت جو قسم
- protocol_id
- priority_flag
- شيڊول_ڊليوري_وقت
- بدلي_جي_پريزينٽ_پرچم
- sm_default_msg_id
نوٽ اهو پيل لوڊ tag سپورٽ نه ڪئي وئي آهي ۽ هر ڪال تي صرف هڪ ايس ايم ايس پهچائي سگهجي ٿو ۽ اها سفارش ڪئي وئي ته validity_period tag گھٽ ۾ گھٽ 15 منٽ ڊگهو آھي.
4.4.1 تجويز ڪيل TON ۽ NPI
ھيٺ ڏنل TON ۽ NPI استعمال ڪيو وڃي جڏھن پيغام موڪلڻ وقت موڪلڻ حڪم استعمال ڪندي.
4.4.1.1 ذريعو
سورس ايڊريس لاءِ هيٺ ڏنل TON ۽ NPI جو مجموعو سپورٽ ٿيل آهي. ٻيا سڀئي مجموعا غلط سمجهيا ويندا. جيڪڏهن TON نامعلوم (0) تي سيٽ ڪيو ويو آهي ته بائنڊ ڪمانڊ مان ڊفالٽ TON استعمال ڪيو ويندو. جيڪڏهن NPI نامعلوم (0) تي سيٽ ڪيو ويو آهي ته بائنڊ ڪمانڊ مان ڊفالٽ NPI استعمال ڪيو ويندو.
| ٽون | اين پي آئي | وصف |
| عددي عددي (5) | اڻڄاتل (0) آئي ايس ڊي اين (1) |
الفانمرڪ موڪليندڙ متن جي طور تي علاج ڪيو ويندو |
| بين الاقوامي (1) | اڻڄاتل (0) آئي ايس ڊي اين (1) |
MSISDN طور علاج ڪيو ويندو |
| قومي (2) نيٽ ورڪ مخصوص (3) سبسڪرائبر نمبر (4) مختصر (6) |
اڻڄاتل (0) آئي ايس ڊي اين (1) قومي (8) |
ملڪ جي مخصوص مختصر نمبر طور علاج ڪيو ويندو. |
4.4.1.2 منزل
هيٺين TON ۽ NPI مجموعن کي منزل پتي لاءِ سپورٽ ڪيو ويو آهي. ٻيا سڀ مجموعا غلط سمجھيا ويندا. بائنڊ ڪمانڊ مان ڊفالٽ TON استعمال ڪيو ويندو جيڪڏھن TON مقرر ٿيل آھي نامعلوم (0). بائنڊ ڪمانڊ مان ڊفالٽ NPI استعمال ڪيو ويندو جيڪڏھن NPI مقرر ٿيل آھي نامعلوم (0).
| ٽون | اين پي آئي | وصف |
| بين الاقوامي (1) | اڻڄاتل (0) آئي ايس ڊي اين (1) |
MSISDN طور علاج ڪيو ويندو |
4.4.2 سپورٽ ٿيل انڪوڊنگ
ھيٺيون انڪوڊنگز سپورٽ آھن. X ڪنهن به قدر تي مشتمل ٿي سگھي ٿو.
| ڊي سي ايس | انڪوڊنگ |
| 0xX0 | ڊفالٽ GSM الفابيٽ واڌ سان |
| 0xX2 | 8-bit بائنري |
| 0xX8 | UCS2 (ISO-10646-UCS-2) |
ڪوٽا
5.1 ڪوٽا ختمview
ڪوٽا ايس ايم ايس پيغامن جي وڌ ۾ وڌ تعداد کي بيان ڪري ٿو جيڪي هڪ مخصوص وقت جي وقفي اندر موڪلي سگهجن ٿا (جهڙوڪ في ڏينهن، هفتي، مهيني، يا غير معين مدت تائين). هر ڪوٽا منفرد طور تي ڪوٽا آئي ڊي (UUID) ذريعي سڃاڻپ ڪئي ويندي آهي ۽ گراهڪ جي ٽائيم زون جي مطابق ري سيٽ ڪئي ويندي آهي. ڪوٽا ملڪ، علائقي، يا ڊفالٽ سطح تي ڪوٽا پرو ذريعي تفويض ڪري سگهجن ٿا.file. ڪوٽا کي ڪوٽا ميپنگ استعمال ڪندي متحرڪ طور تي تفويض ڪري سگهجي ٿو. هي هڪ والدين ڪوٽا آئي ڊي (UUID) ۽ هڪ منفرد ڪوٽا ڪي (مثال طور، موڪليندڙ يا استعمال ڪندڙ) کي هڪ مخصوص ڪوٽا آئي ڊي ڏانهن نقشو ڪري ٿو.
ڪوٽا توهان جي مقامي مدد، توهان جي مقرر ڪيل اڪائونٽ مئنيجر يا جيڪڏهن ڪجهه به بيان نه ڪيو ويو آهي ته ڊفالٽ جي مطابق مقرر ڪيو ويندو آهي.
5.2 اسٽيٽس 106 - ڪوٽا وڌي ويو
هڪ ايس ايم ايس پيغام کي اسٽيٽس ڪوڊ 106 ("ڪوٽا کان وڌيڪ") سان بلاڪ ڪري سگهجي ٿو جڏهن:
- پيغام موجوده وقفي اندر پنهنجي لاڳاپيل ڪوٽا آئي ڊي لاءِ مقرر ڪيل حد کان وڌيڪ آهي.
- منزل واري ملڪ يا علائقي کي ڪو به ڪوٽا مقرر نه ڪيو ويو آهي (يعني، پرو ۾ هڪ خالي ڪوٽا ميپنگ سان واضح طور تي بلاڪ ڪيو ويو آهي).file).
- ڪو به ملندڙ ڪوٽا ناهي ۽ ڪو به ڊفالٽ ڪوٽا بيان نه ڪيو ويو آهي، جنهن جي نتيجي ۾ رد ڪيو ويندو آهي.
انهن حالتن ۾، سسٽم گراهڪ يا منزل تي ٻڌل حدون لاڳو ڪرڻ ۽ غلط استعمال کان بچڻ لاءِ وڌيڪ پيغام جي پروسيسنگ کي روڪي ٿو.
پهچائڻ جي رپورٽ
صرف ڪامياب / ناڪامي نتيجن سان گڏ ڪو به يا حتمي ترسيل سپورٽ نه آهي.
ترسيل رپورٽ تي فارميٽ: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx مڪمل ٿيڻ جي تاريخ: yyMMddHHmm اسٽيٽ:
حالت ۾ موجود قدر:
- DELIVRD
- ختم ٿي ويو
- رد ڪيو
- UNDELIV
- حذف ٿيل
6.1 توسيع ٿيل رپورٽ فارميٽ
ترسيل رپورٽن ۾ توسيع ٿيل معلومات شايد توهان جي سيلز نمائندي سان رابطي ۾ درخواست ڪئي وڃي.
پهچائڻ جي رپورٽ تي فارميٽ: سڃاڻپ: xx
yyMMddHHmm مڪمل ٿيڻ جي تاريخ: yyMMddHHmm اسٽيٽس: غلطي: متن:
حالت ۾ موجود قدر:
- DELIVRD
- ختم ٿي ويو
- رد ڪيو
- UNDELIV
- حذف ٿيل
"ذيلي" ۽ "dlvrd" فيلڊ هميشه 000 تي سيٽ ڪيو ويندو، ۽ "ٽيڪسٽ" فيلڊ هميشه خالي هوندو.
"غلطي" فيلڊ لاءِ قدرن لاءِ باب غلطي ڪوڊ ڏسو.
سپورٽ ٿيل TLS ورزن
TLS 1.2 يا TLS 1.3 گھربل آھي SMPP تي سڀني TLS ڪنيڪشن لاءِ.
TLS 1.0 ۽ 1.1 لاءِ سپورٽ 2020-11-15 کان بند ڪئي وئي آهي. TLS جا نسخا 1.0 ۽ 1.1 پراڻا پروٽوڪول آهن جن کي ختم ڪيو ويو آهي ۽ انٽرنيٽ ڪميونٽي ۾ سيڪيورٽي خطرن جي طور تي سمجهيا وڃن ٿا.
LINK سختي سان TLS استعمال ڪرڻ جي صلاح ڏين ٿا جيڪڏهن اڄڪلهه اڻ ڳجهو SMPP ڪنيڪشن استعمال ٿي رهيا آهن. 2020-09-01 تائين LINK پاران اڻ ڳڻي SMPP ڪنيڪشن ختم ڪيا ويا، ۽ مستقبل ۾ ختم ڪيا ويندا. غير انڪوڊ ٿيل ڪنيڪشن کي ختم ڪرڻ جي تاريخ اڃا تائين طئي نه ڪئي وئي آهي.
TLS لاءِ SMPP سرور ڏانهن ڪنيڪشن بندرگاهه 3601 تي بندرگاهه 3600 تي غير انڪريپٽ جي بدران آهي.
توھان اڃا تائين TLS استعمال ڪري سگھو ٿا جيتوڻيڪ توھان جي SMPP عمل درآمد TLS کي Stunnel استعمال ڪندي سپورٽ نٿو ڪري، ڏسو https://www.stunnel.org/
نقص ڪوڊ
هيٺ ڏنل نقص ڪوڊس جواب ڏئي سگھن ٿا غلطي فيلڊ ۾ جيڪڏھن فيلڊ فعال آھي.
| نقص ڪوڊ | وصف |
| 0 | اڻڄاتل غلطي |
| 1 | عارضي رستي جي غلطي |
| 2 | مستقل رستي جي غلطي |
| 3 | وڌ ۾ وڌ throttling وڌي ويو |
| 4 | وقت ختم ٿي ويو |
| 5 | آپريٽر نامعلوم غلطي |
| 6 | آپريٽر جي غلطي |
| 100 | خدمت نه ملي |
| 101 | استعمال ڪندڙ نه مليو |
| 102 | اڪائونٽ نه مليو |
| 103 | غلط پاسورڊ |
| 104 | ٺاھ جوڙ جي غلطي |
| 105 | اندروني غلطي |
| 106 | ڪوٽا وڌي ويو |
| 200 | OK |
| 1000 | موڪليو ويو |
| 1001 | پهچايو ويو |
| 1002 | ختم ٿيل |
| 1003 | حذف ٿيل |
| 1004 | موبائل ڀريل |
| 1005 | قطار |
| 1006 | نه پهچايو ويو |
| 1007 | ترسيل، چارج دير سان |
| 1008 | چارج ٿيل، پيغام نه موڪليو ويو |
| 1009 | چارج ٿيل، پيغام نه پهچايو ويو |
| 1010 | ختم ٿيل، آپريٽر پهچائڻ جي رپورٽ جي غير موجودگي |
| 1011 | چارج ٿيل، پيغام موڪليو ويو (آپريٽر ڏانهن) |
| 1012 | ريموٽ قطار ۾ |
| 1013 | آپريٽر ڏانهن نياپو موڪليو ويو، چارج ڪرڻ ۾ دير ٿي |
| 2000 | غلط ذريعو نمبر |
| 2001 | مختصر نمبر ماخذ طور سپورٽ نه ڪيو ويو آهي |
| 2002 | الفا ماخذ طور سپورٽ نه ڪئي وئي آهي |
| 2003 | MSISDN ماخذ نمبر جي طور تي سپورٽ نه ڪئي وئي آهي |
| 2100 | مختصر نمبر منزل جي طور تي سپورٽ نه آهي |
| 2101 | الفا منزل جي طور تي سپورٽ نه ڪئي وئي آهي |
| 2102 | MSISDN منزل جي طور تي سپورٽ نه ڪئي وئي آهي |
| 2103 | آپريشن بند ڪيو ويو |
| 2104 | اڻڄاتل رڪن |
| 2105 | منزل بلاڪ |
| 2106 | نمبر غلطي |
| 2107 | منزل عارضي طور تي بلاڪ ڪئي وئي |
| 2108 | غلط منزل |
| 2200 | چارج جي غلطي |
| 2201 | سبسڪرائبر وٽ گهٽ بيلنس آهي |
|
2202 |
وڌيڪ چارج ڪرڻ تي سبسڪرائيبر کي روڪيو ويو (پريميئم)
پيغام |
|
2203 |
سبسڪرائيبر تمام ننڍو آهي (هن خاص لاءِ
مواد) |
| 2204 | پريپيڊ سبسڪرائبر جي اجازت ناهي |
| 2205 | خدمت سبسڪرائبر طرفان رد ڪئي وئي |
| 2206 | سبسڪرائبر ادائگي جي سسٽم ۾ رجسٽر ٿيل نه آهي |
| 2207 | سبسڪرائبر وڌ کان وڌ بيلنس تي پهچي چڪو آهي |
| 2208 | آخر صارف جي تصديق جي ضرورت آهي |
| 2300 | واپس ڪيل |
|
2301 |
غير قانوني يا گم ٿيل هجڻ جي ڪري واپس نه ٿي سگهيو.
ايم ايس آءِ ايس ڊي اين |
| 2302 | ميسيج آئي ڊي گم ٿيڻ سبب رقم واپس نه ٿي سگھي |
| 2303 | واپسي لاءِ قطار ۾ بيٺو |
| 2304 | واپسي جو وقت ختم |
| 2305 | واپسي جي ناڪامي |
| 3000 | GSM انڪوڊنگ سپورٽ نه آهي |
| 3001 | UCS2 انڪوڊنگ سپورٽ نه آهي |
| 3002 | بائنري انڪوڊنگ سپورٽ نه آهي |
| 4000 | پهچائڻ جي رپورٽ جي حمايت نه ڪئي وئي آهي |
| 4001 | غلط پيغام جو مواد |
| 4002 | غلط ٽيرف |
| 4003 | غلط استعمال ڪندڙ ڊيٽا |
| 4004 | غلط استعمال ڪندڙ ڊيٽا هيڊر |
| 4005 | غلط ڊيٽا ڪوڊنگ |
| 4006 | غلط VAT |
| 4007 | منزل لاءِ اڻ سڌريل مواد |
دستاويز / وسيلا
 |
لنڪ موبلٽي ايس ايم ايس API، SMPP API MS شيڊيولر API [pdf] استعمال ڪندڙ ھدايت SMS API SMPP API MS Scheduler API، SMS API SMPP API، MS شيڊيولر API، شيڊيولر API، API |