मुख्य बातें
स्टैंडर्ड SMM पैनल API v2 के अनुरोध का तरीका, 6 action, रिस्पॉन्स के उदाहरण, एरर मैसेज और अनुरोध सीमा, रीसेलर के नज़रिए से।
SMM पैनल API एक कनेक्शन है जिससे दूसरा पैनल या आपका अपना प्रोग्राम अपने आप ऑर्डर डालता है और स्टेटस देखता है। 1PANEL PLUS स्टैंडर्ड SMM पैनल API v2 इस्तेमाल करता है, इसलिए अगर आपके पास किसी दूसरे पैनल से जुड़ा कोड पहले से है, तो बस एड्रेस और की बदलकर तुरंत जोड़ सकते हैं। API और वेबसाइट में वही सर्विस, वही प्रति 1,000 कीमत और वही बैलेंस इस्तेमाल होता है।
SMM पैनल API कौन इस्तेमाल करता है?
- रीसेलर: अपने पैनल पर सर्विस लिस्ट करके ग्राहकों के ऑर्डर अपने आप आगे भेजते हैं
- एजेंसी: कई चैनलों के ऑर्डर तय समय पर एक साथ डालती हैं
- डेवलपर: स्ट्रीम शुरू होने या नया वीडियो अपलोड होने पर ऑर्डर देने वाली स्क्रिप्ट बनाते हैं
- ऑपरेटर: बैलेंस और ऑर्डर स्टेटस अपनी मैनेजमेंट स्क्रीन पर एक जगह दिखाते हैं
API की कैसे मिलती है?
पहला टॉप अप जमा होने के बाद डैशबोर्ड के API की पेज पर इसे बनाएँ। की सिर्फ़ बनाते समय एक बार दिखती है, इसलिए उसे तुरंत कॉपी करके सुरक्षित जगह रखें। नई की बनाते ही पुरानी की काम करना बंद कर देती है, इसलिए की लीक होने का शक हो तो नई की बनाकर बदल दें।
API अनुरोध कैसे भेजें?
सभी अनुरोध एक ही एड्रेस https://1panelplus.com/api/v2 पर POST से भेजें। फ़ॉर्म फ़ील्ड (application/x-www-form-urlencoded या multipart) या JSON बॉडी (Content-Type: application/json) में से जो आसान लगे वह इस्तेमाल करें, और हर अनुरोध में key और action साथ डालें। सभी रिस्पॉन्स JSON में आते हैं।
अनुरोध का उदाहरण (फ़ॉर्म फ़ील्ड): key=YOUR_API_KEY&action=balance
अनुरोध का उदाहरण (JSON): {"key": "YOUR_API_KEY", "action": "balance"}
| action | साथ में भेजे जाने वाले मान | वापस मिलने वाले मान |
|---|---|---|
| services | कुछ नहीं | सर्विस लिस्ट |
| add | service, link, quantity या comments | order (ऑर्डर ID) |
| status | एक order या orders (कॉमा से 100 तक) | charge, start_count, status, remains, currency |
| refill | order | refill (रिफ़िल ID) |
| refill_status | refill | status |
| balance | कुछ नहीं | balance, currency |
- action
- services
- साथ में भेजे जाने वाले मान
- कुछ नहीं
- वापस मिलने वाले मान
- सर्विस लिस्ट
- action
- add
- साथ में भेजे जाने वाले मान
- service, link, quantity या comments
- वापस मिलने वाले मान
- order (ऑर्डर ID)
- action
- status
- साथ में भेजे जाने वाले मान
- एक order या orders (कॉमा से 100 तक)
- वापस मिलने वाले मान
- charge, start_count, status, remains, currency
- action
- refill
- साथ में भेजे जाने वाले मान
- order
- वापस मिलने वाले मान
- refill (रिफ़िल ID)
- action
- refill_status
- साथ में भेजे जाने वाले मान
- refill
- वापस मिलने वाले मान
- status
- action
- balance
- साथ में भेजे जाने वाले मान
- कुछ नहीं
- वापस मिलने वाले मान
- balance, currency
services से सर्विस लिस्ट कैसे लें?
action=services भेजें, तो बिक्री में मौजूद सभी सर्विस एक ऐरे के रूप में आती हैं। हर सर्विस में service (सर्विस ID), name, type, category, rate, min, max, refill और cancel होते हैं। rate प्रति 1,000 कीमत (USD) है, और type Package होने पर यह 1 पैकेज की कीमत है। रिफ़िल अवधि वाली सर्विस में refill true होता है, और cancel हमेशा false होता है। category में प्लेटफ़ॉर्म का नाम और कैटेगरी साथ लिखी होती है, इसलिए अपने पैनल की कैटेगरी वैसे ही बना सकते हैं।
रिस्पॉन्स का उदाहरण: [{"service": SERVICE_ID, "name": "सर्विस का नाम", "type": "Default", "category": "YouTube - कैटेगरी का नाम", "rate": "प्रति 1,000 कीमत", "min": "न्यूनतम मात्रा", "max": "अधिकतम मात्रा", "refill": true, "cancel": false}]
कीमतें और सर्विस बदल सकती हैं, इसलिए रीसेलर तय अंतराल पर services दोबारा लेकर अपने पैनल की कीमतें और न्यूनतम और अधिकतम मात्रा अपडेट रखें।
add से ऑर्डर कैसे डालें?
action=add के साथ service (सर्विस ID), link (पब्लिक लिंक) और quantity (मात्रा) भेजें, तो ऑर्डर दर्ज होता है और राशि तुरंत बैलेंस से कटती है। रिस्पॉन्स का order ही ऑर्डर ID है, इसे सेव करें और status और refill में इस्तेमाल करें। ऑर्डर उन अकाउंट से डाले जा सकते हैं जिनमें पहला टॉप अप जमा हो चुका है।
- सामान्य सर्विस: service, link और quantity भेजें
- Custom Comments सर्विस: quantity की जगह comments भेजें। हर लाइन में एक कमेंट, हर लाइन 500 अक्षर तक, और लाइनों की संख्या ही मात्रा है
- Package सर्विस: मात्रा भेजने की ज़रूरत नहीं। एक पैकेज के रूप में ऑर्डर होता है
अनुरोध का उदाहरण: key=YOUR_API_KEY&action=add&service=SERVICE_ID&link=https://www.youtube.com/watch?v=videoid&quantity=1000
रिस्पॉन्स का उदाहरण: {"order": ORDER_ID}
status से ऑर्डर स्टेटस कैसे देखें?
action=status के साथ order (एक ऑर्डर ID) भेजें, तो उस ऑर्डर का स्टेटस आता है, और orders में ऑर्डर ID कॉमा से जोड़कर भेजें, तो एक बार में 100 तक देख सकते हैं। कई ऑर्डर संभालते हैं, तो orders से एक साथ देखें, इससे अनुरोधों की संख्या काफ़ी बचती है।
रिस्पॉन्स का उदाहरण (एक): {"charge": "भुगतान की गई राशि", "start_count": "शुरुआती संख्या", "status": "In progress", "remains": "बची मात्रा", "currency": "USD"}
रिस्पॉन्स का उदाहरण (कई): {"ORDER_ID_1": {"charge": "...", "start_count": "...", "status": "Completed", "remains": "0", "currency": "USD"}, "ORDER_ID_2": {"error": "Incorrect order ID"}}
| status मान | मतलब |
|---|---|
| Pending | ऑर्डर मिल गया, शुरू होने का इंतज़ार या प्रोसेसिंग में जा रहा है |
| In progress | डिलीवरी जारी है |
| Completed | पूरी मात्रा डिलीवर हो गई |
| Partial | कुछ हिस्सा डिलीवर हुआ और बची राशि बैलेंस में लौट आई |
| Canceled | प्रोसेस नहीं हो सका और पूरी राशि बैलेंस में लौट आई |
- status मान
- Pending
- मतलब
- ऑर्डर मिल गया, शुरू होने का इंतज़ार या प्रोसेसिंग में जा रहा है
- status मान
- In progress
- मतलब
- डिलीवरी जारी है
- status मान
- Completed
- मतलब
- पूरी मात्रा डिलीवर हो गई
- status मान
- Partial
- मतलब
- कुछ हिस्सा डिलीवर हुआ और बची राशि बैलेंस में लौट आई
- status मान
- Canceled
- मतलब
- प्रोसेस नहीं हो सका और पूरी राशि बैलेंस में लौट आई
charge भुगतान की गई राशि में से रिफ़ंड हुई राशि घटाकर बचा मान है, इसलिए आंशिक या रद्द होने के बाद असल में खर्च हुई राशि तुरंत दिखती है। ऑर्डर स्टेटस लगभग हर 1 मिनट में अपने आप अपडेट होता है, इसलिए status भी लगभग 1 मिनट के अंतर पर देखना काफ़ी है।
refill और refill_status कैसे इस्तेमाल करें?
action=refill के साथ order भेजें, तो रिफ़िल का अनुरोध होता है और refill (रिफ़िल ID) वापस आता है। यह तब स्वीकार होता है जब रिफ़िल अवधि वाली सर्विस का ऑर्डर पूरा या आंशिक हो, ऑर्डर पूरा होने की तारीख से रिफ़िल अवधि बाकी हो, कोई रिफ़िल न चल रहा हो और पिछले अनुरोध को 24 घंटे हो चुके हों। action=refill_status के साथ refill भेजें, तो स्टेटस Pending, In progress, Completed या Rejected में से एक के रूप में बताया जाता है।
रिस्पॉन्स के उदाहरण: {"refill": REFILL_ID} और {"status": "Completed"}
रिफ़िल के नियम वेबसाइट जैसे ही हैं। पूरी शर्तें रिफ़िल अवधि की जानकारी में हैं।
balance से बैलेंस कैसे देखें?
action=balance भेजें, तो मौजूदा बैलेंस और करेंसी (USD) आती है। रीसेलर ऑर्डर आगे भेजने से पहले बैलेंस देखें, और बैलेंस एक तय राशि से कम होने पर अलर्ट भेजने की व्यवस्था रखें, तो ऑर्डर बिना रुके चलते रहते हैं।
रिस्पॉन्स का उदाहरण: {"balance": "मौजूदा बैलेंस", "currency": "USD"}
API एरर मैसेज का क्या मतलब है?
एरर JSON में आते हैं, जिसके error फ़ील्ड में अंग्रेज़ी वाक्य होता है। हर वाक्य का कारण तय है, इसलिए प्रोग्राम में उसे सीधे मिलाकर संभाल सकते हैं।
| error मान | मतलब |
|---|---|
| Invalid API key | की नहीं भेजी गई या गलत है |
| Too many requests | 1 मिनट की अनुरोध सीमा पार हो गई। थोड़ी देर बाद फिर भेजें |
| Add funds first | पहला टॉप अप जमा होने के बाद ऑर्डर कर सकते हैं |
| Incorrect service ID | यह बिक्री में मौजूद सर्विस ID नहीं है |
| Incorrect link | लिंक का फ़ॉर्मैट सही नहीं है |
| Quantity out of range | मात्रा सर्विस की न्यूनतम और अधिकतम सीमा से बाहर है |
| Incorrect comments | कमेंट की लाइन खाली है या किसी लाइन में 500 से ज़्यादा अक्षर हैं |
| Not enough funds on balance | बैलेंस ऑर्डर की राशि से कम है |
| Incorrect order ID | यह इस अकाउंट का ऑर्डर ID नहीं है |
| Incorrect refill ID | यह इस अकाउंट का रिफ़िल ID नहीं है |
| Incorrect action | action का मान 6 में से कोई नहीं है |
- error मान
- Invalid API key
- मतलब
- की नहीं भेजी गई या गलत है
- error मान
- Too many requests
- मतलब
- 1 मिनट की अनुरोध सीमा पार हो गई। थोड़ी देर बाद फिर भेजें
- error मान
- Add funds first
- मतलब
- पहला टॉप अप जमा होने के बाद ऑर्डर कर सकते हैं
- error मान
- Incorrect service ID
- मतलब
- यह बिक्री में मौजूद सर्विस ID नहीं है
- error मान
- Incorrect link
- मतलब
- लिंक का फ़ॉर्मैट सही नहीं है
- error मान
- Quantity out of range
- मतलब
- मात्रा सर्विस की न्यूनतम और अधिकतम सीमा से बाहर है
- error मान
- Incorrect comments
- मतलब
- कमेंट की लाइन खाली है या किसी लाइन में 500 से ज़्यादा अक्षर हैं
- error मान
- Not enough funds on balance
- मतलब
- बैलेंस ऑर्डर की राशि से कम है
- error मान
- Incorrect order ID
- मतलब
- यह इस अकाउंट का ऑर्डर ID नहीं है
- error मान
- Incorrect refill ID
- मतलब
- यह इस अकाउंट का रिफ़िल ID नहीं है
- error मान
- Incorrect action
- मतलब
- action का मान 6 में से कोई नहीं है
रिफ़िल अनुरोध पर ये भी आ सकते हैं: Refill is not available for this service (रिफ़िल अवधि के बिना सर्विस), Order is not finished yet (ऑर्डर अभी पूरा नहीं हुआ), Refill period has ended (रिफ़िल अवधि खत्म हो चुकी है), Refill already requested, try again later (रिफ़िल पहले से चल रहा है या 24 घंटे नहीं हुए)।
API अनुरोध कितनी बार भेज सकते हैं?
हर की से 1 मिनट में 300 अनुरोध तक भेज सकते हैं। स्टेटस देखने के लिए orders से 100-100 का समूह बनाएँ, और सर्विस लिस्ट सिर्फ़ ज़रूरत होने पर दोबारा लें, तो सीमा काफ़ी रहती है। जैसे, 1,000 ऑर्डर चल रहे हों, तो हर मिनट 10 अनुरोधों में सब देख सकते हैं।
रीसेलर बिक्री की कीमत कैसे तय करें?
API से मिलने वाला rate 1PANEL PLUS की प्रति 1,000 कीमत है, और अपने पैनल की बिक्री कीमत रीसेलर खुद तय करता है। जैसे, $2.00 rate वाली सर्विस पर 25% जोड़कर बेचें, तो प्रति 1,000 कीमत $2.50 होगी, और ग्राहक 4,000 ऑर्डर करे, तो बिक्री राशि $10.00 और 1PANEL PLUS में कटने वाली राशि $8.00 होगी। यह कीमत गणना समझाने के लिए उदाहरण है।
API किस क्रम में जोड़ें?
- बैलेंस टॉप अप करें और डैशबोर्ड में API की बनाएँ
- balance से की और कनेक्शन जाँचें
- services से सर्विस लिस्ट लेकर अपने पैनल पर डालें
- सबसे कम मात्रा के साथ एक बार add भेजकर ऑर्डर ID लें
- status से स्टेटस बदलता है या नहीं देखें, फिर ऑटो ऑर्डर चालू करें
curl, PHP, Python और Node.js के उदाहरण और सभी फ़ील्ड का विवरण API डॉक्यूमेंटेशन में है, और दूसरे सवाल अक्सर पूछे जाने वाले सवाल के API सेक्शन में देखें।