SMS API, SMPP API MS शेड्युलर API
वापरकर्ता मार्गदर्शक
SMS API, SMPP API MS शेड्युलर API
| सुधारित: | २०२०/१०/२३ |
| आवृत्ती: | 1.7 |
| लेखक: | केनी कोलँडर नॉर्डेन, केसीएन |
हा दस्तऐवज केवळ नियुक्त प्राप्तकर्त्यासाठी आहे आणि त्यात विशेषाधिकार, मालकी किंवा अन्यथा खाजगी माहिती असू शकते. तुम्हाला ते चुकून मिळाले असल्यास, कृपया प्रेषकाला ताबडतोब सूचित करा आणि मूळ हटवा. तुमच्याद्वारे दस्तऐवजाचा इतर कोणताही वापर प्रतिबंधित आहे.
इतिहास बदला
| रेव्ह | तारीख | By | मागील प्रकाशनातील बदल |
| 1.0 | ५७४-५३७-८९०० | KCN | तयार केले |
| 1. | ५७४-५३७-८९०० | TPE | LINK लोगो अद्यतनित केले |
| 1. | ५७४-५३७-८९०० | पीएनआय | SMPP 3.4 तपशीलाचा संदर्भ जोडला |
| 1. | ५७४-५३७-८९०० | EP | वैधता कालावधी बद्दल निरीक्षण tag |
| 1. | ५७४-५३७-८९०० | KCN | समर्थित TLS आवृत्त्यांशी संबंधित माहिती जोडली |
| 2. | ५७४-५३७-८९०० | KCN | डिलिव्हरी अहवालांबाबत अतिरिक्त माहिती जोडली. TLS 1.3 बद्दल अपडेट केलेली माहिती |
| 2. | ५७४-५३७-८९०० | GM | निकाल कोड २१०८ जोडला |
| 2. | ५७४-५३७-८९०० | 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 अज्ञात वर सेट केले असल्यास डीफॉल्ट मूल्य.
असमर्थित पॅरामीटर्स:
- पत्ता_श्रेणी
4.2 अनबाइंड करा
अनबाइंड कमांड समर्थित आहे.
4.3 लिंकची चौकशी करा
चौकशी लिंक कमांड समर्थित आहे आणि प्रत्येक 60 सेकंदांनी कॉल केला पाहिजे.
4.4 सबमिट करा
संदेश वितरीत करण्यासाठी सबमिट पद्धत वापरली जावी.
आवश्यक पॅरामीटर्स:
- source_addr_ton
- source_addr_npi
- source_addr
- dest_addr_ton
- dest_addr_npi
- dest_addr
- esm_class
- डेटा_कोडिंग
- sm_length
- लघु_संदेश
असमर्थित पॅरामीटर्स:
- सेवा_प्रकार
- protocol_id
- प्राधान्य_ध्वज
- शेड्यूल_डिलिव्हरी_टाइम
- बदला_जर_वर्तमान_ध्वज
- 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 from bind कमांड वापरला जाईल. जर NPI अज्ञात (0) वर सेट केला असेल तर डीफॉल्ट NPI from bind कमांड वापरला जाईल.
| TON | NPI | वर्णन |
| अल्फान्यूमेरिक (5) | अज्ञात (५०) आयएसडीएन (१) |
अल्फान्यूमेरिक प्रेषक मजकूर म्हणून हाताळले जाईल |
| आंतरराष्ट्रीय (००१) | अज्ञात (५०) आयएसडीएन (१) |
MSISDN म्हणून मानले जाईल |
| राष्ट्रीय (2) नेटवर्क विशिष्ट (३) ग्राहक क्रमांक (४) संक्षिप्त (6) |
अज्ञात (५०) आयएसडीएन (१) राष्ट्रीय (8) |
देश विशिष्ट लहान संख्या मानली जाईल. |
4.4.1.2 गंतव्य
खालील TON आणि NPI संयोजन गंतव्य पत्त्यासाठी समर्थित आहेत. इतर सर्व संयोजन अवैध मानले जातील. TON अज्ञात (0) वर सेट केल्यास bind कमांडमधील डीफॉल्ट TON वापरला जाईल. NPI अज्ञात (0) वर सेट केल्यास bind कमांडमधील डीफॉल्ट NPI वापरला जाईल.
| TON | NPI | वर्णन |
| आंतरराष्ट्रीय (००१) | अज्ञात (५०) आयएसडीएन (१) |
MSISDN म्हणून मानले जाईल |
4.4.2 समर्थित एन्कोडिंग
खालील एन्कोडिंग समर्थित आहेत. X मध्ये कोणतेही मूल्य असू शकते.
| DCS | एन्कोडिंग |
| 0xX0 | विस्तारासह डीफॉल्ट GSM वर्णमाला |
| 0xX2 | 8-बिट बायनरी |
| 0xX8 | UCS2 (ISO-10646-UCS-2) |
कोटा
५.१ कोटा संपलाview
कोटा म्हणजे एका विशिष्ट वेळेच्या अंतराने (जसे की प्रति दिवस, आठवडा, महिना किंवा अनिश्चित काळासाठी) पाठवता येणाऱ्या एसएमएस संदेशांची कमाल संख्या. प्रत्येक कोटा एका कोटा आयडी (UUID) द्वारे विशिष्टपणे ओळखला जातो आणि ग्राहकाच्या टाइम झोननुसार रीसेट केला जातो. कोटा देश, प्रदेश किंवा डीफॉल्ट स्तरावर कोटा प्रो द्वारे नियुक्त केला जाऊ शकतो.file. कोटा मॅपिंग वापरून कोटा डायनॅमिकली नियुक्त केला जाऊ शकतो. हे एका विशिष्ट कोटा आयडीवर एक पॅरेंट कोटा आयडी (UUID) आणि एक अद्वितीय कोटा की (उदा., प्रेषक किंवा वापरकर्ता) मॅप करते.
तुमच्या स्थानिक सपोर्टनुसार, तुमच्या नियुक्त केलेल्या अकाउंट मॅनेजरनुसार किंवा काहीही निर्दिष्ट नसल्यास डीफॉल्टनुसार कोटा सेट केला जातो.
५.२ स्थिती १०६ – कोटा ओलांडला
खालील प्रकरणांमध्ये स्टेटस कोड १०६ ("कोटा ओलांडला") वापरून एसएमएस संदेश ब्लॉक केला जाऊ शकतो:
- संदेश सध्याच्या मध्यांतरात त्याच्या संबंधित कोटा आयडीसाठी परिभाषित मर्यादा ओलांडतो.
- गंतव्य देश किंवा प्रदेशाला कोणताही कोटा नियुक्त केलेला नाही (म्हणजे, प्रो मध्ये शून्य कोटा मॅपिंगसह स्पष्टपणे अवरोधित केला आहे).file).
- कोणताही जुळणारा कोटा नाही आणि कोणताही डीफॉल्ट कोटा परिभाषित केलेला नाही, परिणामी नकार दिला जातो.
या प्रकरणांमध्ये, ग्राहक किंवा गंतव्यस्थान-आधारित मर्यादा लागू करण्यासाठी आणि गैरवापर टाळण्यासाठी सिस्टम पुढील संदेश प्रक्रिया प्रतिबंधित करते.
वितरण अहवाल
यशस्वी/अयशस्वी निकालासह केवळ कोणतेही किंवा अंतिम वितरण समर्थित नाही.
वितरण अहवालाचे स्वरूप: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx पूर्ण तारीख: yyMMddHHmm स्टेट:
स्थितीमध्ये उपलब्ध मूल्ये:
- DELIVRD
- कालबाह्य
- नाकारले
- UNDELIV
- हटवले
6.1 विस्तारित वितरण अहवाल स्वरूप
तुमच्या विक्री प्रतिनिधीच्या संपर्कात डिलिव्हरी अहवालातील विस्तारित माहितीची विनंती केली जाऊ शकते.
डिलिव्हरी अहवालाचे स्वरूप: आयडी: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx उप:००० dlvrd:००० सबमिट तारीख:
yyMMddHHmm पूर्ण झाल्याची तारीख: yyMMddHHmm स्थिती: चूक: मजकूर:
स्थितीमध्ये उपलब्ध मूल्ये:
- DELIVRD
- कालबाह्य
- नाकारले
- UNDELIV
- हटवले
"sub" आणि "dlvrd" फील्ड नेहमी 000 वर सेट केले जातील आणि "मजकूर" फील्ड नेहमी रिक्त असेल.
“एरर” फील्डच्या मूल्यांसाठी अध्याय त्रुटी कोड पहा.
समर्थित TLS आवृत्त्या
SMPP वरील सर्व TLS कनेक्शनसाठी TLS 1.2 किंवा TLS 1.3 आवश्यक आहे.
TLS 1.0 आणि 1.1 साठी समर्थन 2020-11-15 पासून बंद केले आहे. TLS च्या आवृत्त्या 1.0 आणि 1.1 हे जुने प्रोटोकॉल आहेत जे नापसंत केले गेले आहेत आणि इंटरनेट समुदायामध्ये सुरक्षा धोके म्हणून गणले गेले आहेत.
आज जर एनक्रिप्ट न केलेले SMPP कनेक्शन वापरले जात असतील तर LINK TLS वापरण्याची जोरदार शिफारस करते. 2020-09-01 पर्यंत LINK द्वारे एन्क्रिप्ट न केलेले SMPP कनेक्शन नापसंत केले गेले आहेत आणि भविष्यात काढले जातील. एनक्रिप्टेड कनेक्शन काढण्याची तारीख अद्याप निश्चित केलेली नाही.
TLS साठी SMPP सर्व्हरशी असलेले कनेक्शन पोर्ट 3601 वर एनक्रिप्ट न करता पोर्ट 3600 वर आहे.
तुमची SMPP अंमलबजावणी स्टनल वापरून TLS ला समर्थन देत नसली तरीही तुम्ही TLS वापरू शकता, पहा 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 | 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 | गंतव्यस्थानासाठी असमर्थित सामग्री |
कागदपत्रे / संसाधने
 |
लिंक मोबिलिटी SMS API, SMPP API MS शेड्युलर API [pdf] वापरकर्ता मार्गदर्शक SMS API SMPP API MS शेड्युलर API, SMS API SMPP API, MS शेड्युलर API, शेड्यूलर API, API |