लिंक गतिशीलता अंमलबजावणी मार्गदर्शक REST API SMS
LINK मोबिलिटी संदेश वितरण, सूक्ष्म पेमेंट आणि स्थान-आधारित सेवांसाठी सेवा प्रदान करते. प्लॅटफॉर्म एक पारदर्शक, व्हाईट-लेबल सामग्री प्राप्तकर्ता आणि सेवा प्रदाता आणि ऑपरेटर यांच्यातील व्यवहार राउटर म्हणून कार्य करते.
LINK मोबिलिटी एक RESTful API प्रदान करते ज्याचा उपयोग LINK मोबिलिटी सेवांमध्ये प्रवेश करण्यासाठी केला जाऊ शकतो जसे की SMS पाठवणे. हे API वापरण्यास सोपे आणि सर्व आधुनिक भाषा आणि फ्रेमवर्कशी सुसंगत असण्यासाठी डिझाइन केले आहे. तुमच्या पसंतीच्या भाषेचा वापर करून तुमचा अनुप्रयोग शक्तिशाली मेसेजिंग आणि पेमेंट क्षमता लागू करण्यासाठी Link Mobility REST API वापरू शकतो.
© LINK मोबिलिटी, 10 मार्च 2021
कायदेशीर माहिती
या दस्तऐवजात दिलेली माहिती ही Netsize ची एकमेव मालमत्ता आणि कॉपीराइट आहे. हे गोपनीय आहे आणि काटेकोरपणे माहितीच्या वापरासाठी आहे. हे बंधनकारक नाही आणि सूचनेशिवाय बदलांच्या अधीन असू शकते. कोणतेही अनधिकृत प्रकटीकरण किंवा वापर बेकायदेशीर मानले जाईल.
Netsize™ आणि linkmobility™ फ्रेंच, EEC आणि आंतरराष्ट्रीय बौद्धिक संपदा कायद्यांद्वारे संरक्षित आहेत.
उद्धृत केलेले इतर सर्व ट्रेडमार्क त्यांच्या संबंधित मालकांची एकमेव मालमत्ता आहेत.
येथे समाविष्ट असलेल्या कोणत्याही गोष्टीचा नेटसाईझ पेटंट, कॉपीराइट किंवा ट्रेडमार्क अंतर्गत कोणताही परवाना किंवा अधिकार प्रदान केला जात नाही.
NETSIZE
Société anonyme au capital de 5 478 070 युरो
Siège social :62, avenue Emile Zola92100 Boulogne – France
४१८ ७१२ ४७७ आरसीएस नॅन्टेरे
http://www.LinkMobility.com
http://www.linkmobility.com
दस्तऐवजाची व्याप्ती
हा दस्तऐवज सेवा प्रदाता SMS साठी LINK Mobility REST API कसा वापरतो याचे वर्णन करतो. हे तांत्रिक आर्किटेक्ट आणि डिझाइनरसाठी आहे जे सेवा प्रदात्याच्या सेवांची अंमलबजावणी करतात.
1. मूलभूत वापर
एसएमएस पाठवणे खूप सोपे आहे. तुम्ही LINK मोबिलिटीला HTTP विनंती पाठवता जी फक्त a वापरून पूर्ण केली जाऊ शकते web ब्राउझर
2. कार्यात्मक ओव्हरview
LINK मोबिलिटी सिस्टम एसएमएस संदेशांसाठी खालील मूलभूत कार्यक्षमता प्रदान करते:
मोबाइल टर्मिनेटेड (MT) एसएमएस संदेश पाठवणे, जसे की मजकूर किंवा बायनरी (उदा. WAP पुश) प्रीमियम आणि मानक दर संदेश.
सबमिट केलेल्या एमटी संदेशांसाठी वितरण अहवाल प्राप्त करणे.
मोबाईल ओरिजिनेटेड (MO) एसएमएस संदेश, प्रीमियम आणि मानक दर प्राप्त करणे.
SMS REST API मानक दर MT SMS संदेश पाठवण्यासाठी समर्पित आहे.
API सर्व SMS संदेश समकालिकपणे पाठवते, जसे की वैशिष्ट्ये सक्षम करते:
“फायर-अँड-फोरगेट” – सेवा प्रदात्याला अधिक अंदाजे प्रतिसाद वेळ हवा आहे आणि ऑपरेटरकडून निकालाची प्रतीक्षा करू इच्छित नाही.
कार्यक्षमतेचा पुन्हा प्रयत्न करा - ऑपरेटरला तात्पुरती समस्या असल्यास LINK मोबिलिटी संदेश पुन्हा पाठवेल.
2.1 SMS संदेश पाठवणे
सेवा प्रदाता Netsize ग्राहक
- MT संदेश पाठवा
- परत संदेश आयडी
- एसएमएस संदेश सबमिट करा
- वितरण अहवाल वितरित करा
- वितरण अहवाल पाठवा
एसएमएस संदेश पाठवण्याचा मूळ प्रवाह खालीलप्रमाणे वर्णन केला आहे:
सेवा प्रदाता LINK मोबिलिटी प्रणालीद्वारे प्राप्तकर्त्याला SMS संदेश पाठविण्याची विनंती करतो.
सेवा प्रदात्याला संदेश आयडी परत केला जातो. हा आयडी संदेशाचा योग्य वितरण अहवालाशी संबंध जोडण्यासाठी वापरला जाऊ शकतो.
LINK मोबिलिटी राउटिंग हाताळते आणि संबोधित ग्राहकांना एसएमएस संदेश वितरीत करते.
डिलिव्हरी रिपोर्ट ट्रिगर केला जातो, उदा. जेव्हा एसएमएस संदेश ग्राहकाच्या डिव्हाइसवर वितरित केला जातो.
वितरण अहवाल सेवा प्रदात्याकडे पाठविला जातो. अहवालात चरण 2 मध्ये परत केल्याप्रमाणे समान संदेश आयडी आहे.
पर्यायी प्रवाह: अवैध विनंती
विनंतीमधील पुरवठा केलेले पॅरामीटर्स किंवा वापरकर्ता क्रेडेन्शियल्स अवैध असल्यास सेवा प्रदात्याकडे त्रुटी परत केली जाते. त्रुटी नाकारण्याचे कारण दर्शवते आणि प्रवाह संपतो. कोणताही संदेश आयडी परत केला जात नाही.
३. शेवटचा बिंदू
पथ वापरून SMS संसाधनात प्रवेश केला जातो:
/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 |
३.१२.२ पाठवा
पाठवा ऑपरेशन एकाच प्राप्तकर्त्याला एसएमएस पाठवण्यासाठी वापरले जाते.
हे ऑपरेशन मूलभूत आणि प्रगत दोन्ही वापरकर्त्यांसाठी आहे. सर्वात सोप्या प्रकरणात, एसएमएस वितरीत करण्यासाठी फक्त गंतव्य पत्ता आणि संदेश मजकूर आवश्यक आहे. LINK मोबिलिटी डेटा कोडिंग स्कीम शोधेल आणि आवश्यक असल्यास संदेशाचे एकाधिक संदेश भागांमध्ये स्वयंचलित जोडणी करेल.
प्रगत वापरासाठी, सेवा प्रदाता वापरकर्ता डेटा शीर्षलेखासह संदेश स्वरूपनाच्या संपूर्ण नियंत्रणासाठी पर्यायी पॅरामीटर्स वापरू शकतो.
सेवा प्रदाता एकत्रित संदेश पाठवू शकतो, परंतु वापरकर्ता डेटा आणि वापरकर्ता डेटा शीर्षलेख तयार करणे सेवा प्रदात्याने केले पाहिजे आणि संदेश LINK मोबिलिटीकडे एकाधिक पाठवण्याच्या विनंतीद्वारे पाठविला गेला पाहिजे.
५. प्रमाणीकरण
HTTP बेसिक ऑथेंटिकेशन स्कीम वापरून प्रत्येक विनंतीमध्ये वापरकर्तानाव आणि पासवर्ड सबमिट केला जातो.
https://www.w3.org/Protocols/HTTP/1.0/spec.html#BasicAA
क्रेडेन्शियल HTTP विनंतीमध्ये अधिकृतता शीर्षलेखात पाठवले जातात. क्लायंट येथे वर्णन केल्याप्रमाणे हेडर फील्ड तयार करतो:
https://en.wikipedia.org/wiki/Basic_access_authentication#Client_side
उदाampले, जर युजरनेम जॉन असेल आणि चेंजमे हा पासवर्ड असेल तर परिणामी ऑथोरायझेशन हेडर आहे:
अधिकृतता: मूलभूत am9objpjaGFuZ2VtZSA=
फॉल-बॅक म्हणून वापरकर्तानाव आणि पासवर्ड विनंती पॅरामीटर्स म्हणून सबमिट केले जाऊ शकतात. हे केवळ मूलभूत प्रमाणीकरणास समर्थन न देणाऱ्या क्लायंटसाठी शिफारसीय आहे.
6. विनंती सबमिट करणे
6.1 क्वेरी स्ट्रिंग
विनंती पॅरामीटर्स नाव/मूल्य जोड्या असलेल्या क्वेरी स्ट्रिंग म्हणून सबमिट केले जातात. क्वेरी स्ट्रिंग टक्के एन्कोडिंग वापरून एन्कोड केली जाते (URL एन्कोडिंग).
http://www.w3schools.com/tags/ref_urlencode.asp
उदाampले, हॅलो वर्ल्ड! Hello+World%21 म्हणून एन्कोड केलेले आहे.
6.2 अनिवार्य विनंती पॅरामीटर्स
| नाव | कमाल लांबी | वर्णन |
| गंतव्यस्थान पत्ता | 40 | MSISDN ज्यावर SMS संदेश पाठवला जावा, देशाच्या कोडपासून सुरू होईल. उदाample: 46123456789. काही बाजारांसाठी (जेथे ग्राहक MSISDN अस्पष्ट असणे आवश्यक आहे) हे मूल्य "#" सह उपसर्ग असलेले अल्फान्यूमेरिक उपनाव देखील असू शकते. |
| संदेश मजकूर | 1600 | एसएमएस संदेश सामग्री. |
6.3 पर्यायी विनंती पॅरामीटर्स (प्रगत वापरासाठी)
| नाव | कमाल लांबी | वर्णन |
| मूळ पत्ता | 16 | आउटगोइंग एसएमएस संदेशाचा मूळ पत्ता. मूळ पत्त्याचा प्रकार originatorTON पॅरामीटरद्वारे परिभाषित केला जातो. लहान संख्या कमाल लांबी 16 आहे. अल्फा अंकीय प्रेषक कमाल लांबी 11 वर्णांसह GSM डीफॉल्ट वर्णमालापर्यंत मर्यादित आहे. MSISDN प्रेषक कमाल लांबी 15 आहे (destinationAddress घटक प्रमाणेच स्वरूप वापरून). प्रणालीद्वारे originatingAddress आणि originatingTON निवडल्यावर वगळले जाऊ शकते. हे कार्य मार्केट आणि कॉन्फिगरेशनवर अवलंबून आहे. ऑपरेटर एकत्रीकरणासह वर्तन बदलू शकते. |
| मूळ टोन | 1 | मूळ पत्ता' क्रमांकाचा प्रकार (TON): 0 - लहान संख्या 1 - अल्फा अंकीय (कमाल लांबी 11) 2 – MSISDN प्रणालीद्वारे originatingAddress आणि originatingTON निवडले जाईल तेव्हा वगळले जाऊ शकते. हे फंक्शन मार्केट आणि कॉन्फिगरेशनवर अवलंबून आहे. ऑपरेटर एकत्रीकरणासह वर्तन बदलू शकते. |
| userDataHeader | 280 | वापरकर्ता डेटा हेडरमध्ये वापरकर्ता डेटासह 140 पर्यंत, म्हणजे 280 हेक्स-एनकोड केलेले, ऑक्टेट असू शकतात. हे पॅरामीटर नेहमी हेक्स-एनकोड केलेले असते. |
| DCS | 3 | डेटा कोडिंग योजना. ऑपरेटर एकत्रीकरणासह वर्तन बदलू शकते. |
| पीआयडी | 3 | प्रोटोकॉल आयडी. ऑपरेटर एकत्रीकरणासह वर्तन बदलू शकते. |
| संबंधित वैधता वेळ | 6 | सापेक्ष वैधता वेळ सेकंदांमध्ये (LINK मोबिलिटी सबमिशनच्या वेळेशी संबंधित). कमाल मूल्य 604800 (7 दिवस) आहे आणि डीफॉल्ट 48 तास आहे. ऑपरेटर एकत्रीकरणासह वर्तन बदलू शकते. |
| वितरण वेळ | 20 | टाइमस्टamp जेव्हा एसएमएस संदेश वितरित केला जावा (डिलिव्हरीचा विलंब). तारीख वेळ स्वरूपातील विभाग पहा. |
| स्थिती अहवाल ध्वज | 1 | अहवाल विनंती वितरीत करा: 0 - वितरण अहवाल नाही (डीफॉल्ट) 1 - वितरण अहवालाची विनंती केली 9 - सर्व्हर वितरण अहवालाची विनंती केली आहे (LINK मोबिलिटी अहवाल सेवा प्रदात्याकडे अग्रेषित करत नाही परंतु अहवालात उपलब्ध करते इ.) |
| campaignName | 50 | LINK मोबिलिटी व्यवहार आहेत tagया नावाने ged. याचा उपयोग लिंक मोबिलिटी अहवालांमध्ये गट व्यवहार करण्यासाठी केला जातो. |
| maxConcatenatedMessages | 1 | 1 आणि 10 मधील मूल्य जे अनुमती असलेल्या किती एकत्रित संदेशांना परिभाषित करते. डीफॉल्ट 3 आहे. |
| सहसंबंध आयडी | 100 | सेवा प्रदात्याने प्रदान केलेला आयडी डिलिव्हरी अहवालात प्रतिध्वनी केला जाईल. |
| वापरकर्तानाव | 100 | एचटीटीपी बेसिक ऑथेंटिकेशनला पर्याय म्हणून प्रदान केले. |
| पासवर्ड | 100 | एचटीटीपी बेसिक ऑथेंटिकेशनला पर्याय म्हणून प्रदान केले. |
6.4 HTTP विनंती पद्धती
जास्तीत जास्त इंटरऑपरेबिलिटीसाठी, API HTTP GET आणि POST विनंती पद्धतींना समर्थन देते. इतर कोणत्याही HTTP पद्धतींना परवानगी नाही.
६.४.१ मिळवा
एन्कोडेड क्वेरी स्ट्रिंग जोडली आहे URL.
मिळवा
https://europe.ipx.com/restapi/v1/sms/send?destinationAddress=461234
56789&messageText=Hello+World%21
अधिकृतता: मूलभूत am9objpjaGFuZ2VtZSA=
6.4.2 पोस्ट
एन्कोड केलेली क्वेरी स्ट्रिंग HTTP विनंती संदेशाच्या मुख्य भागामध्ये सबमिट केली जाते. सामग्री-प्रकार अनुप्रयोग/x-www-फॉर्म- आहेurlएन्कोड केलेले.
पोस्ट https://europe.ipx.com/restapi/v1/sms/send
होस्ट: europe.ipx.com
सामग्री प्रकार: अनुप्रयोग / एक्स-www- फॉर्म-urlएन्कोड केलेले
अधिकृतता: मूलभूत am9objpjaGFuZ2VtZSA=
सामग्री-लांबी: 57
destinationAddress=46123456789&messageText=Hello+World%21
6.5 तारीख आणि वेळ
तारीख आणि वेळ दर्शविणारे REST API मधील पॅरामीटर्स नेहमी UTC टाइम झोनमध्ये असतात (समन्वित युनिव्हर्सल टाइम). टाइमस्टamps या अचूक स्वरूपासह स्ट्रिंग म्हणून प्रस्तुत केले जातात:
2017-04-25T23:20:50Z
हे UTC मध्ये 20 एप्रिल 50 च्या 23 व्या तासानंतर 25 मिनिटे आणि 2017 सेकंदांचे प्रतिनिधित्व करते.
7. प्रतिसाद संदेश
विनंती संदेश प्राप्त केल्यानंतर आणि त्याचा अर्थ लावल्यानंतर API HTTP प्रतिसाद संदेशासह प्रतिसाद देते.
७.१ 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 मोबिलिटीने विनंतीवर प्रक्रिया केल्याची तारीख आणि वेळ. (तारीख/वेळ स्वरूप विभाग पहा). |
| ट्रेसआयडी | 36 | लिंक मोबिलिटी अंतर्गत अभिज्ञापक. समर्थन आणि समस्यानिवारणासाठी वापरले जाते. |
| मेसेज आयडी | 10 x 36 | प्रत्येक यशस्वी मेसेजसाठी LINK मोबिलिटी युनिक मेसेज आयडीचा ॲरे (संदेश जोडलेला असल्यास अनेक मेसेज आयडी परत केले जातात). अयशस्वी झाल्यास वगळले. |
7.4 उदाampप्रतिसाद
यश
HTTP/1.1 200 ओके
सामग्री-प्रकार: अनुप्रयोग/json
सामग्री-लांबी: 144
तारीख: गुरु, 15 सप्टेंबर 2016 13:20:31 GMT
{"responseCode":0,"responseMessage":"यशस्वी","टाइमस्टamp”:”2016-09-15T13:20:31Z”, “traceId”:”f678d30879fd4adc25f2″,”messageIds”:[“1-4850879008”]}
वाचनीयतेसाठी येथे समान JSON स्वरूपित आहे:
{
“प्रतिसाद कोड":0,
“प्रतिसाद संदेश":"यश",
“वेळamp“:”2016-0915T13:20:31Z”,
“ट्रेसआयडी“:”f678d30879fd4adc25f2”,
“मेसेज आयडी":["1-4850879008"] }
अपयश
HTTP/1.1 200 ओके
सामग्री-प्रकार: अनुप्रयोग/json
सामग्री-लांबी: 148
तारीख: गुरु, 15 सप्टेंबर 2016 13:20:31 GMT
{"responseCode":1,"responseMessage":" अवैध लॉगिन किंवा अनधिकृत API वापर","टाइमस्टamp”:”2016-09-15T13:20:31Z”,”traceId”:”f678d30879fd4adc25f2″}
यश
HTTP/1.1 200 ओके
सामग्री-प्रकार: अनुप्रयोग/json
सामग्री-लांबी: 144
तारीख: गुरु, 15 सप्टेंबर 2016 13:20:31 GMT
{"responseCode":0,"responseMessage":"यशस्वी","टाइमस्टamp”:”2016-09-15T13:20:31Z”, “traceId”:”f678d30879fd4adc25f2″,”messageIds”:[“1-4850879008”]}
वाचनीयतेसाठी येथे समान JSON स्वरूपित आहे:
{
“प्रतिसाद कोड":0,
“प्रतिसाद संदेश":"यश",
“वेळamp“:”2016-0915T13:20:31Z”,
“ट्रेसआयडी“:”f678d30879fd4adc25f2”,
“मेसेज आयडी":["1-4850879008"] }
अपयश
HTTP/1.1 200 ओके
सामग्री-प्रकार: अनुप्रयोग/json
सामग्री-लांबी: 148
तारीख: गुरु, 15 सप्टेंबर 2016 13:20:31 GMT
{"responseCode":1,"responseMessage":" अवैध लॉगिन किंवा अनधिकृत API वापर","टाइमस्टamp”:”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 | प्रोटोकॉल आयडी खात्याद्वारे समर्थित नाही | प्रोटोकॉल आयडी समर्थित नाही. |
| 15 | संदेश जोडण्याची मर्यादा ओलांडली | एकत्रित संदेशांची संख्या विनंती केलेल्या कमाल संख्येपेक्षा जास्त आहे. |
| 16 | संदेश रूट करण्यात अक्षम. | LINK मोबिलिटी संदेश रूट करण्यात अक्षम होती. |
| 17 | प्रतिबंधित कालावधी | कालावधी दरम्यान संदेश पाठविण्याची परवानगी नाही |
| 18 | सेवा प्रदाता खात्यावर खूप कमी शिल्लक आहे | खूप कमी शिल्लक असल्यामुळे सेवा प्रदाता अवरोधित केला आहे |
| 50 | आंशिक यश | एकाधिक प्राप्तकर्त्यांना SMS संदेश पाठवताना आंशिक यश. |
| 99 | अंतर्गत सर्व्हर त्रुटी | इतर लिंक मोबिलिटी एरर, अधिक माहितीसाठी LINK मोबिलिटी सपोर्टशी संपर्क साधा. |
| 100 | अवैध गंतव्य पत्ता | गंतव्य पत्ता (MSISDN, किंवा उपनाव) अवैध आहे. |
| 102 | अवैध संदर्भित (लिंक केलेला) आयडी | संदर्भ आयडी अवैध आहे, कदाचित संदर्भ आयडी आधीच वापरला गेला आहे, खूप जुना किंवा अज्ञात आहे. |
| 103 | अवैध खाते नाव | खाते नाव अवैध आहे. |
| 105 | अवैध सेवा मेटा डेटा | सेवा मेटा डेटा अवैध आहे. |
| 106 | अवैध मूळ पत्ता | मूळ पत्ता अवैध आहे. |
| 107 | अवैध अल्फान्यूमेरिक मूळ पत्ता | अल्फान्यूमेरिक मूळ पत्ता अवैध आहे. |
| 108 | अवैध वैधता वेळ | वैधता वेळ अवैध आहे. |
| 109 | अवैध वितरण वेळ | वितरण वेळ अवैध आहे. |
| 110 | अवैध संदेश सामग्री/वापरकर्ता डेटा | वापरकर्ता डेटा, म्हणजे एसएमएस संदेश, अवैध आहे. |
| 111 | अवैध संदेश लांबी | SMS संदेशाची लांबी अवैध आहे. |
| 112 | अवैध वापरकर्ता डेटा शीर्षलेख | वापरकर्ता डेटा शीर्षलेख अवैध आहे. |
| 113 | अवैध डेटा कोडिंग योजना | DCS अवैध आहे. |
| 114 | अवैध प्रोटोकॉल आयडी | PID अवैध आहे. |
| 115 | अवैध स्थिती अहवाल ध्वज | स्थिती अहवाल ध्वज अवैध आहेत. |
| 116 | अवैध TON | प्रवर्तक TON अवैध आहे. |
| 117 | अवैध सीampaign नाव | या सीampaign नाव अवैध आहे. |
| 120 | एकत्रित संदेशांच्या कमाल संख्येसाठी अवैध मर्यादा | एकत्रित संदेशांची कमाल संख्या अवैध आहे. |
| 121 | अवैध msisdn मूळ पत्ता | MSISDN मूळ पत्ता अवैध आहे. |
| 122 | अवैध सहसंबंध आयडी | सहसंबंध आयडी अवैध आहे. |
८. पर्यायी वैशिष्ट्ये
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 |
| २११०८८-०६ ०२.२२ | 46702233445 |
| 070.2233.4455 | 46702233445 |
| 460702233445 | 46702233445 |
| +४४.२०.७१६७.४८४५ | 46702233445 |
| +४४.२०.७१६७.४८४५ | 458022334455 |
| 45802233445 | '+' चिन्ह गहाळ असल्याने अवैध |
लक्षात घ्या की दुरुस्त केलेला MSISDN LINK मोबिलिटी द्वारे वापरला जाईल आणि तो वितरण अहवालांमध्ये परत केला जाईल.
अधिक माहितीसाठी कृपया LINK मोबिलिटी सपोर्टशी संपर्क साधा.
8.2 वर्ण बदलणे
वर्ण बदलणे हे एक पर्यायी वैशिष्ट्य आहे जे विनंती केल्यास LINK मोबिलिटी सपोर्टद्वारे सक्षम केले जाऊ शकते.
जेव्हा DCS "GSM" (17) वर सेट केले जाते तेव्हा हे वैशिष्ट्य वापरकर्ता डेटा (SMS मजकूर) मधील गैर-GSM वर्णमाला वर्णांचे समतुल्य GSM वर्णमाला वर्णांमध्ये भाषांतर करेल. उदाample "Seqüência de teste em Português" चे भाषांतर "Seqüencia de teste em Portugues" मध्ये केले जाईल.
9. वितरण अहवाल
सेवा प्रदाता, तरतूद असल्यास, पाठवलेल्या MT संदेशांसाठी SMS संदेश वितरण अहवाल किंवा वितरण सूचनांची विनंती करू शकतो. हे अहवाल ऑपरेटर SMSC मध्ये ट्रिगर केले जातात जेव्हा MT संदेश एकतर लक्ष्यित ग्राहकांना वितरित केला जातो किंवा हटविला जातो, उदा. कालबाह्य झाला आहे किंवा काही कारणास्तव, राउटेबल नाही.
सेवा प्रदात्याला एसएमएस संदेशाची केवळ अंतिम स्थिती कळवली जाते, म्हणजे वितरित किंवा हटविले जाते. प्रति MT संदेश फक्त एक अहवाल तयार केला जातो. हटवलेल्या स्थितीसह, कारण कोड लागू होऊ शकतो. हा कारण कोड एसएमएस संदेश वितरित न होण्याचे कारण निर्दिष्ट करतो.
अहवाल LINK मोबिलिटी द्वारे राउट केले जातात आणि HTTP प्रोटोकॉल वापरून सेवा प्रदात्याकडे पाठवले जातात.
अहवाल प्राप्त करण्यासाठी, सेवा प्रदात्याने भूतकाळासाठी अंमलबजावणी करणे आवश्यक आहेampजावा सर्व्हलेट किंवा ASP.NET पृष्ठ. दोघांना HTTP GET किंवा POST विनंत्या प्राप्त होतात.
पॅरामीटर्स
विनंतीमध्ये खालील पॅरामीटर्स समाविष्ट आहेत:
| पॅरामीटर | प्रकार | M/O/I* | डीफॉल्ट मूल्य | कमाल लांबी | वर्णन |
| MessageId | स्ट्रिंग | M | – | 22 | या अहवालाशी संबंधित MT संदेशाचा संदेश आयडी. |
| गंतव्य पत्ता | स्ट्रिंग | M | – | 40 | ग्राहकाचा MSISDN, म्हणजे मूळ MT संदेशाचा गंतव्य पत्ता. |
| स्टेटसकोड | पूर्णांक | M | 1 | स्थिती कोड MT संदेशाची स्थिती दर्शवतो. लागू स्थिती कोड आहेत: 0 - वितरित २ – हटवले (कारण कोड लागू) |
|
| टाइमस्टamp | स्ट्रिंग | M | – | 20 | LINK मोबिलिटी द्वारे वितरण अहवाल कधी प्राप्त झाला हे दर्शविणारी वेळ. टाइम झोनamp CET किंवा CEST आहे (EU साठी परिभाषित केल्यानुसार उन्हाळ्याच्या वेळेसह). स्वरूप: yyyyMMdd HH:mm:ss. |
| ऑपरेटर | स्ट्रिंग | M | – | 100 | SMS संदेश पाठवताना वापरलेले ऑपरेटरचे नाव किंवा SMS संदेश पाठवताना वापरलेले खाते नाव. उपलब्ध ऑपरेटरची सूची LINK मोबिलिटी सपोर्टद्वारे प्रदान केली जाते. |
| कारण कोड | पूर्णांक | O | – | 3 | मेसेज डिलीट केलेल्या स्थितीमध्ये का संपला याचे कारण कोड सूचित करतो. लागू कारण कोड आहेत: 100 - कालबाह्य 101 - नाकारले 102 - स्वरूप त्रुटी 103 - इतर त्रुटी 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 | ऑपरेटरकडून अतिरिक्त माहितीसाठी प्लेसहोल्डर, उदा. स्थिती/कारणाचे स्पष्ट मजकूर वर्णन. ऑपरेटर एकत्रीकरणासह वर्तन बदलू शकते. |
| सहसंबंध आयडी | स्ट्रिंग | O | – | 100 | SendRequest किंवा SendTextRequest मध्ये प्रदान केलेला सहसंबंध आयडी. |
| ऑपरेटर नेटवर्क कोड | पूर्णांक | O | – | 6 | ऑपरेटरचा मोबाइल नेटवर्क कोड (MCC + MNC). |
* M = अनिवार्य, O = पर्यायी, I = दुर्लक्षित.
सेवा प्रदात्याने लक्ष्यासह LINK मोबिलिटी प्रदान करणे आवश्यक आहे URL डिलिव्हरी रिपोर्टसाठी (पर्यायीपणे HTTP बेसिक ऑथेंटिकेशनसाठी क्रेडेन्शियल्स समाविष्ट करून). सेवा प्रदाता कोणती पसंतीची HTTP पद्धत वापरायची ते निवडू शकतो:
HTTP POST (शिफारस केलेले)
HTTP मिळवा.
ExampHTTP GET वापरून (यशस्वीरित्या वितरित):
https://user:password@www.serviceprovider.com/receivereport?%20MessageId=122&DestinationAddress=46762050312&Operator=Vodafone&TimeStamp=20100401%2007%3A47%3A44&StatusCode=0
Example HTTP GET वापरत आहे (वितरित नाही, ऑपरेटरने टाइमस्ट पुरवठा केला आहेamp कार्यक्रमासाठी):
मापदंड आहेत URL एन्कोड केलेले.
वर्ण एन्कोडिंग:
सेवा प्रदाता कोणते प्राधान्य वर्ण एन्कोडिंग वापरायचे ते निवडू शकतो:
UTF-8 (शिफारस केलेले)
आयएसओ-८८५९-१.
9.1 सेवा प्रदात्याची पोचपावती
सेवा प्रदात्याने प्रत्येक डिलिव्हरी अहवालाची कबुली दिली पाहिजे. पोचपावती सकारात्मक असू शकते, म्हणजे वितरण अहवाल यशस्वीरित्या प्राप्त झाला, किंवा नकारात्मक, म्हणजे अपयश.
कृपया लक्षात ठेवा: LINK मोबिलिटीकडे वितरण अहवालांसाठी 30 सेकंदांच्या पोचपावती वाचण्याची कालबाह्यता आहे. टाइमआउट डिलिव्हरी पुन्हा प्रयत्न ट्रिगर करेल (पुन्हा प्रयत्न सक्षम केल्यास) किंवा डिलिव्हरी रद्द करणे (पुन्हा प्रयत्न अक्षम केल्यास). याचा अर्थ असा की सेवा प्रदाता अनुप्रयोगाने जलद प्रतिसाद वेळा सुनिश्चित करणे आवश्यक आहे, विशेषत: उच्च लोड दरम्यान.
LINK मोबिलिटीकडे प्रक्रिया करण्यापूर्वी डिलिव्हरीचा अहवाल स्वीकारण्याची शिफारस केली जाते.
सकारात्मक आणि नकारात्मक पावतीचा नियम खालीलप्रमाणे वर्णन केला आहे:
सकारात्मक पोचपावती, ACK, वितरण अहवाल वितरित:
HTTP 200 श्रेणी प्रतिसाद कोड खालील XML स्वरूपित सामग्रीसह संयोजनात:
नकारात्मक पावती, NAK, वितरण अहवाल वितरित केला नाही:
सकारात्मक पोचपावती सोडून इतर कोणतेही उत्तर, उदाample, नकारात्मक पावती कोणत्याही HTTP त्रुटी कोड किंवा खालील XML सामग्रीद्वारे ट्रिगर केली जाते:
XML सामग्रीचा वापर LINK मोबिलिटी पुन्हा प्रयत्न यंत्रणा नियंत्रित करण्यासाठी केला जाऊ शकतो. NAK सक्षम केल्यास, पुन्हा प्रयत्न करण्याचा प्रयत्न करेल. सेवा प्रदात्यांसाठी पुनर्प्रयास यंत्रणेसाठी कॉन्फिगर केलेले नाही, XML सामग्री पर्यायी आहे.
खाली HTTP POST विनंती आणि प्रतिसाद आहेampसेवा प्रदात्याला डिलिव्हरीचा अहवाल:
HTTP विनंती:
POST/context/app HTTP/1.1
सामग्री प्रकार: अनुप्रयोग / एक्स-www- फॉर्म-urlencoded;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 ऑपरेटर आहे आणि खाते अवलंबून आहे, म्हणजे, ऑपरेटर आणि किंवा संदेश प्रकारावर अवलंबून बदलू शकते, उदा, प्रीमियम एसएमएस किंवा मानक दर एसएमएस संदेश.
पुन्हा प्रयत्न सक्षम असलेल्या सेवा प्रदात्यांनी MT मेसेजचा युनिक आयडी तपासणे आवश्यक आहे की मेसेज आधीच मिळाला नाही.
सेवा प्रदात्याने या सोप्या नियमांचे पालन करणे महत्त्वाचे आहे जेव्हा वितरण अहवालाच्या प्रक्रियेदरम्यान त्रुटी उद्भवते जर त्रुटीचे कारण असेल: तात्पुरते, उदा. डेटाबेस उपलब्ध नाही, NAK परत केले जावे. LINK मोबिलिटी संदेश पुन्हा पाठवेल.
कायमस्वरूपी आणि पुन्हा प्रयत्न केल्याने समान समस्या उद्भवण्याची शक्यता आहे, ACK परत केला पाहिजे. उदाample, जेव्हा संदेश योग्यरित्या पार्स केला जाऊ शकत नाही किंवा अनपेक्षित रनटाइम त्रुटीमुळे.
त्यानुसार कार्य करणे हे सुनिश्चित करेल की डिलिव्हरी अहवाल वारंवार पाठवल्यामुळे कोणतेही ब्लॉकिंग किंवा थ्रूपुट डिग्रेडेशन होणार नाही.
10. अंमलबजावणी टिपा
1. आपल्या वापरणे शक्य आहे web API ला विनंत्या सबमिट करण्यासाठी ब्राउझर. हे कोणत्याही विकास साधनांशिवाय सेवांचे अन्वेषण आणि मूल्यांकन करणे खूप सोपे करते.
2. JSON सारख्या एक्सटेंशनसह क्रोम किंवा फायरफॉक्सची शिफारस केली जाते.View सुंदर स्वरूपित JSON प्रदर्शित करण्यासाठी.
3. आम्ही POST, बेसिक ऑथेंटिकेशन आणि रॉ HTTP विनंती आणि प्रतिसाद संदेशांची तपासणी करण्यासाठी SoapUI चा वापर केला आहे.
4. या सीURL हे टूल बेसिक ऑथेंटिकेशनसह POST रिक्वेस्ट सबमिट करण्यासाठी उपयुक्त आहे. ex पहाample खाली.
curl पोस्ट \
-H “सामग्री-प्रकार: अर्ज/x-www-फॉर्म-urlएन्कोड केलेले" \
-H "अधिकृतीकरण: मूलभूत am9objpjaGFuZ2VtZSA=" \
https://europe.ipx.com/restapi/v1/sms/send \
-डेटा “destinationAddress=46123456789&messageText=Hello+World%21”
_______________
वैयक्तिकृत संप्रेषणे बदलणे
कागदपत्रे / संसाधने
 |
लिंक गतिशीलता अंमलबजावणी मार्गदर्शक REST API SMS [pdf] वापरकर्ता मार्गदर्शक गतिशीलता अंमलबजावणी मार्गदर्शक REST API SMS, गतिशीलता, अंमलबजावणी मार्गदर्शक REST API SMS, REST API SMS, API SMS, SMS |
