Orders API

smm.guide را به‌عنوان تأمین‌کننده به پنل خود اضافه کنید. هر مسیری که در حساب خود می‌سازید سرویسی با شناسه خودش است: پنل شما سفارش را به آن شناسه می‌فرستد و مسیر آن را به نخستین تأمین‌کننده شما می‌سپارد که بتواند آن را بگیرد.

سه گام

این قالب همان قالبی است که پنل‌های SMM بین خودشان به کار می‌برند، پس نیازی به برنامه‌نویسی نیست.

1یک مسیر بسازیدحساب، Orders desk، مسیرها. انتخاب کنید مسیر چه چیزی تحویل می‌دهد و تا پنج سرویس از همان نوع را از پنل‌های متصل خود اضافه کنید.
2کلید را بسازیدOrders desk، Orders API. کلید فقط یک بار نمایش داده می‌شود. می‌توانید آن را به نشانی سرور پنل خود محدود کنید.
3یک تأمین‌کننده در پنل خود اضافه کنیدنشانی API https://smm.guide/api/v2 و کلید. سرویس‌ها را وارد کنید: مسیرهای شما با شناسه، قیمت و محدودیت‌هایشان وارد می‌شوند.

قالب درخواست

متد HTTPPOST
نشانی APIhttps://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 شما
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شناسه مسیر، هشت رقم
linkلینک صفحه، پست یا پروفایل
quantityتعداد موردنیاز

پاسخ

{
  "order": 23501
}

هیچ تأمین‌کننده‌ای آن را نپذیرفت

{
  "error": "No step of this route accepted the order. …"
}

شماره سفارش در تمام طول عمر سفارش ثابت می‌ماند، هر تأمین‌کننده‌ای که در نهایت آن را تحویل دهد. مسیر فقط لینک و تعداد را می‌پذیرد؛ ارسال تدریجی، کامنت‌ها و سایر فیلدهای اضافی رد می‌شوند.

وضعیت سفارش

پارامترتوضیح
keyکلید API شما
actionstatus
orderشناسه سفارش

پاسخ

{
  "charge": "0.0045",
  "start_count": "3572",
  "status": "In progress",
  "remains": "157",
  "currency": "USD"
}
پارامترتوضیح
keyکلید API شما
actionstatus
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 شما
actionbalance

پاسخ

{
  "balance": "126.1375",
  "currency": "USD"
}

لغو

به تأمین‌کننده‌ای فرستاده می‌شود که اکنون سفارش در دست اوست، اگر سرویس آن امکان لغو داشته باشد. سفارشی که لغو می‌کنید هرگز به مرحله بعد فرستاده نمی‌شود.

پارامترتوضیح
keyکلید API شما
actioncancel
ordersشناسه‌های سفارش جداشده با کاما، حداکثر 100

پاسخ

[
  { "order": 23501, "cancel": 1 },
  { "order": 23502, "cancel": { "error": "The order is already finished" } }
]

ریفیل

به تأمین‌کننده‌ای فرستاده می‌شود که سفارش را تحویل داده است. ریفیل با همان شماره سفارش ثبت می‌شود.

پارامترتوضیح
keyکلید API شما
actionrefill
orderشناسه سفارش. یا orders: چند شناسه، جداشده با کاما

پاسخ، یک سفارش

{ "refill": "23501" }

پاسخ، چند سفارش

[
  { "order": 23501, "refill": 23501 },
  { "order": 23502, "refill": { "error": "…" } }
]
پارامترتوضیح
keyکلید API شما
actionrefill_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 هم هست.