Orders API
smm.guide को अपने पैनल में प्रोवाइडर के रूप में जोड़ें। अपने अकाउंट में आप जो भी रूट बनाते हैं, वह अपनी ID वाली एक सेवा है: आपका पैनल उस ID पर ऑर्डर भेजता है, और रूट उसे आपके प्रोवाइडर में से उस पहले प्रोवाइडर को सौंप देता है जो उसे ले सकता है।
तीन स्टेप
फ़ॉर्मेट वही है जो SMM पैनल आपस में पहले से इस्तेमाल करते हैं, इसलिए कुछ भी प्रोग्राम करने की ज़रूरत नहीं।
https://smm.guide/api/v2 और कुंजी। सेवाएँ इम्पोर्ट करें: आपके रूट अपनी ID, कीमतों और सीमाओं के साथ आ जाते हैं।अनुरोध का फ़ॉर्मेट
| HTTP मेथड | POST |
| API URL | https://smm.guide/api/v2 |
| बॉडी | application/x-www-form-urlencoded, या JSON, इस हेडर के साथ: Content-Type: application/json. A multipart/form-data बॉडी भी पढ़ी जाती है — PHP यही भेजता है जब cURL को array दिया जाता है |
| जवाब | JSON, हमेशा HTTP 200 के साथ, उस बॉडी के लिए भी जिसे हम पढ़ नहीं सकते और बहुत बड़े अनुरोध के लिए भी। त्रुटि ऐसी दिखती है: {"error": "…"} |
| पैसा | US डॉलर। कीमतें प्रति 1,000 हैं |
सेवाओं की सूची
आपके वे रूट जो अभी ऑर्डर ले सकते हैं। बंद किया गया रूट, या जिसका हर स्टेप बाहर है, सूची में नहीं आता।
| पैरामीटर | विवरण |
|---|---|
key | आपकी API कुंजी |
action | services |
जवाब
[
{
"service": 85725095,
"name": "TG views, main",
"type": "Default",
"category": "Telegram views",
"rate": "0.0018",
"min": "10",
"max": "1000000",
"refill": false,
"cancel": true,
"dripfeed": false
}
]rate रूट के उन स्टेप में सबसे महँगे की कीमत है जो ऑर्डर ले सकते हैं, फ़िलहाल छोड़े गए स्टेप समेत (जो पैनल आज बंद है, वह कल वापस आ जाता है), इसलिए ऑर्डर की कीमत कभी उस कीमत से ज़्यादा नहीं होती जो आपके पैनल ने इम्पोर्ट की। min और max चालू स्टेप मिलकर जितनी सबसे चौड़ी सीमा कवर करते हैं, वही हैं; जो मात्रा सिर्फ़ कुछ स्टेप में फ़िट होती है, वह उन्हीं में से किसी एक पर जाती है। refill और cancel तब true होते हैं, जब हर ऐसा स्टेप यह सुविधा देता है।
बंद किया गया रूट, या जिसका कोई भी स्टेप काम नहीं कर सकता, वापस आने तक इस सूची से बाहर रहता है। जो पैनल अपनी सेवाएँ अपने-आप सिंक करता है, वह उतने समय के लिए अपनी तरफ़ वह सेवा बंद कर देगा, और आप यही चाहते हैं: वरना उसके ऑर्डर अस्वीकार हो जाते।
ऑर्डर जोड़ें
| पैरामीटर | विवरण |
|---|---|
key | आपकी API कुंजी |
action | add |
service | रूट की ID, आठ अंक |
link | पेज, पोस्ट या प्रोफ़ाइल का लिंक |
quantity | ज़रूरी मात्रा |
जवाब
{
"order": 23501
}
किसी ने स्वीकार नहीं किया
{
"error": "No step of this route accepted the order. …"
}ऑर्डर नंबर ऑर्डर के पूरे जीवनकाल में वही रहता है, चाहे आखिर में कोई भी प्रोवाइडर उसे डिलीवर करे। रूट एक लिंक और एक मात्रा लेता है; ड्रिप-फ़ीड, कमेंट और दूसरे अतिरिक्त फ़ील्ड अस्वीकार किए जाते हैं।
ऑर्डर स्टेटस
| पैरामीटर | विवरण |
|---|---|
key | आपकी API कुंजी |
action | status |
order | ऑर्डर ID |
जवाब
{
"charge": "0.0045",
"start_count": "3572",
"status": "In progress",
"remains": "157",
"currency": "USD"
}| पैरामीटर | विवरण |
|---|---|
key | आपकी API कुंजी |
action | status |
orders | कॉमा से अलग किए ऑर्डर ID, अधिकतम 100 |
जवाब
{
"23501": {
"charge": "0.0045",
"start_count": "3572",
"status": "Completed",
"remains": "0",
"currency": "USD"
},
"99": { "error": "Incorrect order ID" }
}| स्टेटस | मतलब |
|---|---|
Pending | किसी प्रोवाइडर ने स्वीकार किया है और अभी शुरू नहीं हुआ। यह वह ऑर्डर भी हो सकता है जिस पर किसी प्रोवाइडर ने साफ़ जवाब नहीं दिया: जब तक आप अपने अकाउंट में उसकी जाँच नहीं करते, रूट वहीं रुका रहता है। |
In progress, Processing | कोई प्रोवाइडर इसे डिलीवर कर रहा है, या ऑर्डर अगले स्टेप की ओर जा रहा है। |
Completed | पूरा डिलीवर हुआ। |
Partial | आंशिक रूप से डिलीवर हुआ; remains वह मात्रा है जो डिलीवर नहीं हुई। इसमें हर स्टेप की डिलीवरी गिनी जाती है: जब एक स्टेप ने कुछ हिस्सा डिलीवर किया और बाकी अगले स्टेप पर कैंसल हुआ, तो ऑर्डर Partial होता है, Canceled नहीं। बाकी शुल्क लौटाने का फ़ैसला प्रोवाइडर करता है। |
Canceled | कुछ भी डिलीवर नहीं हुआ, और किसी दूसरे स्टेप ने ऑर्डर नहीं लिया। charge दिखाता है कि अगर कुछ शुल्क लगा रहा, तो कितना। |
charge वह राशि है जो प्रोवाइडर ने इस ऑर्डर के लिए ली, ऑर्डर वाले दिन की दर पर डॉलर में। start_count उस प्रोवाइडर से आता है जिसने इसे शुरू किया।
बैलेंस
smm.guide आपका कोई पैसा नहीं रखता। यह आँकड़ा आपके रूट के पीछे के पैनलों पर आपके बैलेंस का जोड़ है, डॉलर में।
| पैरामीटर | विवरण |
|---|---|
key | आपकी API कुंजी |
action | balance |
जवाब
{
"balance": "126.1375",
"currency": "USD"
}रद्द करें
उस प्रोवाइडर को भेजा जाता है जिसके पास अभी ऑर्डर है, अगर उसकी सेवा कैंसल की सुविधा देती है। आपका कैंसल किया गया ऑर्डर कभी अगले स्टेप पर नहीं भेजा जाता।
| पैरामीटर | विवरण |
|---|---|
key | आपकी API कुंजी |
action | cancel |
orders | कॉमा से अलग किए ऑर्डर ID, अधिकतम 100 |
जवाब
[
{ "order": 23501, "cancel": 1 },
{ "order": 23502, "cancel": { "error": "The order is already finished" } }
]रीफ़िल
उस प्रोवाइडर को भेजा जाता है जिसने ऑर्डर डिलीवर किया। रीफ़िल ऑर्डर के अपने नंबर के साथ जाता है।
| पैरामीटर | विवरण |
|---|---|
key | आपकी API कुंजी |
action | refill |
order | ऑर्डर ID। या orders: कई, कॉमा से अलग किए हुए |
जवाब, एक ऑर्डर
{ "refill": "23501" }
जवाब, कई ऑर्डर
[
{ "order": 23501, "refill": 23501 },
{ "order": 23502, "refill": { "error": "…" } }
]| पैरामीटर | विवरण |
|---|---|
key | आपकी API कुंजी |
action | refill_status |
refill | रीफ़िल ID। या refills: कई, कॉमा से अलग किए हुए |
जवाब
{ "status": "Completed" }रूट ऑर्डर के साथ क्या करता है
- स्टेप आपके क्रम में आज़माए जाते हैं, या सबसे सस्ता चालू स्टेप पहले। कौन-सा तरीका, यह आप रूट में चुनते हैं।
- स्टेप छोड़ दिया जाता है, जब उसका पैनल जवाब नहीं दे रहा, उसका बैलेंस या दैनिक सीमा ऑर्डर के लिए काफ़ी नहीं, मात्रा उसकी सीमा से बाहर है, उसकी कीमत आपकी तय सीमा से ज़्यादा है, या उसकी कीमत पर ऑर्डर रूट की अपनी दैनिक सीमा पार कर जाएगा। वह अपने-आप वापस आ जाता है।
- स्टेप बाहर हो जाता है, जब उसकी सेवा प्राइस लिस्ट से हट जाती है, या पैनल उसी ID पर कुछ और बेचने लगता है। बाकी स्टेप काम करते रहते हैं, और आपको सूचना दी जाती है।
- इनकार होने पर ऑर्डर आगे बढ़ता है। जब पैनल जवाब देकर मना करता है, तो कोई शुल्क नहीं लगता, इसलिए अगला स्टेप आज़माया जाता है।
- साफ़ जवाब न मिलने पर यह रुक जाता है। टाइमआउट या टूटा हुआ जवाब यह नहीं बताता कि ऑर्डर बना या नहीं। उसे आगे भेजने से वह दो बार डिलीवर और चार्ज हो सकता है, इसलिए रूट रुक जाता है और आप अपने अकाउंट में उस एक ऑर्डर की जाँच करते हैं।
- एक लिंक पर एक चालू ऑर्डर। जब किसी लिंक का ऑर्डर रूट पर चल रहा हो, उसी लिंक का दूसरा ऑर्डर अस्वीकार किया जाता है, जैसा प्रोवाइडर खुद करते हैं।
- डिलीवरी से पहले हुआ कैंसल भी आगे बढ़ सकता है, अगर आपने यह चालू किया हो। आंशिक ऑर्डर में जो डिलीवर नहीं हुआ, वह सिर्फ़ तभी आगे जाता है जब आपने ऐसा कहा हो।
त्रुटियाँ
| त्रुटि | इसका मतलब |
|---|---|
Invalid API key | कुंजी गलत है, बदली जा चुकी है या निरस्त की गई है। |
This key is limited to certain addresses… | अनुरोध ऐसे पते से आया जो कुंजी की सूची में नहीं है। |
Incorrect request | अज्ञात action. |
Incorrect service ID | आपके किसी भी रूट की यह ID नहीं है। हटाया गया रूट अपना नंबर रखता है, और वह किसी और को कभी नहीं दिया जाता। |
Incorrect order ID | आपके किसी भी ऑर्डर का यह नंबर नहीं है। |
Link is required, Quantity is required | अनुरोध add का कोई फ़ील्ड गायब है या नंबर नहीं है। |
A route takes a link and a quantity only | अनुरोध में ड्रिप-फ़ीड, कमेंट या कोई दूसरा अतिरिक्त फ़ील्ड था। |
This route is switched off | इसे अपने अकाउंट में चालू करें। |
This route already has an order for this link… | चल रहे ऑर्डर के पूरा होने तक इंतज़ार करें। |
No step of this route can take this order right now. … | कुछ भी भेजे जाने से पहले हर स्टेप छोड़ दिया गया। टेक्स्ट में हर पैनल और उसका कारण लिखा होता है। |
No step of this route accepted the order. … | जिन स्टेप से पूछा गया, सबने मना कर दिया। कोई शुल्क नहीं लगा। |
Too many requests… | नीचे दी गई सीमा पार हो गई। एक मिनट इंतज़ार करें। |
उदाहरण
cURL
curl https://smm.guide/api/v2 \ -d key=sgo_… \ -d action=add \ -d service=85725095 \ -d link=https://t.me/channel/123 \ -d quantity=1000
PHP
function smmguide(array $post) {
$ch = curl_init('https://smm.guide/api/v2');
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_POSTFIELDS => http_build_query(
['key' => 'sgo_…'] + $post),
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 60,
]);
$out = json_decode(curl_exec($ch), true);
curl_close($ch);
return $out;
}
$order = smmguide(['action' => 'add',
'service' => 85725095,
'link' => 'https://t.me/channel/123',
'quantity' => 1000]);
हर add अनुरोध का जवाब हमेशा 30 सेकंड के भीतर मिलता है। रूट एक के बाद एक कई प्रोवाइडर से पूछ सकता है; हर एक को उस समय में से बचा हुआ हिस्सा मिलता है, और जिस प्रोवाइडर का इंतज़ार नहीं किया जा सकता, उससे पूछा ही नहीं जाता। अगर समय खत्म होने तक आखिरी प्रोवाइडर ने जवाब नहीं दिया, तो आपको Pending स्टेटस के साथ ऑर्डर नंबर मिलता है, और जवाब पता चलने तक रूट वहीं रुका रहता है। ज़्यादातर ऑर्डर का जवाब एक-दो सेकंड में मिल जाता है।
सीमाएँ और सुरक्षा
- हर कुंजी पर एक मिनट में 300 अनुरोध, जिनमें से 120 ऑर्डर। एक बार में अधिकतम 100 ऑर्डर ID
statusकॉल। - कुंजी सिर्फ़ एक बार दिखाई जाती है और फ़िंगरप्रिंट के रूप में रखी जाती है। न आप, न हम इसे दोबारा पढ़ सकते हैं। इसे बदलते ही पुरानी कुंजी तुरंत बंद हो जाती है।
- अनुमत पते। अपने अकाउंट में अपने पैनल के सर्वर का पता दर्ज करें, फिर कुंजी कहीं और से काम नहीं करेगी।
- रूट ID कोई सीक्रेट नहीं है, और इसकी ज़रूरत भी नहीं। यह सिर्फ़ उस अकाउंट की कुंजी के साथ काम करती है जिसका रूट है।
- आपकी सीमाएँ लागू रहती हैं। हर पैनल की दैनिक सीमा, रूट की अपनी दैनिक सीमा और उसका सबसे बड़ा ऑर्डर API से आने वाले ऑर्डर पर ठीक वैसे ही लागू होते हैं जैसे आपके खुद दिए गए ऑर्डर पर।
- पैसा कभी smm.guide से होकर नहीं जाता। हर ऑर्डर का भुगतान उसे लेने वाले पैनल पर आपके बैलेंस से होता है। रिफ़ंड और विवाद आपके और उस पैनल के बीच रहते हैं।
कैटलॉग पढ़ना चाहते हैं?
पैनल, Trust Score और लाइव कीमतों का अपना API है, और असिस्टेंट के लिए MCP सर्वर भी।