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
අන්තර්ගතයapplication/x-www-form-urlencoded, නැතහොත් JSON, මෙම ශීර්ෂය සමඟ: Content-Type: application/json. A multipart/form-data අන්තර්ගතය ද කියවනු ලැබේ; cURL වෙත array එකක් දුන් විට PHP යවන්නේ එයයි
පිළිතුරJSON, සැමවිටම HTTP 200 සමඟ, අපට කියවිය නොහැකි අන්තර්ගතයක් හෝ ඉතා විශාල ඉල්ලීමක් සඳහා ද. දෝෂයක ආකෘතිය: {"error": "…"}
මුදල්එක්සත් ජනපද ඩොලර්. මිල ගණන් 1,000කට

සේවා ලැයිස්තුව

මේ මොහොතේ ඇණවුමක් භාර ගත හැකි ඔබේ මාර්ග. අක්‍රිය කළ, හෝ සෑම පියවරක්ම ඉවත් වී ඇති මාර්ගයක් ලැයිස්තුගත නොවේ.

පරාමිතියවිස්තරය
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 ඉල්ලීමකටම තත්පර 30ක් ඇතුළත සැමවිටම පිළිතුරු ලැබේ. මාර්ගයකට සැපයුම්කරුවන් කිහිප දෙනෙකුගෙන් එකින් එක විමසිය හැකිය; සෑම කෙනෙකුටම එම කාලයෙන් ඉතිරි වූ කොටස ලැබෙන අතර, රැඳී සිටිය නොහැකි සැපයුම්කරුවෙකුගෙන් කිසිසේත් විමසනු නොලැබේ. කාලය අවසන් වන විට අවසන් වරට විමසූ සැපයුම්කරු පිළිතුරු දී නොමැති නම්, ඔබට Pending තත්ත්වය සහිත ඇණවුම් අංකයක් ලැබෙන අතර, පිළිතුර දැනගන්නා තුරු මාර්ගය එතැනින් නතර වේ. බොහෝ ඇණවුම්වලට තත්පර එකකින් හෝ දෙකකින් පිළිතුරු ලැබේ.

සීමා සහ ආරක්ෂාව

  • එක් යතුරකට මිනිත්තුවකට ඉල්ලීම් 300, ඉන් ඇණවුම් 120. එකකට ඇණවුම් ID 100 ක් දක්වා status ඇමතුම.
  • යතුර පෙන්වන්නේ එක් වරක් පමණක් වන අතර ඇඟිලි සලකුණක් ලෙස තබා ගැනේ. ඔබට හෝ අපට එය නැවත කියවිය නොහැක. එය ප්‍රතිස්ථාපනය කිරීමෙන් පැරණි යතුර වහාම අක්‍රිය වේ.
  • අවසර ලත් ලිපින. ඔබේ ගිණුමේ ඔබේ පැනල සේවාදායකයේ ලිපිනය ලැයිස්තුගත කරන්න; එවිට යතුර වෙන කිසිම තැනක සිට ක්‍රියා නොකරයි.
  • මාර්ග ID එකක් රහසක් නොවන අතර එය එසේ වීමට අවශ්‍ය ද නැත. එය ක්‍රියා කරන්නේ මාර්ගය හිමි ගිණුමේ යතුර සමඟ පමණි.
  • ඔබේ සීමා තවමත් බලපවත්වයි. එක් එක් පැනලයේ දෛනික සීමාව, මාර්ගයේම දෛනික සීමාව සහ එහි විශාලතම ඇණවුම, API හරහා පැමිණෙන ඇණවුම්වලට ද ඔබ අතින් කරන ඇණවුම්වලට මෙන්ම අදාළ වේ.
  • මුදල් කිසි විටෙක smm.guide හරහා ගමන් නොකරයි. සෑම ඇණවුමක්ම ගෙවනු ලබන්නේ එය භාර ගන්නා පැනලයේ ඇති ඔබේ ශේෂයෙනි. මුදල් ආපසු ගෙවීම් සහ ආරවුල් ඔබ සහ එම පැනලය අතර පවතී.

ඒ වෙනුවට නාමාවලිය කියවනවාද?

පැනල, Trust Score ලකුණු සහ සජීවී මිල ගණන් සඳහා තමන්ගේම API එකක් සහ සහායකයන් සඳහා MCP සේවාදායකයක් ඇත.