होम / डेवलपर / Orders API

Orders API

smm.guide को अपने पैनल में प्रोवाइडर के रूप में जोड़ें। अपने अकाउंट में आप जो भी रूट बनाते हैं, वह अपनी ID वाली एक सेवा है: आपका पैनल उस ID पर ऑर्डर भेजता है, और रूट उसे आपके प्रोवाइडर में से उस पहले प्रोवाइडर को सौंप देता है जो उसे ले सकता है।

तीन स्टेप

फ़ॉर्मेट वही है जो SMM पैनल आपस में पहले से इस्तेमाल करते हैं, इसलिए कुछ भी प्रोग्राम करने की ज़रूरत नहीं।

1रूट बनाएँअकाउंट, Orders desk, रूट। चुनें कि वह क्या डिलीवर करेगा, और कनेक्ट किए गए पैनलों से उस प्रकार की अधिकतम पाँच सेवाएँ जोड़ें।
2कुंजी बनाएँOrders desk, Orders API। कुंजी सिर्फ़ एक बार दिखाई जाती है। आप इसे अपने पैनल के सर्वर के पते तक सीमित कर सकते हैं।
3अपने पैनल में प्रोवाइडर जोड़ेंAPI URL https://smm.guide/api/v2 और कुंजी। सेवाएँ इम्पोर्ट करें: आपके रूट अपनी ID, कीमतों और सीमाओं के साथ आ जाते हैं।

अनुरोध का फ़ॉर्मेट

HTTP मेथडPOST
API URLhttps://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 कुंजी
actionservices

जवाब

[
  {
    "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 कुंजी
actionadd
serviceरूट की ID, आठ अंक
linkपेज, पोस्ट या प्रोफ़ाइल का लिंक
quantityज़रूरी मात्रा

जवाब

{
  "order": 23501
}

किसी ने स्वीकार नहीं किया

{
  "error": "No step of this route accepted the order. …"
}

ऑर्डर नंबर ऑर्डर के पूरे जीवनकाल में वही रहता है, चाहे आखिर में कोई भी प्रोवाइडर उसे डिलीवर करे। रूट एक लिंक और एक मात्रा लेता है; ड्रिप-फ़ीड, कमेंट और दूसरे अतिरिक्त फ़ील्ड अस्वीकार किए जाते हैं।

ऑर्डर स्टेटस

पैरामीटरविवरण
keyआपकी API कुंजी
actionstatus
orderऑर्डर ID

जवाब

{
  "charge": "0.0045",
  "start_count": "3572",
  "status": "In progress",
  "remains": "157",
  "currency": "USD"
}
पैरामीटरविवरण
keyआपकी API कुंजी
actionstatus
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 कुंजी
actionbalance

जवाब

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

रद्द करें

उस प्रोवाइडर को भेजा जाता है जिसके पास अभी ऑर्डर है, अगर उसकी सेवा कैंसल की सुविधा देती है। आपका कैंसल किया गया ऑर्डर कभी अगले स्टेप पर नहीं भेजा जाता।

पैरामीटरविवरण
keyआपकी API कुंजी
actioncancel
ordersकॉमा से अलग किए ऑर्डर ID, अधिकतम 100

जवाब

[
  { "order": 23501, "cancel": 1 },
  { "order": 23502, "cancel": { "error": "The order is already finished" } }
]

रीफ़िल

उस प्रोवाइडर को भेजा जाता है जिसने ऑर्डर डिलीवर किया। रीफ़िल ऑर्डर के अपने नंबर के साथ जाता है।

पैरामीटरविवरण
keyआपकी API कुंजी
actionrefill
orderऑर्डर ID। या orders: कई, कॉमा से अलग किए हुए

जवाब, एक ऑर्डर

{ "refill": "23501" }

जवाब, कई ऑर्डर

[
  { "order": 23501, "refill": 23501 },
  { "order": 23502, "refill": { "error": "…" } }
]
पैरामीटरविवरण
keyआपकी API कुंजी
actionrefill_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 सर्वर भी।