मुख्यपृष्ठ / डेव्हलपर्ससाठी / 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 ला ॲरे दिल्यावर PHP पाठवते |
| उत्तर | JSON, नेहमी HTTP 200 सह, आम्ही वाचू शकत नाही अशी बॉडी किंवा खूप मोठी विनंती असली तरीही. त्रुटी अशी असते: {"error": "…"} |
| पैसे | US डॉलर. किमती प्रति 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 सर्व्हरही.