एसएमएस एपीआई, एसएमपीपी एपीआई एमएस शेड्यूलर एपीआई
उपयोगकर्ता गाइड
एसएमएस एपीआई, एसएमपीपी एपीआई एमएस शेड्यूलर एपीआई
| संशोधित: | 6/24/2025 |
| संस्करण: | 1.7 |
| लेखक: | केनी कोलंडर नॉर्डेन, केसीएन |
यह दस्तावेज़ केवल निर्दिष्ट प्राप्तकर्ता के लिए है और इसमें विशेषाधिकार प्राप्त, स्वामित्व वाली या अन्यथा निजी जानकारी हो सकती है। यदि आपने इसे गलती से प्राप्त किया है, तो कृपया प्रेषक को तुरंत सूचित करें और मूल को हटा दें। आपके द्वारा दस्तावेज़ का कोई अन्य उपयोग निषिद्ध है।
इतिहास बदलें
| फिरना | तारीख | By | पिछले रिलीज से परिवर्तन |
| 1.0 | 2010-03-16 | केसीएन | बनाया था |
| 1. | 2019-06-11 | टीपीई | अपडेटेड लिंक लोगो |
| 1. | 2019-09-27 | PNI | एसएमपीपी 3.4 विनिर्देश के संदर्भ में जोड़ा गया |
| 1. | 2019-10-31 | EP | वैधता अवधि के बारे में अवलोकन tag |
| 1. | 2020-08-28 | केसीएन | समर्थित टीएलएस संस्करणों के बारे में जानकारी जोड़ी गई |
| 2. | 2022-01-10 | केसीएन | डिलीवरी रिपोर्ट के संबंध में अतिरिक्त जानकारी जोड़ी गई TLS 1.3 के संबंध में अद्यतन जानकारी |
| 2. | 2025-06-03 | GM | परिणाम कोड 2108 जोड़ा गया |
| 2. | 2025-06-24 | AK | जोड़ा गया कोटा |
परिचय
लिंक मोबिलिटी 2001 से एक एसएमएस वितरक है और ऑपरेटरों और कनेक्शन एग्रीगेटर्स दोनों के साथ काम करने का बहुत अनुभव है। इस प्लेटफ़ॉर्म को बड़े ट्रैफ़िक वॉल्यूम को संभालने, उच्च उपलब्धता बनाए रखने और कई कनेक्शनों के माध्यम से ट्रैफ़िक को रूट करना आसान बनाने के लिए डिज़ाइन किया गया है।
यह दस्तावेज़ SMSC-प्लेटफ़ॉर्म के लिए SMPP इंटरफ़ेस का वर्णन करता है और यह बताता है कि कौन से पैरामीटर और कमांड आवश्यक हैं और कौन से पैरामीटर समर्थित हैं।
यह दस्तावेज़ संयोजित संदेश, WAPpush, फ्लैश SMS आदि जैसे विशिष्ट उपयोग मामलों को नहीं संभालेगा। उन मामलों के बारे में अधिक जानकारी सहायता से संपर्क करके प्रदान की जा सकती है।
समर्थित आदेश
लिंक मोबिलिटी के सर्वर को SMPP 3.4 के रूप में माना जाना चाहिए। आधिकारिक विनिर्देश पर पाया जा सकता है https://smpp.org/SMPP_v3_4_Issue1_2.pdf.
सभी विधियां समर्थित नहीं हैं, और सभी अंतर नीचे निर्दिष्ट किए गए हैं।
4.1 बाँध
निम्नलिखित बाइंड कमांड समर्थित हैं।
- ट्रांसमीटर
- ट्रान्सीवर
- रिसीवर
आवश्यक पैरामीटर:
- system_id - समर्थन से प्राप्त
- पासवर्ड - समर्थन से प्राप्त किया गया
वैकल्पिक पैरामीटर:
- addr_ton - जमा करने के दौरान TON अज्ञात पर सेट होने पर डिफ़ॉल्ट मान।
- addr_npi - जमा करने के दौरान एनपीआई अज्ञात पर सेट होने पर डिफ़ॉल्ट मान।
असमर्थित पैरामीटर:
- पता_श्रेणी
4.2 अनबाइंड
अनबाइंड कमांड समर्थित है।
4.3 पूछताछ लिंक
इंक्वायरी लिंक कमांड समर्थित है और इसे हर 60 सेकंड में कॉल किया जाना चाहिए।
4.4 जमा करें
संदेश भेजने के लिए सबमिट विधि का उपयोग किया जाना चाहिए।
आवश्यक पैरामीटर:
- स्रोत_addr_ton
- स्रोत_addr_npi
- स्रोत_पता
- dest_addr_ton
- dest_addr_npi
- dest_addr
- esm_class
- data_coding
- sm_length
- छोटा सन्देश
असमर्थित पैरामीटर:
- सेवा प्रकार
- प्रोटोकॉल_आईडी
- प्राथमिकता_ध्वज
- शेड्यूल_डिलीवरी_टाइम
- बदलें_if_present_flag
- sm_default_msg_id
टिप्पणी वह पेलोड tag समर्थित नहीं है और प्रति कॉल केवल एक एसएमएस दिया जा सकता है और यह अनुशंसा की जाती है कि वैलिडिटी_पीरियड tag कम से कम 15 मिनट का मान है।
4.4.1 अनुशंसित टन और एनपीआई
सबमिट कमांड का उपयोग करके संदेश भेजते समय निम्नलिखित TON और NPI का उपयोग किया जाना चाहिए।
4.4.1.1 स्रोत
स्रोत पते के लिए निम्नलिखित TON और NPI संयोजन समर्थित हैं। अन्य सभी संयोजनों को अमान्य माना जाएगा। यदि TON अज्ञात (0) पर सेट है, तो डिफ़ॉल्ट TON from bind कमांड का उपयोग किया जाएगा। यदि NPI अज्ञात (0) पर सेट है, तो डिफ़ॉल्ट NPI from bind कमांड का उपयोग किया जाएगा।
| टन | एनपीआई | विवरण |
| अल्फ़ान्यूमेरिक (5) | अज्ञात (0) आईएसडीएन (1) |
अक्षरांकीय प्रेषक पाठ के रूप में माना जाएगा |
| अंतर्राष्ट्रीय (1) | अज्ञात (0) आईएसडीएन (1) |
एमएसआईएसडीएन के रूप में माना जाएगा |
| राष्ट्रीय (2) नेटवर्क विशिष्ट (3) ग्राहक संख्या (4) संक्षिप्त (6) |
अज्ञात (0) आईएसडीएन (1) राष्ट्रीय (8) |
देश विशिष्ट लघु संख्या के रूप में माना जाएगा। |
4.4.1.2 गंतव्य
निम्नलिखित TON और NPI संयोजन गंतव्य पते के लिए समर्थित हैं। अन्य सभी संयोजनों को अमान्य माना जाएगा। यदि TON अज्ञात (0) पर सेट है, तो बाइंड कमांड से डिफ़ॉल्ट TON का उपयोग किया जाएगा। यदि NPI अज्ञात (0) पर सेट है, तो बाइंड कमांड से डिफ़ॉल्ट NPI का उपयोग किया जाएगा।
| टन | एनपीआई | विवरण |
| अंतर्राष्ट्रीय (1) | अज्ञात (0) आईएसडीएन (1) |
एमएसआईएसडीएन के रूप में माना जाएगा |
4.4.2 समर्थित एनकोडिंग
निम्नलिखित एन्कोडिंग समर्थित हैं। X में कोई मान हो सकता है।
| डीसीएस | एन्कोडिंग |
| 0xX0 | विस्तार के साथ डिफ़ॉल्ट जीएसएम वर्णमाला |
| 0xX2 | 8-बिट बाइनरी |
| 0xX8 | UCS2 (आईएसओ-10646-यूसीएस-2) |
कोटा
5.1 कोटा खत्मview
कोटा एक निर्दिष्ट समय अंतराल (जैसे प्रति दिन, सप्ताह, माह, या अनिश्चित काल तक) में भेजे जा सकने वाले एसएमएस संदेशों की अधिकतम संख्या निर्धारित करता है। प्रत्येक कोटा एक कोटाआईडी (UUID) द्वारा विशिष्ट रूप से पहचाना जाता है और ग्राहक के समय क्षेत्र के अनुसार रीसेट किया जाता है। कोटा प्रो के माध्यम से देश, क्षेत्र या डिफ़ॉल्ट स्तर पर कोटा निर्धारित किया जा सकता है।fileकोटा मैपिंग का उपयोग करके कोटा को गतिशील रूप से भी निर्दिष्ट किया जा सकता है। यह एक पैरेंट कोटाआईडी (UUID) और एक विशिष्ट कोटा कुंजी (जैसे, प्रेषक या उपयोगकर्ता) को एक विशिष्ट कोटाआईडी से मैप करता है।
कोटा आपके स्थानीय समर्थन, आपके निर्दिष्ट खाता प्रबंधक या यदि कुछ निर्दिष्ट नहीं है तो डिफ़ॉल्ट रूप से निर्धारित किया जाता है।
5.2 स्थिति 106 – कोटा पार हो गया
एसएमएस संदेश को स्थिति कोड 106 (“कोटा पार हो गया”) के साथ तब ब्लॉक किया जा सकता है जब:
- संदेश वर्तमान अंतराल के भीतर अपने संगत कोटाआईडी के लिए निर्धारित सीमा को पार कर जाता है।
- गंतव्य देश या क्षेत्र को कोई कोटा निर्दिष्ट नहीं किया गया है (अर्थात, प्रो में शून्य कोटा मैपिंग के साथ स्पष्ट रूप से अवरुद्ध है)file).
- कोई मिलान कोटा नहीं है और कोई डिफ़ॉल्ट कोटा परिभाषित नहीं है, जिसके परिणामस्वरूप अस्वीकृति हुई।
इन मामलों में, सिस्टम ग्राहक या गंतव्य-आधारित सीमाओं को लागू करने और दुरुपयोग से बचने के लिए आगे संदेश प्रसंस्करण को रोकता है।
डिलीवरी रिपोर्ट
सफल/असफल परिणाम के साथ केवल कोई नहीं या अंतिम वितरण समर्थित हैं।
वितरण रिपोर्ट पर प्रारूप: आईडी: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx पूर्ण तिथि: yyMMddHHmm स्थिति:
स्थिति में उपलब्ध मान:
- डिलीवर
- खत्म हो चुका
- अस्वीकृत
- अनडेलिव
- हटाए गए
6.1 विस्तारित वितरण रिपोर्ट प्रारूप
डिलीवरी रिपोर्ट में विस्तृत जानकारी के लिए आपके बिक्री प्रतिनिधि से संपर्क करने का अनुरोध किया जा सकता है।
डिलीवरी रिपोर्ट का प्रारूप: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx उप:000 dlvrd:000 सबमिट तिथि:
yyMMddHHmm संपन्न तिथि: yyMMddHHmm स्टेट: गलती: मूलपाठ:
स्थिति में उपलब्ध मान:
- डिलीवर
- खत्म हो चुका
- अस्वीकृत
- अनडेलिव
- हटाए गए
"सब" और "डीएलवीआरडी" फ़ील्ड हमेशा 000 पर सेट रहेंगे, और "टेक्स्ट" फ़ील्ड हमेशा खाली रहेगा।
"त्रुटि" फ़ील्ड के मानों के लिए अध्याय त्रुटि कोड देखें।
समर्थित टीएलएस संस्करण
SMPP पर सभी TLS कनेक्शन के लिए TLS 1.2 या TLS 1.3 आवश्यक है।
टीएलएस 1.0 और 1.1 के लिए समर्थन 2020-11-15 से बंद कर दिया गया है। टीएलएस के संस्करण 1.0 और 1.1 पुराने प्रोटोकॉल हैं जिन्हें हटा दिया गया है और इंटरनेट समुदाय में सुरक्षा जोखिम के रूप में माना जाता है।
यदि आज अनएन्क्रिप्टेड SMPP कनेक्शन का उपयोग किया जा रहा है, तो LINK TLS का उपयोग करने की पुरज़ोर अनुशंसा करता है। अनएन्क्रिप्टेड SMPP कनेक्शन 2020-09-01 तक LINK द्वारा बहिष्कृत कर दिए गए हैं, और भविष्य में हटा दिए जाएंगे। अनएन्क्रिप्टेड कनेक्शन हटाने की तारीख अभी तय नहीं है।
टीएलएस के लिए एसएमपीपी सर्वर के लिए कनेक्शन पोर्ट 3601 पर अनएन्क्रिप्टेड के बजाय पोर्ट 3600 पर है।
आप अभी भी टीएलएस का उपयोग कर सकते हैं भले ही आपका एसएमपीपी कार्यान्वयन स्टनलाइन का उपयोग करके टीएलएस का समर्थन नहीं करता है, देखें https://www.stunnel.org/
त्रुटि कोड
यदि फ़ील्ड सक्षम है, तो त्रुटि फ़ील्ड में निम्न त्रुटि कोड का उत्तर दिया जा सकता है।
| त्रुटि कोड | विवरण |
| 0 | अज्ञात त्रुटि |
| 1 | अस्थायी रूटिंग त्रुटि |
| 2 | स्थायी रूटिंग त्रुटि |
| 3 | अधिकतम थ्रॉटलिंग पार हो गई |
| 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 | एमएसआईएसडीएन गंतव्य के रूप में समर्थित नहीं है |
| 2103 | संचालन अवरुद्ध |
| 2104 | अनजाने सब्सक्राइबर |
| 2105 | गंतव्य अवरुद्ध |
| 2106 | संख्या त्रुटि |
| 2107 | गंतव्य अस्थायी रूप से अवरुद्ध है |
| 2108 | अमान्य गंतव्य |
| 2200 | चार्जिंग त्रुटि |
| 2201 | सब्सक्राइबर का बैलेंस कम है |
|
2202 |
अधिक शुल्क लेने पर ग्राहक पर प्रतिबंध (प्रीमियम)
संदेशों |
|
2203 |
ग्राहक बहुत युवा है (इस विशेष के लिए
सामग्री) |
| 2204 | प्रीपेड ग्राहक की अनुमति नहीं है |
| 2205 | ग्राहक द्वारा सेवा अस्वीकार कर दी गई |
| 2206 | सब्सक्राइबर भुगतान प्रणाली में पंजीकृत नहीं है |
| 2207 | सब्सक्राइबर अधिकतम शेष राशि पर पहुंच गया है |
| 2208 | अंतिम उपयोगकर्ता पुष्टि की आवश्यकता है |
| 2300 | वापसी की गई है |
|
2301 |
अवैध या गुम होने के कारण धनवापसी नहीं की जा सकी
एमएसआईएसडीएन |
| 2302 | संदेश आईडी गुम होने के कारण धनवापसी नहीं की जा सकी |
| 2303 | रिफंड के लिए कतारबद्ध |
| 2304 | धनवापसी का समय समाप्त |
| 2305 | धनवापसी विफल |
| 3000 | जीएसएम एन्कोडिंग समर्थित नहीं है |
| 3001 | UCS2 एन्कोडिंग समर्थित नहीं है |
| 3002 | बाइनरी एन्कोडिंग समर्थित नहीं है |
| 4000 | वितरण रिपोर्ट समर्थित नहीं है |
| 4001 | अमान्य संदेश सामग्री |
| 4002 | अमान्य टैरिफ |
| 4003 | अमान्य उपयोगकर्ता डेटा |
| 4004 | अमान्य उपयोगकर्ता डेटा शीर्षलेख |
| 4005 | अमान्य डेटा कोडिंग |
| 4006 | अमान्य वैट |
| 4007 | गंतव्य के लिए असमर्थित सामग्री |
दस्तावेज़ / संसाधन
 |
लिंक मोबिलिटी एसएमएस एपीआई, एसएमपीपी एपीआई एमएस शेड्यूलर एपीआई [पीडीएफ] उपयोगकर्ता गाइड एसएमएस एपीआई एसएमपीपी एपीआई एमएस शेड्यूलर एपीआई, एसएमएस एपीआई एसएमपीपी एपीआई, एमएस शेड्यूलर एपीआई, शेड्यूलर एपीआई, एपीआई |