सभी लेख

बेस URL बदल लिया। अब आगे क्या? बॉट को handler_api.php पर ले जाने की चेकलिस्ट

अगर आपका बॉट पहले से sms-activate जैसे API के साथ काम करता है, तो हमारे handler_api.php पर आना कॉन्फ़िग की एक ही पंक्ति से शुरू होता है: बेस URL। एंडपॉइंट एक ही है। अनुरोध GET से /stubs/handler_api.php पाथ पर जाते हैं, और मेथड के नाम वही हैं जो आप पहले से जानते हैं। मुश्किल हिस्सा वे धारणाएँ हैं जो आपके पुराने इंटीग्रेशन में पहले से बैठी हुई हैं: टाइमआउट, पोलिंग की आवृत्ति, देशों के ID, रिफ़ंड का लॉजिक। नीचे एक चेकलिस्ट है, जिसे हम अलग कुंजी पर पूरा करने की सलाह देते हैं, जब तक आपका प्रोडक्शन ट्रैफ़िक पुराने सेटअप पर ही चल रहा है।

कौन-से मेथड वही हैं

हमारा sms-activate के अनुकूल API बॉट का मुख्य चक्र getPrices → getNumber → getStatus → setStatus सँभालता है, और साथ में उसके आसपास के संदर्भ वाले कॉल भी:

  • getBalance: उस खाते का बैलेंस जिसकी यह कुंजी है;
  • getCountries और getServicesList: देशों और सेवाओं की सूचियाँ;
  • getPrices: सेवा और देश के हिसाब से कीमतें;
  • getNumber: किसी सेवा के लिए नंबर खरीदना;
  • getStatus: एक्टिवेशन का स्टेटस और कोड;
  • setStatus: 3 एक और कोड माँगने के लिए, 6 एक्टिवेशन पूरा करने के लिए, 8 रद्द करने के लिए।

अगर आपका बॉट दूसरे मेथड बुलाता है या setStatus में दूसरे मान भेजता है, तो स्विच करने से पहले कोड में वे जगहें ढूँढ लें। फिर स्टेजिंग पर जाँचें कि बॉट जवाब के साथ क्या करता है।

बॉट के लॉजिक में क्या जाँचें

  1. देशों और सेवाओं के कोड। पुराने कॉन्फ़िग से ID आँख मूँदकर न उठाएँ। getCountries और getServicesList बुलाएँ और उनकी तुलना उससे करें जो बॉट में हार्डकोड किया हुआ है।
  2. कोड के इंतज़ार का टाइमर। एक्टिवेशन की अवधि हर सेवा के लिए अलग तय होती है, अभी यह एक घंटा है। सभी सेवाओं के लिए एक ही कॉन्स्टेंट हो, तो बॉट या तो एक्टिवेशन को उसकी अवधि खत्म होने से पहले छोड़ देगा या पहले से बंद एक्टिवेशन की पोलिंग करता रहेगा। हर सेवा के लिए अलग टाइमर रखें और अवधियाँ स्टेजिंग पर जाँच लें।
  3. रद्द करना। खरीद के बाद पहले मिनट में setStatus=8 काम नहीं करता। अगर आपका बॉट कुछ गड़बड़ होते ही ऑर्डर तुरंत रद्द करता है, तो 60 सेकंड बाद दोबारा कोशिश जोड़ें।
  4. अनुरोधों का बजट। सीमा हर कुंजी पर 600 अनुरोध प्रति मिनट है। बॉट कोड getStatus की पोलिंग से पाता है, और सीमा का ज़्यादातर हिस्सा यही पोलिंग खा जाती है। तीस एक्टिवेशन की हर सेकंड पोलिंग से 1800 अनुरोध प्रति मिनट बनते हैं, यानी सीमा से तीन गुना। वही तीस एक्टिवेशन हर पाँच सेकंड में एक बार पोल हों, तो 360 बनते हैं, और getPrices और getBalance के लिए गुंजाइश बचती है।
  5. रिफ़ंड। अगर अवधि खत्म होने से पहले कोड नहीं आता, तो पैसे अपने आप लौट आते हैं। कोड आने से पहले रद्द करने पर भी यही होता है। रिफ़ंड सिर्फ़ खाते के आंतरिक बैलेंस में जाता है, कार्ड या वॉलेट पर नहीं। SMS मिलते ही हमारी सेवा पूरी मानी जाती है, और उस ऑर्डर का रिफ़ंड नहीं होता। अगर आप हर ऑर्डर के पैसों का अपना हिसाब रखते हैं, तो उसे इन नियमों से मिला लें।
  6. एक और कोड। setStatus=3 के बाद बॉट एक्टिवेशन बंद नहीं करता, बल्कि फिर से getStatus की पोलिंग पर लौट जाता है।
  7. मुद्रा। कीमतें और बैलेंस अमेरिकी डॉलर में हैं। अगर बॉट के कॉन्फ़िग में कीमत की सीमाएँ किसी और मुद्रा में हैं, तो उन्हें बदल लें।
  8. एक साथ चलने वाले ऑर्डर। आपकी सीमा खाते की साख पर निर्भर करती है। पैनल आपकी मौजूदा सीमा, उसमें से कितना इस्तेमाल में है, और पिछले 7 दिनों में कोड पाने वाले ऑर्डर का हिस्सा दिखाता है। जो बॉट "एहतियात के लिए" नंबर उठा लेता है और फिर उन्हें थोक में रद्द करता है, वह इस हिस्से को नीचे खींचता है।

