SMM প্যানেল API ডকুমেন্টেশন
স্ট্যান্ডার্ড SMM প্যানেল API v2 দিয়ে আপনার টেলিগ্রাম বট বা নিজের প্যানেল থেকে 4SNS PLUS এর সার্ভিস অর্ডার করুন।
SMM প্যানেল API কী?
SMM প্যানেল API দিয়ে একটি প্রোগ্রাম ওয়েবসাইটে না গিয়েই সার্ভিস লিস্ট নিতে, অর্ডার দিতে এবং অর্ডার স্ট্যাটাস ও ব্যালেন্স দেখতে পারে। 4SNS PLUS অনেক প্যানেল ও বটে ব্যবহৃত স্ট্যান্ডার্ড SMM প্যানেল API v2 ফরম্যাট সাপোর্ট করে, তাই অন্য প্যানেলের সাথে যুক্ত আপনার কোড শুধু URL ও key বদলালেই সাথে সাথে কাজ করে।
API এর দাম ও ব্যালেন্স ওয়েবসাইটের মতোই। services রেসপন্সের rate প্রাইস লিস্টের প্রতি 1,000 এর দামের (US ডলার) সমান, এবং add দিয়ে দেওয়া অর্ডার ওয়েব অর্ডারের মতোই ব্যালেন্স থেকে কাটা হয় এবং ড্যাশবোর্ডের অর্ডার হিস্ট্রিতেও দেখা যায়। ক্যানসেল বা আংশিক অর্ডারের ফেরত টাকা একই ব্যালেন্সে ফিরে আসে।
মূল তথ্য
| এন্ডপয়েন্ট | https://4snsplus.com/api/v2 |
| মেথড | POST |
| রিকোয়েস্ট ফরম্যাট | ফর্ম ফিল্ড (application/x-www-form-urlencoded, multipart) অথবা JSON বডি |
| রেসপন্স | JSON; এররও HTTP 200 সহ error ফিল্ডে আসে |
| অথেন্টিকেশন | প্রতিটি রিকোয়েস্টে key প্যারামিটার (আপনার API key) |
| রেট লিমিট | প্রতি key তে প্রতি মিনিটে 300টি রিকোয়েস্ট |
| মুদ্রা | US ডলার (USD) |
রিকোয়েস্টের উদাহরণ
curl -X POST https://4snsplus.com/api/v2 \ -d key=YOUR_API_KEY \ -d action=balance
import requests
r = requests.post("https://4snsplus.com/api/v2", data={
"key": "YOUR_API_KEY",
"action": "add",
"service": 2210,
"link": "https://t.me/yourchannel",
"quantity": 1000,
})
print(r.json()) # {"order": 31877} or {"error": "..."}API key কীভাবে পাবেন?
আপনার প্রথম টপ আপ ব্যালেন্সে যোগ হলেই ড্যাশবোর্ডের API key মেনু থেকে API key তৈরি করতে পারবেন। key তৈরির সময় শুধু একবার দেখানো হয়, তাই এটি নিরাপদ জায়গায় সেভ করুন। নতুন key তৈরি করলে আগের key সাথে সাথে বন্ধ হয়ে যায়।
key আপনার অ্যাকাউন্ট টোকেন থেকে আলাদা। আপনার বট বা সার্ভারে শুধু API key রাখুন, অ্যাকাউন্ট টোকেন কখনো নয়। key অন্য কারও হাতে গেছে মনে হলে API key স্ক্রিনে শুধু একটি নতুন key তৈরি করুন।
সার্ভিস লিস্ট (services)
অর্ডার করা যায় এমন সব সার্ভিস ফেরত দেয়। rate হলো প্রতি 1,000 এর দাম (USD), আর type Package হলে এটি একটি প্যাকেজের দাম। type Custom Comments হলে পরিমাণের বদলে কমেন্টের লিস্ট পাঠাবেন। category হলো প্ল্যাটফর্মের নাম ও গ্রুপের নাম।
| প্যারামিটার | বিবরণ |
|---|---|
| key | আপনার API key |
| action | services |
রেসপন্সের উদাহরণ
[
{
"service": 2210,
"name": "Members - 30 Days Non Drop - 30 Days Refill",
"type": "Default",
"category": "Telegram - Members (30 Days Non Drop)",
"rate": "1.4300",
"min": "100",
"max": "50000",
"refill": true,
"cancel": false
}
]অর্ডার দেওয়া (add)
অর্ডার দেয় এবং আপনার ব্যালেন্স থেকে টাকা কাটে। টাকার পরিমাণ হলো প্রতি 1,000 এর দাম গুণ পরিমাণ; Package এ এটি প্যাকেজের দাম, আর Custom Comments এ কমেন্ট লাইনের সংখ্যাই পরিমাণ। যেসব অ্যাকাউন্টে প্রথম টপ আপ যোগ হয়েছে সেগুলোতে অর্ডার করা যায়। রেসপন্সের order হলো আপনার অর্ডার ID।
| প্যারামিটার | বিবরণ |
|---|---|
| key | আপনার API key |
| action | add |
| service | সার্ভিস ID (services এর service) |
| link | পাবলিক লিংক। টেলিগ্রামের জন্য: t.me/name, প্রাইভেট ইনভাইট লিংক t.me/+code, পোস্ট t.me/name/123, বট t.me/botname। @name ও চলে |
| quantity | পরিমাণ (min ও max এর মধ্যে)। Package ও Custom Comments এর জন্য লাগে না |
| comments | শুধু Custom Comments এর জন্য। প্রতি লাইনে একটি কমেন্ট, সর্বোচ্চ 10,000 লাইন, প্রতি লাইনে সর্বোচ্চ 500 অক্ষর |
রেসপন্সের উদাহরণ
{
"order": 31877
}অর্ডার স্ট্যাটাস (status)
একটি অর্ডারের স্ট্যাটাস। charge হলো রিফান্ডের পর আসলে পরিশোধিত টাকা (USD, 6 দশমিক), start_count হলো অর্ডার শুরুর সময়ের সংখ্যা, আর remains হলো এখনো ডেলিভারি না হওয়া পরিমাণ।
| প্যারামিটার | বিবরণ |
|---|---|
| key | আপনার API key |
| action | status |
| order | অর্ডার ID |
রেসপন্সের উদাহরণ
{
"charge": "1.430000",
"start_count": "8120",
"status": "In progress",
"remains": "410",
"currency": "USD"
}একাধিক অর্ডারের স্ট্যাটাস (status, orders)
কমা দিয়ে যুক্ত অর্ডার ID সহ একবারে সর্বোচ্চ 100টি অর্ডার দেখে। যে ID নেই বা আপনার অ্যাকাউন্টে নেই, সেগুলোর জায়গায় error আসে।
| প্যারামিটার | বিবরণ |
|---|---|
| key | আপনার API key |
| action | status |
| orders | অর্ডার ID এর লিস্ট, যেমন 1,10,100 |
রেসপন্সের উদাহরণ
{
"1": { "charge": "0.300000", "start_count": "120", "status": "Completed", "remains": "0", "currency": "USD" },
"10": { "error": "Incorrect order ID" }
}রিফিল রিকোয়েস্ট (refill)
রিফিল সময়সহ কোনো সার্ভিসের অর্ডার Completed বা Partial হয়ে শেষ হলে, শেষ হওয়ার সময় থেকে গোনা রিফিল সময়ের মধ্যে রিকোয়েস্ট করুন। প্রতি অর্ডারে একটি খোলা রিকোয়েস্ট থাকতে পারে, আর রিকোয়েস্টের মাঝে 24 ঘণ্টার ব্যবধান লাগে।
| প্যারামিটার | বিবরণ |
|---|---|
| key | আপনার API key |
| action | refill |
| order | অর্ডার ID |
রেসপন্সের উদাহরণ
{
"refill": 512
}রিফিল স্ট্যাটাস (refill_status)
একটি রিফিল রিকোয়েস্টের স্ট্যাটাস।
| প্যারামিটার | বিবরণ |
|---|---|
| key | আপনার API key |
| action | refill_status |
| refill | রিফিল ID (refill রেসপন্সের refill) |
রেসপন্সের উদাহরণ
{
"status": "Completed"
}ব্যালেন্স (balance)
আপনার ব্যালেন্স (USD, 6 দশমিক)।
| প্যারামিটার | বিবরণ |
|---|---|
| key | আপনার API key |
| action | balance |
রেসপন্সের উদাহরণ
{
"balance": "84.120000",
"currency": "USD"
}অর্ডার স্ট্যাটাসের মান
| Pending | গ্রহণ করা হয়েছে। পাঠানো হচ্ছে, শুরুর অপেক্ষায় আছে, অথবা অপারেটর হস্তান্তরের ফল যাচাই করছেন |
| In progress | ডেলিভারি চলছে |
| Completed | পুরোপুরি ডেলিভারি হয়েছে |
| Partial | আংশিক ডেলিভারি। বাকি অংশের টাকা আপনার ব্যালেন্সে রিফান্ড হয় |
| Canceled | ডেলিভারি হয়নি। পুরো টাকা আপনার ব্যালেন্সে রিফান্ড |
রিফিল স্ট্যাটাসের মান
| Pending | রিফিল রিকোয়েস্ট গ্রহণ করা হয়েছে |
| In progress | রিফিল ডেলিভারি চলছে |
| Completed | রিফিল ডেলিভারি হয়েছে |
| Rejected | রিফিল রিকোয়েস্ট গ্রহণ করা হয়নি |
এরর মেসেজ
এরর HTTP 200 রেসপন্সে error ফিল্ডসহ JSON হিসেবে আসে। আপনার কোডে সবার আগে error ফিল্ড দেখুন।
{
"error": "Not enough funds on balance"
}| Invalid API key | key নেই, ভুল, অথবা নতুন key দিয়ে বদলানো হয়েছে |
| Too many requests | প্রতি মিনিটে 300টির বেশি রিকোয়েস্ট। একটু পরে আবার চেষ্টা করুন |
| Incorrect action | action এর মান উপরের লিস্টে নেই |
| Add funds first | এমন অ্যাকাউন্ট থেকে অর্ডার যার প্রথম টপ আপ এখনো যোগ হয়নি |
| Incorrect service ID | এই ID তে অর্ডারযোগ্য কোনো সার্ভিস নেই |
| Incorrect link | লিংক খালি বা ওয়েব ঠিকানা নয় |
| Quantity out of range | পরিমাণ সর্বনিম্নের কম বা সর্বোচ্চের বেশি |
| Incorrect comments | Custom Comments খালি, অথবা 10,000 লাইন বা প্রতি লাইনে 500 অক্ষরের বেশি |
| Not enough funds on balance | ব্যালেন্স অর্ডারের টাকার চেয়ে কম। টপ আপ করে আবার অর্ডার করুন |
| Incorrect order ID | এই অর্ডার ID আপনার অ্যাকাউন্টে নেই |
| Refill is not available for this service | সার্ভিসটির রিফিল সময় নেই |
| Order is not finished yet | অর্ডার Completed বা Partial হলে রিফিল করা যায় |
| Refill period has ended | অর্ডার শেষ হওয়ার সময় থেকে গোনা রিফিল সময় পার হয়ে গেছে |
| Refill already requested | এই অর্ডারে আগে থেকেই একটি খোলা রিফিল রিকোয়েস্ট আছে |
| Refill already requested, try again later | শেষ রিকোয়েস্টের পর 24 ঘণ্টা পার হয়নি |
| Incorrect refill ID | এই রিফিল ID আপনার অ্যাকাউন্টে নেই |
SMM প্যানেল API কীভাবে টেলিগ্রাম বটের সাথে যুক্ত করবেন?
1. সার্ভিস লিস্ট সেভ করুন
দিনে কয়েকবার services কল করুন এবং সার্ভিস ID, নাম, rate, min ও max নিজের ডেটায় সেভ করুন। গ্রাহককে দেখানোর দাম rate এর সাথে আপনার মার্জিন যোগ করে হিসাব করুন, আর অর্ডারের সময় সেভ করা সার্ভিস ID হুবহু ব্যবহার করুন।
2. অর্ডারের আগে পরিমাণ ও লিংক যাচাই করুন
আগেই যাচাই করুন যে পরিমাণ min ও max এর মধ্যে আছে এবং লিংক t.me ফরম্যাটে আছে, এতে Quantity out of range ও Incorrect link এরর কমে যায়। balance দিয়ে আগে থেকে ব্যালেন্স দেখে নেওয়াও কাজে দেয়।
3. স্ট্যাটাস ব্যাচে দেখুন
চলমান অর্ডারগুলো কয়েক মিনিট পরপর orders প্যারামিটার দিয়ে 100টির ব্যাচে দেখুন। এতে প্রতি key তে প্রতি মিনিটে 300 রিকোয়েস্টের সীমার মধ্যে স্বচ্ছন্দে থাকা যায়। অর্ডার Completed, Partial বা Canceled হলে গ্রাহককে ফল জানিয়ে দিন।
4. শুধু শেষ হওয়া অর্ডারে রিফিল
রিফিল সার্ভিসের অর্ডার Completed বা Partial হলে refill পাঠাতে পারেন। রেসপন্স থেকে রিফিল ID সেভ করুন এবং refill_status দিয়ে অগ্রগতি দেখুন।
