SMM पैनल API डॉक्यूमेंटेशन

SMM पैनल API क्या है?

SMM पैनल API से कोई प्रोग्राम वेबसाइट खोले बिना सर्विस लिस्ट ले सकता है, ऑर्डर दे सकता है और ऑर्डर स्टेटस व बैलेंस देख सकता है। 4SNS PLUS कई पैनल और बॉट में इस्तेमाल होने वाला स्टैंडर्ड SMM पैनल API v2 फॉर्मेट सपोर्ट करता है, इसलिए किसी दूसरे पैनल से जुड़ा आपका कोड सिर्फ URL और key बदलते ही तुरंत काम करता है।

API की कीमतें और बैलेंस वेबसाइट जैसे ही हैं। services रिस्पॉन्स का rate प्राइस लिस्ट में प्रति 1,000 की कीमत (US डॉलर) के बराबर है, और add से दिए गए ऑर्डर वेब ऑर्डर की तरह ही बैलेंस से कटते हैं और डैशबोर्ड की ऑर्डर हिस्ट्री में भी दिखते हैं। कैंसल या पार्शियल ऑर्डर की वापसी राशि उसी बैलेंस में लौटती है।

बुनियादी जानकारी

रिक्वेस्ट उदाहरण

curl -X POST https://4snsplus.com/api/v2 \
  -d key=YOUR_API_KEY \
  -d action=balance

import requests

r = requests.post("https://4snsplus.com/api/v2", data={
    "key": "YOUR_API_KEY",
    "action": "add",
    "service": 2210,
    "link": "https://t.me/yourchannel",
    "quantity": 1000,
})
print(r.json())  # {"order": 31877} or {"error": "..."}

API key कैसे मिलेगी?

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

key आपके अकाउंट टोकन से अलग है। अपने बॉट या सर्वर में सिर्फ API key रखें, अकाउंट टोकन कभी नहीं। अगर लगे कि key किसी और को दिख गई है, तो API key स्क्रीन पर बस नई key बना लें।

सर्विस लिस्ट (services)

ऑर्डर की जा सकने वाली हर सर्विस लौटाता है। rate प्रति 1,000 की कीमत (USD) है, और type Package होने पर यह एक पैकेज की कीमत है। type Custom Comments होने पर आप मात्रा की जगह कमेंट की लिस्ट भेजते हैं। category प्लेटफॉर्म का नाम और ग्रुप का नाम है।

रिस्पॉन्स उदाहरण

[
  {
    "service": 2210,
    "name": "Members - 30 Days Non Drop - 30 Days Refill",
    "type": "Default",
    "category": "Telegram - Members (30 Days Non Drop)",
    "rate": "1.4300",
    "min": "100",
    "max": "50000",
    "refill": true,
    "cancel": false
  }
]

ऑर्डर देना (add)

ऑर्डर देता है और राशि आपके बैलेंस से काटता है। राशि प्रति 1,000 की कीमत गुणा मात्रा होती है; Package में यह पैकेज की कीमत है, और Custom Comments में कमेंट लाइनों की संख्या ही मात्रा है। ऑर्डर उन अकाउंट पर उपलब्ध हैं जिनका पहला टॉप अप जुड़ चुका है। रिस्पॉन्स में order आपका ऑर्डर ID है।

रिस्पॉन्स उदाहरण

{
  "order": 31877
}

ऑर्डर स्टेटस (status)

एक ऑर्डर का स्टेटस। charge रिफंड के बाद असल में चुकाई गई राशि है (USD, 6 दशमलव), start_count ऑर्डर शुरू होते समय की गिनती है, और remains अभी डिलीवर न हुई मात्रा है।

रिस्पॉन्स उदाहरण

{
  "charge": "1.430000",
  "start_count": "8120",
  "status": "In progress",
  "remains": "410",
  "currency": "USD"
}

कई ऑर्डर का स्टेटस (status, orders)

कॉमा से जुड़े ऑर्डर ID के साथ एक बार में 100 ऑर्डर तक जांचता है। जो ID मौजूद नहीं हैं या आपके अकाउंट में नहीं हैं, उनकी जगह error आता है।

रिस्पॉन्स उदाहरण

{
  "1": { "charge": "0.300000", "start_count": "120", "status": "Completed", "remains": "0", "currency": "USD" },
  "10": { "error": "Incorrect order ID" }
}

रिफिल रिक्वेस्ट (refill)

रिफिल अवधि वाली सर्विस का ऑर्डर Completed या Partial होकर खत्म हुआ हो, तो खत्म होने के समय से गिनी गई रिफिल अवधि के अंदर रिक्वेस्ट करें। हर ऑर्डर पर एक खुली रिक्वेस्ट हो सकती है, और रिक्वेस्ट के बीच 24 घंटे का अंतर चाहिए।

रिस्पॉन्स उदाहरण

{
  "refill": 512
}

रिफिल स्टेटस (refill_status)

एक रिफिल रिक्वेस्ट का स्टेटस।

रिस्पॉन्स उदाहरण

{
  "status": "Completed"
}

बैलेंस (balance)

आपका बैलेंस (USD, 6 दशमलव)।

रिस्पॉन्स उदाहरण

{
  "balance": "84.120000",
  "currency": "USD"
}

ऑर्डर स्टेटस वैल्यू

रिफिल स्टेटस वैल्यू

एरर मैसेज

एरर HTTP 200 रिस्पॉन्स में error फ़ील्ड वाले JSON के रूप में आते हैं। अपने कोड में सबसे पहले error फ़ील्ड जांचें।

{
  "error": "Not enough funds on balance"
}

SMM पैनल API को Telegram बॉट से कैसे जोड़ें?