මුල් පිටුව / සංවර්ධකයන් / Orders API
Orders API
smm.guide ඔබේ පැනලයට සැපයුම්කරුවෙකු ලෙස එක් කරන්න. ඔබ ඔබේ ගිණුමේ ගොඩනඟන සෑම මාර්ගයක්ම තමන්ගේම ID සහිත සේවාවකි: ඔබේ පැනලය එම ID වෙත ඇණවුමක් යවන අතර, මාර්ගය එය භාර ගත හැකි ඔබේ සැපයුම්කරුවන්ගෙන් පළමු එකට යොමු කරයි.
පියවර තුනක්
ආකෘතිය SMM පැනල දැනටමත් තමන් අතර භාවිත කරන එකම බැවින්, ක්රමලේඛනය කිරීමට කිසිවක් නැත.
https://smm.guide/api/v2 සහ යතුර. සේවා ආයාත කරන්න: ඔබේ මාර්ග ඒවායේ ID, මිල සහ සීමා සමඟ පැමිණේ.ඉල්ලීම් ආකෘතිය
| HTTP ක්රමය | POST |
| API URL | https://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 යතුර |
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 ඉල්ලීමකටම තත්පර 30ක් ඇතුළත සැමවිටම පිළිතුරු ලැබේ. මාර්ගයකට සැපයුම්කරුවන් කිහිප දෙනෙකුගෙන් එකින් එක විමසිය හැකිය; සෑම කෙනෙකුටම එම කාලයෙන් ඉතිරි වූ කොටස ලැබෙන අතර, රැඳී සිටිය නොහැකි සැපයුම්කරුවෙකුගෙන් කිසිසේත් විමසනු නොලැබේ. කාලය අවසන් වන විට අවසන් වරට විමසූ සැපයුම්කරු පිළිතුරු දී නොමැති නම්, ඔබට Pending තත්ත්වය සහිත ඇණවුම් අංකයක් ලැබෙන අතර, පිළිතුර දැනගන්නා තුරු මාර්ගය එතැනින් නතර වේ. බොහෝ ඇණවුම්වලට තත්පර එකකින් හෝ දෙකකින් පිළිතුරු ලැබේ.
සීමා සහ ආරක්ෂාව
- එක් යතුරකට මිනිත්තුවකට ඉල්ලීම් 300, ඉන් ඇණවුම් 120. එකකට ඇණවුම් ID 100 ක් දක්වා
statusඇමතුම. - යතුර පෙන්වන්නේ එක් වරක් පමණක් වන අතර ඇඟිලි සලකුණක් ලෙස තබා ගැනේ. ඔබට හෝ අපට එය නැවත කියවිය නොහැක. එය ප්රතිස්ථාපනය කිරීමෙන් පැරණි යතුර වහාම අක්රිය වේ.
- අවසර ලත් ලිපින. ඔබේ ගිණුමේ ඔබේ පැනල සේවාදායකයේ ලිපිනය ලැයිස්තුගත කරන්න; එවිට යතුර වෙන කිසිම තැනක සිට ක්රියා නොකරයි.
- මාර්ග ID එකක් රහසක් නොවන අතර එය එසේ වීමට අවශ්ය ද නැත. එය ක්රියා කරන්නේ මාර්ගය හිමි ගිණුමේ යතුර සමඟ පමණි.
- ඔබේ සීමා තවමත් බලපවත්වයි. එක් එක් පැනලයේ දෛනික සීමාව, මාර්ගයේම දෛනික සීමාව සහ එහි විශාලතම ඇණවුම, API හරහා පැමිණෙන ඇණවුම්වලට ද ඔබ අතින් කරන ඇණවුම්වලට මෙන්ම අදාළ වේ.
- මුදල් කිසි විටෙක smm.guide හරහා ගමන් නොකරයි. සෑම ඇණවුමක්ම ගෙවනු ලබන්නේ එය භාර ගන්නා පැනලයේ ඇති ඔබේ ශේෂයෙනි. මුදල් ආපසු ගෙවීම් සහ ආරවුල් ඔබ සහ එම පැනලය අතර පවතී.
ඒ වෙනුවට නාමාවලිය කියවනවාද?
පැනල, Trust Score ලකුණු සහ සජීවී මිල ගණන් සඳහා තමන්ගේම API එකක් සහ සහායකයන් සඳහා MCP සේවාදායකයක් ඇත.