Orders API

smm.guide خپل پینل ته د برابروونکي په توګه ور زیات کړئ. هر مسیر چې تاسو په خپل حساب کې جوړوئ، د خپل ID سره یو خدمت دی: ستاسو پینل هغه ID ته فرمایش لېږي، او مسیر یې ستاسو د برابروونکو له منځه لومړي هغه ته لېږي چې اخیستی یې شي.

درې ګامونه

بڼه هماغه ده چې SMM پینلونه یې لا دمخه په خپل منځ کې کاروي، نو د پروګرام لیکلو ته اړتیا نشته.

1مسیر جوړ کړئحساب، Orders desk، مسیرونه. وټاکئ چې څه وړاندې کوي او له هغو پینلونو چې وصل کړي مو دي، د همدې ډول تر پنځو پورې خدمتونه ور زیات کړئ.
2کیلي جوړه کړئOrders desk، Orders API. کیلي یو ځل ښودل کېږي. تاسو یې ستاسو د پینل د سرور پتې ته محدودولی شئ.
3په خپل پینل کې برابروونکی ور زیات کړئ:API URL https://smm.guide/api/v2 او کیلي. خدمتونه وارد کړئ: ستاسو مسیرونه د خپلو ID، بیو او حدونو سره راځي.

د غوښتنې بڼه

HTTP میتودPOST
API URLhttps://smm.guide/api/v2
بدنه (body)application/x-www-form-urlencoded، یا JSON د دې سره: Content-Type: application/json. A multipart/form-data بدنه هم لوستل کېږي، چې PHP یې هغه وخت لېږي کله چې cURL ته array ورکړل شي
ځواب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د مسیر 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د فرمایشونو ID ګانې، په کامه جلا، تر 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د فرمایشونو ID ګانې، په کامه جلا، تر 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 غوښتنې ته تل په ۳۰ ثانیو کې ځواب ورکول کېږي. یو مسیر کېدای شي یو په بل پسې څو برابروونکي وپوښتي؛ هر یو د هغه وخت پاتې برخه ترلاسه کوي، او هغه برابروونکی چې انتظار یې نشي ایستل کېدی، هېڅ نه پوښتل کېږي. که وروستی پوښتل شوی برابروونکی د وخت تر پای ته رسېدو ځواب ورنکړي، تاسو د Pending حالت سره د فرمایش شمېره ترلاسه کوئ، او مسیر هلته دریږي تر هغه چې ځواب معلوم شي. ډېری فرمایشونو ته په یوه یا دوو ثانیو کې ځواب ورکول کېږي.

حدونه او امنیت

  • د هرې کیلي لپاره په دقیقه کې 300 غوښتنې، چې 120 یې فرمایشونه دي. تر 100 پورې د فرمایشونو IDs په یوه کې status غوښتنه.
  • کیلي یو ځل ښودل کېږي او د ګوتې نښې په توګه ساتل کېږي. نه تاسو او نه موږ یې بیا لوستلی شو. بدلول یې زړه کیلي سمدستي غیرفعالوي.
  • اجازه لرونکې پتې. په خپل حساب کې د خپل پینل د سرور پته ولیکئ او کیلي به له بل هېڅ ځایه کار ونه کړي.
  • د مسیر ID راز نه دی او اړتیا هم نشته چې وي. یوازې د هغه حساب د کیلي سره کار کوي چې مسیر یې دی.
  • ستاسو حدونه لا هم پلي کېږي. د هر پینل ورځنی حد، د مسیر خپل ورځنی حد او تر ټولو لوی فرمایش یې په هغو فرمایشونو چې د API له لارې راځي هماغسې پلي کېږي لکه په هغو چې تاسو یې په لاس ورکوئ.
  • پیسې هېڅکله د smm.guide له لارې نه تېرېږي. هر فرمایش په هغه پینل کې ستاسو له بیلانس څخه ورکول کېږي چې اخلي یې. بېرته ورکړې او شخړې ستاسو او د هغه پینل ترمنځ پاتې کېږي.

پر ځای یې کتلاګ لولئ؟

پینلونه، Trust Score او ژوندۍ بیې خپل API لري، او د مرستیالانو لپاره MCP سرور.