पार्टनर प्रोटोकॉल को फोन नंबर और इनकमिंग SMS संदेशों को API के माध्यम से सीधे Grizzly SMS सर्वर पर उपलब्ध कराने के लिए डिज़ाइन किया गया है।
सभी अनुरोधों में KEY पैरामीटर शामिल होता है। यह कुंजी सपोर्ट स्टाफ द्वारा प्रदान की जाती है और आपके पर्सनल अकाउंट में उपलब्ध रहती है।
क्वांटिटी रिक्वेस्ट्स GET_SERVICES, नंबर रिक्वेस्ट्स GET_NUMBER और एक्टिवेशन को पूरा करने के रिक्वेस्ट्स FINISH_ACTIVATION सीधे हमारे सर्वर से पार्टनर के सर्वर पर भेजे जाते हैं।
URL फ़ॉर्मेट: https://GrizzlySMS, जहाँ GrizzlySMS, partner.ru:port/GrizzlySMS.php या partner.ru/GrizzlySMS.php हो सकता है।
- GET_SERVICES
- GET_NUMBER
- PUSH_SMS
- FINISH_ACTIVATION
- Grizzly SMS सर्वर लगभग हर 10–20 सेकंड में GET_SERVICES मेथड के ज़रिए उपलब्ध फोन नंबरों की संख्या के लिए रिक्वेस्ट भेजता है।
- अगर आपके रिस्पॉन्स में संख्या > 0 होती है, तो आपको GET_NUMBER मेथड के ज़रिए फोन नंबर जारी करने का रिक्वेस्ट मिलेगा।
- GET_NUMBER रिक्वेस्ट प्राप्त करने के बाद, आपको सभी मानदंडों को पूरा करने वाला फोन नंबर प्रदान करना होगा और प्राप्त होने वाले सभी SMS संदेशों को PUSH_SMS मेथड के माध्यम से हमें फॉरवर्ड करना होगा। यह इसलिए ज़रूरी है ताकि हम स्पष्ट और वस्तुनिष्ठ फ़िल्टरिंग कर सकें और संबंधित SMS संदेशों को अपने क्लाइंट्स के लिए सही सेवा तक पहुँचा सकें।
- फोन नंबर से संबंधित सभी आवश्यक कार्य पूरे होने के बाद, आपको FINISH_ACTIVATION मेथड के माध्यम से स्टेटस 3 प्राप्त होगा। यह स्टेटस दिखाता है कि नंबर का सफलतापूर्वक रजिस्ट्रेशन के लिए उपयोग किया गया और आपको इसके लिए भुगतान कर दिया गया है।
आवश्यकताएँ:
- रिक्वेस्ट/रिस्पॉन्स फ़ॉर्मेट: JSON
- एन्कोडिंग: UTF-8
- Grizzly SMS सर्वर को भेजे जाने वाले सभी रिक्वेस्ट्स में हमेशा user-agent हेडर होना चाहिए
फ़ील्ड टाइप्स:
- int: -2 147 483 648 से 2 147 483 647 तक के पूर्णांक मान
- Uint: 0 से 2 147 483 647 तक के बिना चिन्ह वाले पूर्णांक मान
- long: -9 223 372 036 854 775 808 से 9 223 372 036 854 775 807 तक के पूर्णांक मान
- Ulong: 0 से 9 223 372 036 854 775 807 तक के बिना चिन्ह वाले long पूर्णांक मान
- cur: अधिकतम 2 दशमलव अंकों वाला वास्तविक मान, उदाहरण के लिए 177.77
- boolean: लॉजिकल मान true या false
- string: अनलिमिटेड लंबाई का स्ट्रिंग मान
- array of string: स्ट्रिंग की ऐरे