सॉफ़्टवेयर मालिकों के लिए softId

अगर आप अपना सॉफ़्टवेयर बाँटते हैं, तो उसे हमारे पार्टनर प्रोग्राम से जोड़ सकते हैं। आवेदन मैन्युअल रूप से जाँचे जाते हैं, आम तौर पर एक दिन के अंदर। मंज़ूरी के बाद आपको software_id मिलता है। नंबर खरीदते समय आपका सॉफ़्टवेयर इसे softId पैरामीटर में भेजता है, और मालिक के तौर पर आपको अपने उपयोगकर्ताओं के हर एक्टिवेशन की कीमत का 5% मिलता है, बिना किसी ऊपरी सीमा के। उपयोगकर्ता अपने खातों से भुगतान करते हैं, और उनके लिए कीमत नहीं बदलती। यह पैरामीटर वैकल्पिक है: इसके बिना भी API ठीक वैसे ही काम करता है।

कुंजियाँ और स्टेजिंग पर जाँच

पैनल के "API" सेक्शन में आप नाम वाली कई कुंजियाँ जारी कर सकते हैं। कुंजी की स्ट्रिंग हम सिर्फ़ एक बार दिखाते हैं और उसका केवल फ़िंगरप्रिंट रखते हैं, इसलिए जारी करते ही कुंजी को अपने सीक्रेट स्टोर में रख लें। अगर कुंजी खो जाए, तो नई जारी करें और पुरानी रद्द कर दें। सीमा हर कुंजी के लिए अलग गिनी जाती है, इसलिए स्टेजिंग के टेस्ट आपके प्रोडक्शन बॉट के अनुरोध नहीं खाते।

चरण इसी क्रम में चलाएँ:

  1. getBalance: कुंजी स्वीकार होती है और बैलेंस दिखता है। चरण 3 से 5 के लिए बैलेंस में कम से कम दो एक्टिवेशन लायक राशि होनी चाहिए।
  2. getPrices: आपकी ज़रूरत की हर "सेवा + देश" जोड़ी के लिए कीमत मौजूद है।
  3. getNumber: नंबर जारी होता है और बॉट एक्टिवेशन ID सहेज लेता है।
  4. getStatus: बॉट प्रोडक्शन वाली रफ़्तार से पोलिंग करता है और सीमा के अंदर रहता है।
  5. दूसरा नंबर: उसे खरीदें, एक मिनट रुकें और setStatus=8 भेजें। ऑर्डर की राशि आपके बैलेंस में लौट आनी चाहिए।

पैनल में हर कुंजी के साथ उसके आखिरी इस्तेमाल की तारीख दिखती है। स्विच के बाद इससे पता चलता है कि अनुरोध प्रोडक्शन कुंजी से आ रहे हैं, और स्टेजिंग कुंजी शांत हो चुकी है और उसे रद्द किया जा सकता है।

शुरुआत पैनल के "API" सेक्शन से करें। "स्टेजिंग" जैसे नाम की कुंजी जारी करें, उस पर अपनी सेवाओं और देशों के लिए getBalance → getPrices → getNumber चलाएँ, और उसके बाद ही प्रोडक्शन कॉन्फ़िग में URL और कुंजी बदलें।

पहला नंबर एक मिनट में

रजिस्ट्रेशन में एक मिनट, बैलेंस भरने में दो, और कोड 20 सेकंड में।

नंबर खरीदें
कोई सदस्यता शुल्क नहींपहले घंटे में रिफ़ंड के साथ रद्द करें