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 बडी पनि पढिन्छ, जुन cURL लाई array दिँदा PHP ले पठाउँछ
जवाफJSON, सधैं HTTP 200 सहित, हामीले पढ्न नसक्ने बडी वा धेरै ठूलो अनुरोधका लागि पनि। त्रुटि यस्तो हुन्छ: {"error": "…"}
पैसाअमेरिकी डलर। मूल्यहरू प्रति १,०००

सेवा सूची

अहिले अर्डर लिन सक्ने तपाईंका रुटहरू। बन्द गरिएको, वा सबै चरण बाहिरिएको रुट सूचीमा आउँदैन।

प्यारामिटरविवरण
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 मा डेलिभर नभएको भाग हुन्छ। यसले हरेक चरणले डेलिभर गरेको भाग गन्छ: एउटा चरणले केही भाग डेलिभर गरेर बाँकी अर्कोमा रद्द भएमा, अर्डर Canceled होइन, Partial हुन्छ। बाँकी शुल्क फिर्ता गर्ने निर्णय प्रदायकले गर्छ।
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 को जवाफ सधैं ३० सेकेन्डभित्र दिइन्छ। रुटले एकपछि अर्को गर्दै धेरै प्रदायकलाई सोध्न सक्छ; हरेकले त्यो समयको बाँकी भाग पाउँछ, र पर्खन नसकिने प्रदायकलाई सोधिँदैन नै। समय सकिँदा अन्तिम सोधिएको प्रदायकले जवाफ दिएको छैन भने, तपाईंले Pending स्थितिसहितको अर्डर नम्बर पाउनुहुन्छ, र जवाफ थाहा नभएसम्म रुट त्यहीँ रोकिन्छ। धेरैजसो अर्डरको जवाफ एक-दुई सेकेन्डमै आउँछ।

सीमा र सुरक्षा

  • प्रति की मिनेटमा 300 अनुरोध, तीमध्ये 120 अर्डर। एउटैमा बढीमा 100 अर्डर ID status कल।
  • की एक पटक मात्र देखाइन्छ र फिङ्गरप्रिन्टका रूपमा राखिन्छ। तपाईं र हामी कसैले पनि यसलाई फेरि पढ्न सक्दैनौं। यसलाई बदल्दा पुरानो की तुरुन्तै निष्क्रिय हुन्छ।
  • अनुमति दिइएका ठेगानाहरू। आफ्नो खातामा आफ्नो प्यानल सर्भरको ठेगाना राख्नुहोस्, अनि की अरू कतैबाट चल्दैन।
  • रुट ID गोप्य होइन, र हुनु पनि पर्दैन। यो रुटको मालिक खाताको कीसँग मात्र चल्छ।
  • तपाईंका सीमाहरू लागू रहन्छन्। हरेक प्यानलको दैनिक सीमा, रुटकै दैनिक सीमा र यसको सबैभन्दा ठूलो अर्डरको सीमा API मार्फत आउने अर्डरमा पनि ठ्याक्कै हातले गरिने अर्डरमा जस्तै लागू हुन्छन्।
  • पैसा कहिल्यै smm.guide हुँदै जाँदैन। हरेक अर्डरको भुक्तानी त्यो लिने प्यानलमा रहेको तपाईंको ब्यालेन्सबाट हुन्छ। रिफन्ड र विवाद तपाईं र त्यो प्यानलबीच रहन्छन्।

बरु क्याटलग पढ्न चाहनुहुन्छ?

प्यानल, Trust Score र लाइभ मूल्यहरूको आफ्नै API छ, र सहायकहरूका लागि MCP सर्भर पनि।