Orders API
smm.guide کو اپنے پینل میں بطور فراہم کنندہ شامل کریں۔ آپ کے اکاؤنٹ میں بنایا گیا ہر روٹ اپنی ID کے ساتھ ایک سروس ہے: آپ کا پینل اس ID پر آرڈر بھیجتا ہے، اور روٹ اسے آپ کے فراہم کنندگان میں سے اس پہلے کو دے دیتا ہے جو اسے لے سکے۔
تین مراحل
فارمیٹ وہی ہے جو SMM پینلز پہلے سے آپس میں استعمال کرتے ہیں، اس لیے کچھ پروگرام کرنے کی ضرورت نہیں۔
https://smm.guide/api/v2 اور کلید۔ سروسز امپورٹ کریں: آپ کے روٹس اپنی IDs، قیمتوں اور حدود کے ساتھ آ جاتے ہیں۔درخواست کا فارمیٹ
| 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": "…"} |
| رقم | امریکی ڈالر۔ قیمتیں فی 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 | آرڈر 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 کلید |
action | balance |
جواب
{
"balance": "126.1375",
"currency": "USD"
}منسوخ کریں
اس فراہم کنندہ کو بھیجا جاتا ہے جس کے پاس اب آرڈر ہے، اگر اس کی سروس منسوخی کی سہولت دیتی ہو۔ آپ کا منسوخ کیا گیا آرڈر کبھی اگلے مرحلے کو نہیں بھیجا جاتا۔
| پیرامیٹر | تفصیل |
|---|---|
key | آپ کی API کلید |
action | cancel |
orders | آرڈر IDs کاما سے الگ کر کے، زیادہ سے زیادہ 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 آرڈر IDs
statusکال۔ - کلید ایک بار دکھائی جاتی ہے اور فنگر پرنٹ کی صورت میں رکھی جاتی ہے۔ نہ آپ اور نہ ہم اسے دوبارہ پڑھ سکتے ہیں۔ اسے بدلنے سے پرانی کلید فوراً بند ہو جاتی ہے۔
- اجازت یافتہ پتے۔ اپنے اکاؤنٹ میں اپنے پینل کے سرور کا پتہ درج کریں، پھر کلید کہیں اور سے کام نہیں کرے گی۔
- روٹ ID راز نہیں ہے اور اسے راز ہونے کی ضرورت بھی نہیں۔ یہ صرف اس اکاؤنٹ کی کلید کے ساتھ کام کرتی ہے جو روٹ کا مالک ہے۔
- آپ کی حدود برقرار رہتی ہیں۔ ہر پینل کی یومیہ حد، روٹ کی اپنی یومیہ حد اور اس کا سب سے بڑا آرڈر API کے ذریعے آنے والے آرڈرز پر بالکل ویسے ہی لاگو ہوتے ہیں جیسے ہاتھ سے دیے گئے آرڈرز پر۔
- رقم کبھی smm.guide سے نہیں گزرتی۔ ہر آرڈر کی ادائیگی اس پینل پر آپ کے بیلنس سے ہوتی ہے جو اسے لیتا ہے۔ ریفنڈز اور تنازعات آپ اور اس پینل کے درمیان رہتے ہیں۔
اس کے بجائے کیٹلاگ پڑھنا ہے؟
پینلز، Trust Scores اور لائیو قیمتوں کا اپنا API ہے، اور اسسٹنٹس کے لیے MCP سرور بھی۔