হোম / ডেভেলপারদের জন্য / 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 ডলার। দাম প্রতি ১,০০০-এর জন্য |
সার্ভিস তালিকা
আপনার যে রুটগুলো এই মুহূর্তে অর্ডার নিতে পারে। বন্ধ করা রুট, বা যার প্রতিটি ধাপ বাদ পড়েছে, তালিকায় থাকে না।
| প্যারামিটার | বিবরণ |
|---|---|
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টি অর্ডার আইডি
statusকল। - কী একবারই দেখানো হয় এবং ফিঙ্গারপ্রিন্ট হিসেবে রাখা হয়। আপনি বা আমরা কেউই এটি আর পড়তে পারি না। বদলালে পুরোনোটি সঙ্গে সঙ্গে বন্ধ হয়ে যায়।
- অনুমোদিত ঠিকানা। অ্যাকাউন্টে আপনার প্যানেলের সার্ভারের ঠিকানা তালিকায় দিন, তাহলে কী অন্য কোথাও থেকে কাজ করবে না।
- রুট ID কোনো গোপন তথ্য নয়, আর তা হওয়ার দরকারও নেই। এটি শুধু রুটের মালিক অ্যাকাউন্টের কীর সঙ্গেই কাজ করে।
- আপনার সীমাগুলো বহাল থাকে। প্রতিটি প্যানেলের দৈনিক সীমা, রুটের নিজস্ব দৈনিক সীমা ও সবচেয়ে বড় অর্ডারের সীমা API দিয়ে আসা অর্ডারে ঠিক সেভাবেই খাটে, যেভাবে হাতে দেওয়া অর্ডারে খাটে।
- টাকা কখনও smm.guide-এর মধ্য দিয়ে যায় না। প্রতিটি অর্ডারের পেমেন্ট হয় যে প্যানেল সেটি নেয় সেখানে আপনার ব্যালেন্স থেকে। রিফান্ড ও বিরোধ আপনার ও সেই প্যানেলের মধ্যেই থাকে।
এর বদলে ক্যাটালগ পড়তে চান?
প্যানেল, Trust Score ও লাইভ দামের নিজস্ব API আছে, আর অ্যাসিস্ট্যান্টের জন্য একটি MCP সার্ভারও।