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