SMM पैनल API: मानक API से ऑर्डर ऑटोमेशन

अगर आप थोक में ऑर्डर देते हैं, अपना स्टोरफ़्रंट चलाते हैं या अपने ग्राहकों को सेवाएँ बेचते हैं, तो हर ऑर्डर हाथ से डालना लंबे समय तक नहीं चलता। EtkilesimBayim की SMM पैनल API आपके अपने स्क्रिप्ट या पैनल को ऑर्डर बनाने, स्थिति जाँचने और रिफ़िल का अनुरोध भेजने का काम अपने आप करने देती है। यह रीसेलर पैनलों में प्रचलित मानक action-आधारित फ़ॉर्मैट पर चलती है, इसलिए कई मौजूदा स्क्रिप्ट और पैनल सॉफ़्टवेयर बहुत कम या बिना बदलाव के जुड़ सकते हैं।

एंडपॉइंट और ऑथेंटिकेशन

सभी अनुरोध एक ही पते पर जाते हैं: https://etkilesimbayim.com/api/v2। अनुरोध POST से (फ़ॉर्म या JSON) भेजें; कनेक्शन जाँचने के लिए उन्हीं पैरामीटर के साथ GET भी चलता है। हर अनुरोध में दो पैरामीटर ज़रूरी हैं: key (आपकी API कुंजी) और action। API कुंजी आपको रजिस्टर करने के बाद अकाउंट पेज पर मिलती है। जवाब हमेशा JSON में आते हैं।

समर्थित action

Action	क्या करता है	पैरामीटर
services	सभी सक्रिय और दिखने वाली सेवाओं की सूची देता है: प्रति 1000 कीमत, न्यूनतम/अधिकतम मात्रा, प्रकार और कैंसल समर्थन	कोई नहीं
add	ऑर्डर बनाता है और ऑर्डर नंबर लौटाता है	service, link, quantity
status	एक या कई ऑर्डर का चार्ज, शुरुआती संख्या, स्थिति और बची मात्रा लौटाता है	order (कई हों तो कॉमा से अलग)
refill	रिफ़िल अनुरोध को समीक्षा के लिए कतार में डालता है	order या orders (अधिकतम 100)
refill_status	रिफ़िल अनुरोध की स्थिति लौटाता है	refill या refills (अधिकतम 100)
cancel	कैंसल समर्थित सेवाओं के लिए रद्द करने का अनुरोध बनाता है	orders (अधिकतम 100)
balance	आपका मौजूदा बैलेंस और मुद्रा लौटाता है	कोई नहीं

उदाहरण अनुरोध

ऑर्डर बनाना कुछ ऐसा दिखता है:

POST https://etkilesimbayim.com/api/v2
key=YOUR_API_KEY&action=add&service=1&link=https://instagram.com/example&quantity=1000

Response: { "order": 123 }

status से मिलने वाली ऑर्डर स्थितियाँ: Pending, Processing, In progress, Completed, Partial, Canceled और Fail। रिफ़िल अनुरोध Pending, In progress, Completed या Rejected स्थितियों से गुज़रते हैं।

त्रुटि संभालना

त्रुटियाँ HTTP 200 के साथ और { "error": "Not enough funds" } जैसे JSON बॉडी में आती हैं; ज़्यादातर रीसेलर स्क्रिप्ट इसी तरह की उम्मीद करती हैं। आम संदेश: कुंजी न होना या ग़लत होना, ग़लत action, अपर्याप्त बैलेंस और ऑर्डर नहीं मिला। आपका कोड HTTP स्टेटस पर निर्भर रहने के बजाय हर जवाब में error फ़ील्ड जाँचे।

इंटीग्रेशन के सुझाव

• सेवाओं की सूची कैश करें। services को हर ऑर्डर से पहले नहीं, तय अंतराल पर बुलाएँ; कीमत और उपलब्धता बदल सकती है, इसलिए सूची समय-समय पर ताज़ा करें।
• स्थिति समझदारी से पूछें। हर ऑर्डर के लिए अलग अनुरोध की जगह कॉमा से कई ऑर्डर नंबर एक साथ भेजें। हर API कुंजी पर अनुरोध-सीमा लागू होती है, इसलिए बेवजह बार-बार न पूछें।
• Partial और Fail ऑर्डर संभालें। इन स्थितियों पर अपनी प्रक्रिया चलाएँ, जैसे ग्राहक को बताना या दोबारा कोशिश।
• रिफ़िल और कैंसल अनुरोध हैं। रिफ़िल अनुरोध समीक्षा के लिए कतार में जाते हैं, तुरंत पूरे नहीं होते। कैंसल सिर्फ़ उन सेवाओं में चलता है जो cancel: true बताती हैं।
• अपनी कुंजी सुरक्षित रखें। उसे सिर्फ़ सर्वर-साइड रखें; ब्राउज़र कोड या सार्वजनिक रिपॉज़िटरी में न रखें।

API किसके लिए है?

यह हर उस व्यक्ति के लिए है जो ऑर्डर प्रोग्राम से देना चाहता है: अपने ग्राहकों को बेचने वाले रीसेलर, पैनल या स्टोर चलाने वाले, और दोहराए जाने वाले कैंपेन ऑटोमेट करने वाली एजेंसियाँ। किसी प्रदाता पर सिस्टम बनाने से पहले तुलना कर रहे हों तो सस्ता SMM पैनल कैसे चुनें और SMM रीसेलर पैनल कैसे शुरू करें पढ़ें। अपने ब्रांड के नाम से बेचने के लिए हमारा रीसेलर पैनल पेज देखें। सभी सेवाएँ सेवा और कीमत सूची में हैं, और SMM पैनल का परिचय पर लौट सकते हैं।

अनुरोध और जवाब का पूरा विवरण API दस्तावेज़ में है। API कुंजी पाने के लिए मुफ़्त अकाउंट बनाएँ।