முகப்பு / டெவலப்பர்களுக்கு / 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 body-யும் படிக்கப்படும்; cURL-க்கு array கொடுக்கும்போது PHP அனுப்புவது இதுதான் |
| பதில் | JSON, எப்போதும் HTTP 200 உடன்; படிக்க முடியாத body அல்லது மிகப் பெரிய கோரிக்கைக்கும் கூட. பிழை இந்த வடிவில் இருக்கும்: {"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 ஆர்டர்கள். ஒன்றில் அதிகபட்சம் 100 ஆர்டர் ID-கள்
statusஅழைப்புக்கு. - விசை ஒருமுறை மட்டுமே காட்டப்பட்டு, கைரேகையாக வைக்கப்படுகிறது. உங்களாலும் எங்களாலும் அதை மீண்டும் படிக்க முடியாது. அதை மாற்றினால் பழையது உடனே முடக்கப்படும்.
- அனுமதிக்கப்பட்ட முகவரிகள். உங்கள் பேனல் சர்வரின் முகவரியை உங்கள் கணக்கில் பட்டியலிட்டால், விசை வேறு எங்கிருந்தும் செயல்படாது.
- வழித்தட ID ரகசியம் அல்ல, ரகசியமாக இருக்கவும் தேவையில்லை. வழித்தடத்தை வைத்திருக்கும் கணக்கின் விசையுடன் சேர்ந்து மட்டுமே அது செயல்படும்.
- உங்கள் வரம்புகள் இன்னும் பொருந்தும். ஒவ்வொரு பேனலின் தினசரி வரம்பு, வழித்தடத்தின் சொந்தத் தினசரி வரம்பு, அதன் அதிகபட்ச ஆர்டர் ஆகியவை, நீங்கள் கையால் செய்யும் ஆர்டர்களுக்குப் போலவே API மூலம் வரும் ஆர்டர்களுக்கும் பொருந்தும்.
- பணம் ஒருபோதும் smm.guide வழியாகச் செல்வதில்லை. ஒவ்வொரு ஆர்டருக்கும், அதை ஏற்கும் பேனலில் உள்ள உங்கள் இருப்பிலிருந்து கட்டணம் செலுத்தப்படும். பணம் திருப்புதலும் சர்ச்சைகளும் உங்களுக்கும் அந்தப் பேனலுக்கும் இடையே மட்டுமே.
பதிலாகப் பட்டியலைப் படிக்க வேண்டுமா?
பேனல்கள், Trust Score-கள், நேரடி விலைகள் ஆகியவற்றுக்குத் தனி API-உம், உதவியாளர்களுக்கான MCP சர்வரும் உள்ளன.