صفحه اصلی / توسعهدهندگان / Orders API
Orders API
smm.guide را بهعنوان تأمینکننده به پنل خود اضافه کنید. هر مسیری که در حساب خود میسازید سرویسی با شناسه خودش است: پنل شما سفارش را به آن شناسه میفرستد و مسیر آن را به نخستین تأمینکننده شما میسپارد که بتواند آن را بگیرد.
سه گام
این قالب همان قالبی است که پنلهای SMM بین خودشان به کار میبرند، پس نیازی به برنامهنویسی نیست.
https://smm.guide/api/v2 و کلید. سرویسها را وارد کنید: مسیرهای شما با شناسه، قیمت و محدودیتهایشان وارد میشوند.قالب درخواست
| متد HTTP | POST |
| نشانی API | https://smm.guide/api/v2 |
| بدنه | application/x-www-form-urlencoded، یا JSON با Content-Type: application/json. A multipart/form-data بدنه هم خوانده میشود؛ همان چیزی که PHP وقتی به cURL یک آرایه داده شود ارسال میکند |
| پاسخ | JSON، همیشه با HTTP 200، حتی برای بدنهای که نمیتوانیم بخوانیم یا درخواستی که بیش از حد بزرگ است. خطا به این شکل است: {"error": "…"} |
| پول | دلار آمریکا. قیمتها برای هر ۱٬۰۰۰ عدد |
فهرست سرویسها
مسیرهای شما که همین حالا میتوانند سفارش بگیرند. مسیری که خاموش است یا همه مراحلش از کار افتادهاند، در فهرست نمیآید.
| پارامتر | توضیح |
|---|---|
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 | شناسه مسیر، هشت رقم |
link | لینک صفحه، پست یا پروفایل |
quantity | تعداد موردنیاز |
پاسخ
{
"order": 23501
}
هیچ تأمینکنندهای آن را نپذیرفت
{
"error": "No step of this route accepted the order. …"
}شماره سفارش در تمام طول عمر سفارش ثابت میماند، هر تأمینکنندهای که در نهایت آن را تحویل دهد. مسیر فقط لینک و تعداد را میپذیرد؛ ارسال تدریجی، کامنتها و سایر فیلدهای اضافی رد میشوند.
وضعیت سفارش
| پارامتر | توضیح |
|---|---|
key | کلید API شما |
action | status |
order | شناسه سفارش |
پاسخ
{
"charge": "0.0045",
"start_count": "3572",
"status": "In progress",
"remains": "157",
"currency": "USD"
}| پارامتر | توضیح |
|---|---|
key | کلید API شما |
action | status |
orders | شناسههای سفارش جداشده با کاما، حداکثر 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 | شناسههای سفارش جداشده با کاما، حداکثر 100 |
پاسخ
[
{ "order": 23501, "cancel": 1 },
{ "order": 23502, "cancel": { "error": "The order is already finished" } }
]ریفیل
به تأمینکنندهای فرستاده میشود که سفارش را تحویل داده است. ریفیل با همان شماره سفارش ثبت میشود.
| پارامتر | توضیح |
|---|---|
key | کلید API شما |
action | refill |
order | شناسه سفارش. یا orders: چند شناسه، جداشده با کاما |
پاسخ، یک سفارش
{ "refill": "23501" }
پاسخ، چند سفارش
[
{ "order": 23501, "refill": 23501 },
{ "order": 23502, "refill": { "error": "…" } }
]| پارامتر | توضیح |
|---|---|
key | کلید API شما |
action | refill_status |
refill | شناسه ریفیل. یا refills: چند شناسه، جداشده با کاما |
پاسخ
{ "status": "Completed" }مسیر با سفارش چه میکند
- مراحل به ترتیبی که شما تعیین کردهاید امتحان میشوند، یا اول ارزانترین مرحله فعال. انتخاب این روش در تنظیمات مسیر با شماست.
- یک مرحله کنار گذاشته میشود وقتی پنل آن پاسخ نمیدهد، موجودی یا سقف روزانهاش برای سفارش کافی نیست، تعداد خارج از محدودهای است که میپذیرد، قیمتش از سقفی که تعیین کردهاید بالاتر است، یا با قیمت آن سفارش از سقف روزانه خود مسیر فراتر میرود. این مرحله خودبهخود دوباره فعال میشود.
- یک مرحله از مسیر خارج میشود وقتی سرویس آن از لیست قیمت حذف شود، یا پنل با همان شناسه چیز دیگری بفروشد. مراحل دیگر به کار ادامه میدهند و به شما اطلاع داده میشود.
- رد شدن، سفارش را به مرحله بعد میبرد. وقتی پنل پاسخ میدهد و سفارش را رد میکند، مبلغی کسر نشده است؛ پس مرحله بعد امتحان میشود.
- نبود پاسخ روشن، مسیر را متوقف میکند. تمام شدن مهلت یا پاسخ ناقص مشخص نمیکند که سفارش ثبت شده است یا نه. فرستادن آن به مرحله بعد ممکن است به تحویل و کسر هزینه دوباره منجر شود؛ برای همین مسیر متوقف میشود و شما همان یک سفارش را در حساب خود بررسی میکنید.
- یک سفارش فعال برای هر لینک. تا وقتی سفارشی برای یک لینک در مسیر در حال اجراست، سفارش دوم برای همان لینک رد میشود؛ همان کاری که خود تأمینکنندگان میکنند.
- لغو پیش از تحویل هم میتواند به مرحله بعد برود، اگر این گزینه را روشن کرده باشید. باقیمانده تحویلنشده یک سفارش ناقص فقط وقتی به مرحله بعد میرود که این را خواسته باشید.
خطاها
| خطا | معنی |
|---|---|
Invalid API key | کلید اشتباه است، جایگزین شده یا باطل شده است. |
This key is limited to certain addresses… | درخواست از نشانیای آمده که در فهرست کلید نیست. |
Incorrect request | ناشناخته action. |
Incorrect service 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 شناسه سفارش در یک
statusدرخواست. - کلید فقط یک بار نمایش داده میشود و بهصورت اثر انگشت نگهداری میشود. نه شما و نه ما نمیتوانیم دوباره آن را بخوانیم. با جایگزین کردن کلید، کلید قبلی بلافاصله غیرفعال میشود.
- نشانیهای مجاز. نشانی سرور پنل خود را در حسابتان وارد کنید تا کلید از هیچ جای دیگری کار نکند.
- شناسه مسیر محرمانه نیست و لازم هم نیست باشد. این شناسه فقط همراه با کلید حسابی کار میکند که مالک مسیر است.
- محدودیتهای شما همچنان برقرارند. سقف روزانه هر پنل، سقف روزانه خود مسیر و بزرگترین سفارش مجاز آن، برای سفارشهایی که از طریق API میرسند دقیقاً همانطور اعمال میشوند که برای سفارشهای دستی.
- پول هرگز از smm.guide عبور نمیکند. هر سفارش از موجودی شما در پنلی که آن را میگیرد پرداخت میشود. بازپرداختها و اختلافها میان شما و همان پنل میماند.
بهدنبال خواندن کاتالوگ هستید؟
پنلها، Trust Score آنها و قیمتهای زنده API مخصوص خود را دارند، و برای دستیارها یک سرور MCP هم هست.