کور / پراختیاکوونکي / Orders API
Orders API
smm.guide خپل پینل ته د برابروونکي په توګه ور زیات کړئ. هر مسیر چې تاسو په خپل حساب کې جوړوئ، د خپل ID سره یو خدمت دی: ستاسو پینل هغه ID ته فرمایش لېږي، او مسیر یې ستاسو د برابروونکو له منځه لومړي هغه ته لېږي چې اخیستی یې شي.
درې ګامونه
بڼه هماغه ده چې SMM پینلونه یې لا دمخه په خپل منځ کې کاروي، نو د پروګرام لیکلو ته اړتیا نشته.
https://smm.guide/api/v2 او کیلي. خدمتونه وارد کړئ: ستاسو مسیرونه د خپلو ID، بیو او حدونو سره راځي.د غوښتنې بڼه
| HTTP میتود | POST |
| API URL | https://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 کیلي |
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 | د فرمایشونو 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 کیلي |
action | balance |
ځواب
{
"balance": "126.1375",
"currency": "USD"
}لغوه کړئ
هغه برابروونکي ته لېږل کېږي چې اوس فرمایش لري، که د هغه خدمت لغوه کول وړاندې کوي. هغه فرمایش چې تاسو یې لغوه کوئ، هېڅکله بل ګام ته نه لېږل کېږي.
| پارامتر | تشریح |
|---|---|
key | ستاسو API کیلي |
action | cancel |
orders | د فرمایشونو ID ګانې، په کامه جلا، تر 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 غوښتنې ته تل په ۳۰ ثانیو کې ځواب ورکول کېږي. یو مسیر کېدای شي یو په بل پسې څو برابروونکي وپوښتي؛ هر یو د هغه وخت پاتې برخه ترلاسه کوي، او هغه برابروونکی چې انتظار یې نشي ایستل کېدی، هېڅ نه پوښتل کېږي. که وروستی پوښتل شوی برابروونکی د وخت تر پای ته رسېدو ځواب ورنکړي، تاسو د Pending حالت سره د فرمایش شمېره ترلاسه کوئ، او مسیر هلته دریږي تر هغه چې ځواب معلوم شي. ډېری فرمایشونو ته په یوه یا دوو ثانیو کې ځواب ورکول کېږي.
حدونه او امنیت
- د هرې کیلي لپاره په دقیقه کې 300 غوښتنې، چې 120 یې فرمایشونه دي. تر 100 پورې د فرمایشونو IDs په یوه کې
statusغوښتنه. - کیلي یو ځل ښودل کېږي او د ګوتې نښې په توګه ساتل کېږي. نه تاسو او نه موږ یې بیا لوستلی شو. بدلول یې زړه کیلي سمدستي غیرفعالوي.
- اجازه لرونکې پتې. په خپل حساب کې د خپل پینل د سرور پته ولیکئ او کیلي به له بل هېڅ ځایه کار ونه کړي.
- د مسیر ID راز نه دی او اړتیا هم نشته چې وي. یوازې د هغه حساب د کیلي سره کار کوي چې مسیر یې دی.
- ستاسو حدونه لا هم پلي کېږي. د هر پینل ورځنی حد، د مسیر خپل ورځنی حد او تر ټولو لوی فرمایش یې په هغو فرمایشونو چې د API له لارې راځي هماغسې پلي کېږي لکه په هغو چې تاسو یې په لاس ورکوئ.
- پیسې هېڅکله د smm.guide له لارې نه تېرېږي. هر فرمایش په هغه پینل کې ستاسو له بیلانس څخه ورکول کېږي چې اخلي یې. بېرته ورکړې او شخړې ستاسو او د هغه پینل ترمنځ پاتې کېږي.
پر ځای یې کتلاګ لولئ؟
پینلونه، Trust Score او ژوندۍ بیې خپل API لري، او د مرستیالانو لپاره MCP سرور.