getNumber, getStatus, setStatus 3/6/8: एक्टिवेशन चक्र में पैसा कहाँ बर्बाद होता है
बॉट ने नंबर लिया, 30 सेकंड तक SMS नहीं दिखा, तो उसने setStatus 8 भेजा और अगले नंबर पर चला गया। सर्वर ने रद्द करने का अनुरोध ठुकरा दिया, पर जवाब किसी ने पढ़ा ही नहीं। बाद में उसी पहले नंबर पर कोड आ गया। ऑर्डर का भुगतान हो गया, और कोड किसी काम नहीं आया। नीचे API से एक्टिवेशन का पूरा चक्र कदम दर कदम दिया गया है, और साथ में वे ब्रांच भी, जहाँ इंटीग्रेशन ऐसे कोड के पैसे चुका देता है जिनकी उसे ज़रूरत ही नहीं।
चक्र, कदम दर कदम
- getNumber। बॉट किसी सेवा और देश के लिए नंबर माँगता है, ऑर्डर की राशि आपके बैलेंस में रिज़र्व हो जाती है, और जवाब में एक्टिवेशन id आता है। बॉट के सेवा में नंबर डालने से पहले यह id स्थायी स्टोरेज में सहेज लें। अगर प्रोसेस क्रैश हो गया, तो id के बिना आप न ऑर्डर रद्द कर पाएँगे, न कोड ले पाएँगे।
- getStatus। बॉट स्टेटस पूछता रहता है और कोड का इंतज़ार करता है। कितनी देर इंतज़ार करना है, यह कैटलॉग तय करता है: हर सेवा की अपनी अवधि होती है, अभी यह एक घंटा है।
- setStatus 3। उसी नंबर पर एक और कोड चाहिए: पहला काम नहीं आया, या सेवा दोबारा पुष्टि माँग रही है। 3 के बाद बॉट फिर से getStatus की पोलिंग पर लौट आता है।
- setStatus 6। कोड इस्तेमाल हो चुका है, और ऑर्डर पूरा हो गया।
- setStatus 8। रद्द करना। यह तभी स्वीकार होता है जब कोड अभी नहीं आया हो, और खरीद के कम से कम एक मिनट बाद ही।
अगर बॉट कुछ न करे और कोड न आए, तो अवधि खत्म होते ही रिज़र्व अपने आप आपके बैलेंस में लौट आता है। यहीं से इंटीग्रेशन का मुख्य नियम निकलता है: setStatus 8 से एक्टिवेशन रद्द करने पर रिफ़ंड सिर्फ़ कोड आने से पहले मिलता है। SMS मिलते ही हमारी सेवा पूरी मानी जाती है, और ऑर्डर का पैसा वापस नहीं होता। सभी रिफ़ंड आपके आंतरिक बैलेंस में आते हैं, वॉलेट में नहीं।
पैसा कहाँ बर्बाद होता है
पहले मिनट में रद्द करना। यह वही स्थिति है जिससे लेख शुरू हुआ था। हर setStatus 8 का जवाब पढ़ें। अगर एक मिनट वाले नियम की वजह से ऑर्डर रद्द नहीं हुआ, तो getStatus की पोलिंग जारी रखें और खरीद को एक मिनट पूरा होते ही दोबारा रद्द करने की कोशिश करें।
पोलिंग और रद्द करने की दौड़। getStatus ने "प्रतीक्षा में" लौटाया, बॉट ने 8 भेजा, और इन दो अनुरोधों के बीच कोड आ गया। अब ऑर्डर रद्द नहीं होगा। एक बार और getStatus बुलाएँ और कोड इस्तेमाल कर लें। ऑर्डर का भुगतान तो वैसे भी हो चुका है।
रजिस्ट्रेशन न हो पाने पर कोड के बाद रद्द करना। सेवा ने खाता ठुकरा दिया, तो डेवलपर 8 भेजता है और पैसे लौटने की उम्मीद करता है। कोड पहुँच चुका है, यानी हमारी सेवा पूरी हो चुकी है, और SMS मिलना किसी बाहरी सेवा पर सफल रजिस्ट्रेशन की गारंटी नहीं देता। ऐसे ऑर्डर स्टेटस 6 से बंद करें और रिपोर्ट में इन्हें रद्द हुए ऑर्डर से अलग गिनें।
छोड़ा हुआ नंबर। बॉट ऑर्डर रद्द किए बिना अगले नंबर पर चला जाता है, अक्सर इसलिए कि सभी सेवाओं के लिए एक ही टाइमआउट रखा गया है। अगर टाइमआउट सेवा की अवधि से छोटा है, तो कोड तब आ सकता है जब बॉट इंतज़ार करना छोड़ चुका हो, और आपका पैसा बेकार चला जाता है। टाइमआउट उसी सेवा की अवधि से लें, और जिस नंबर की अब ज़रूरत नहीं, उसे साफ़ तौर पर स्टेटस 8 से बंद करें।
स्टेटस 3 की जगह नया नंबर। पहला कोड काम नहीं आया, तो बॉट दूसरा नंबर खरीद लेता है। हर नया getNumber अपने रिज़र्व वाला एक अलग ऑर्डर है, और सेवा पर रजिस्ट्रेशन फिर शुरू से करना पड़ता है। उसी नंबर पर स्टेटस 3 से दोबारा कोड माँगें और जाँचें कि getStatus ने नया कोड लौटाया है, पिछला नहीं।
सफलता, जो बंद नहीं की गई। कोड डाल दिया गया, पर 6 भेजा ही नहीं गया। अवधि खत्म होने तक ऑर्डर खुला रहता है, और लॉग से अब पता नहीं चलता कि किन नंबरों का काम हो चुका है और कौन से अभी कोड का इंतज़ार कर रहे हैं। जैसे ही सेवा कोड स्वीकार करे, 6 भेज दें।
किसी दूसरे प्लेटफ़ॉर्म से हमारे पास आना। अगर बॉट सिर्फ़ बेस URL बदलकर हमारे पास आया है, तो उसकी स्टेटस वाली ब्रांच पिछले प्लेटफ़ॉर्म के नियमों के हिसाब से लिखी गई थीं। जाँचें कि रद्द करने से पहले एक मिनट की देरी रखी गई है, और टाइमआउट हमारे कैटलॉग में दी गई अवधियों के हिसाब से रखें।
पोलिंग, कुंजियाँ और softId
API की सीमा हर कुंजी पर 600 अनुरोध प्रति मिनट है। यानी आपके सभी खुले ऑर्डर मिलाकर दस अनुरोध प्रति सेकंड। बिना रुके चलने वाला getStatus लूप इस सीमा तक जल्दी पहुँच जाता है। सबसे खतरनाक स्थिति तब होती है जब आपका प्रोग्राम रेट लिमिट के इनकार को "कोड अभी नहीं आया" समझ लेता है और नंबर रद्द कर देता है या छोड़ देता है। हर ऑर्डर को कुछ सेकंड के अंतराल पर पोल करें, और रेट लिमिट वाले जवाब को अलग ब्रांच में सँभालें: रुकें, फिर दोबारा कोशिश करें।
API कुंजी से की गई खरीद का पैसा आपके बैलेंस से कटता है। हर बॉट या एनवायरनमेंट के लिए अलग नाम वाली कुंजी जारी करें। पैनल में आखिरी इस्तेमाल की तारीख से पता चलता है कि कौन सी कुंजियाँ बेकार पड़ी हैं, ताकि आप उन्हें रद्द कर सकें।
पार्टनर प्रोग्राम में शामिल सॉफ़्टवेयर मालिकों के लिए: पक्का करें कि हर getNumber के साथ softId भेजा जा रहा है। इसके बिना खरीद आपके software_id से नहीं जुड़ेगी, और उपयोगकर्ता के एक्टिवेशन से मिलने वाला 5% आपको नहीं मिलेगा। अगर ऑर्डर का रिफ़ंड होता है, तो उस पर मिला कमीशन काट लिया जाता है।
आज क्या जाँचें
अपने पैनल में "API दस्तावेज़" खोलें और उससे मिलाकर देखें कि आप हर स्टेटस को कैसे सँभालते हैं, सबसे पहले 8 का जवाब और हर सेवा की अवधि के हिसाब से रखे गए टाइमआउट। फिर "लेन-देन" फ़ीड में कोई अवधि चुनें और रिफ़ंड को बॉट के लॉग से मिलाएँ। जो भी ऑर्डर रद्द हुआ या बिना कोड के समाप्त हुआ, उसका पैसा आपके बैलेंस में लौटना चाहिए। अगर लॉग में ऑर्डर रद्द दिखता है, पर फ़ीड में उस ऑर्डर का सिर्फ़ भुगतान है, तो "ऑर्डर इतिहास" में नंबर खोजें और देखें कि बॉट ने 8 कब भेजा था: पहले मिनट में या कोड आ जाने के बाद।