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 تائين آرڊر ID status ڪال.
  • ڪي هڪ ڀيرو ڏيکاري وڃي ٿي ۽ فنگر پرنٽ طور رکي وڃي ٿي. نه توهان ۽ نه اسان ان کي ٻيهر پڙهي سگهون ٿا. ان کي مٽائڻ سان پراڻي ڪي فوراً بند ٿي وڃي ٿي.
  • اجازت يافته ايڊريسون. پنهنجي اڪائونٽ ۾ پنهنجي پينل جي سرور جي ايڊريس لکو، پوءِ ڪي ٻي ڪنهن به جاءِ تان ڪم نه ڪندي.
  • روٽ ID راز ناهي ۽ ان کي راز هجڻ جي ضرورت به ناهي. اها صرف ان اڪائونٽ جي ڪي سان گڏ ڪم ڪري ٿي جيڪو روٽ جو مالڪ آهي.
  • توهان جون حدون لاڳو رهن ٿيون. هر پينل جي روزاني حد، روٽ جي پنهنجي روزاني حد ۽ ان جو سڀ کان وڏو آرڊر API ذريعي ايندڙ آرڊرن تي بلڪل ائين لاڳو ٿين ٿا جيئن هٿ سان ڏنل آرڊرن تي.
  • پئسا ڪڏهن به smm.guide مان نٿا گذرن. هر آرڊر جي ادائيگي ان پينل تي توهان جي بيلنس مان ٿئي ٿي جيڪو ان کي وٺي ٿو. رقم واپسي ۽ تڪرار توهان ۽ ان پينل جي وچ ۾ رهن ٿا.

ان جي بدران ڪيٽلاگ پڙهڻ چاهيو ٿا؟

پينلن، Trust Score ۽ لائيو قيمتن جو پنهنجو API آهي، ۽ اسسٽنٽس لاءِ MCP سرور.