ہوم / ڈویلپرز / 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 اور کلید۔ سروسز امپورٹ کریں: آپ کے روٹس اپنی IDs، قیمتوں اور حدود کے ساتھ آ جاتے ہیں۔

درخواست کا فارمیٹ

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": "…"}
رقمامریکی ڈالر۔ قیمتیں فی 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آرڈر IDs کاما سے الگ کر کے، زیادہ سے زیادہ 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آرڈر IDs کاما سے الگ کر کے، زیادہ سے زیادہ 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 آرڈر IDs status کال۔
  • کلید ایک بار دکھائی جاتی ہے اور فنگر پرنٹ کی صورت میں رکھی جاتی ہے۔ نہ آپ اور نہ ہم اسے دوبارہ پڑھ سکتے ہیں۔ اسے بدلنے سے پرانی کلید فوراً بند ہو جاتی ہے۔
  • اجازت یافتہ پتے۔ اپنے اکاؤنٹ میں اپنے پینل کے سرور کا پتہ درج کریں، پھر کلید کہیں اور سے کام نہیں کرے گی۔
  • روٹ ID راز نہیں ہے اور اسے راز ہونے کی ضرورت بھی نہیں۔ یہ صرف اس اکاؤنٹ کی کلید کے ساتھ کام کرتی ہے جو روٹ کا مالک ہے۔
  • آپ کی حدود برقرار رہتی ہیں۔ ہر پینل کی یومیہ حد، روٹ کی اپنی یومیہ حد اور اس کا سب سے بڑا آرڈر API کے ذریعے آنے والے آرڈرز پر بالکل ویسے ہی لاگو ہوتے ہیں جیسے ہاتھ سے دیے گئے آرڈرز پر۔
  • رقم کبھی smm.guide سے نہیں گزرتی۔ ہر آرڈر کی ادائیگی اس پینل پر آپ کے بیلنس سے ہوتی ہے جو اسے لیتا ہے۔ ریفنڈز اور تنازعات آپ اور اس پینل کے درمیان رہتے ہیں۔

اس کے بجائے کیٹلاگ پڑھنا ہے؟

پینلز، Trust Scores اور لائیو قیمتوں کا اپنا API ہے، اور اسسٹنٹس کے لیے MCP سرور بھی۔