মূল কনটেন্টে যান
4SNS PLUS

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
actionservices

রেসপন্সের উদাহরণ

[
  {
    "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
actionadd
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
actionstatus
orderঅর্ডার ID

রেসপন্সের উদাহরণ

{
  "charge": "1.430000",
  "start_count": "8120",
  "status": "In progress",
  "remains": "410",
  "currency": "USD"
}

একাধিক অর্ডারের স্ট্যাটাস (status, orders)

কমা দিয়ে যুক্ত অর্ডার ID সহ একবারে সর্বোচ্চ 100টি অর্ডার দেখে। যে ID নেই বা আপনার অ্যাকাউন্টে নেই, সেগুলোর জায়গায় error আসে।

প্যারামিটারবিবরণ
keyআপনার API key
actionstatus
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
actionrefill
orderঅর্ডার ID

রেসপন্সের উদাহরণ

{
  "refill": 512
}

রিফিল স্ট্যাটাস (refill_status)

একটি রিফিল রিকোয়েস্টের স্ট্যাটাস।

প্যারামিটারবিবরণ
keyআপনার API key
actionrefill_status
refillরিফিল ID (refill রেসপন্সের refill)

রেসপন্সের উদাহরণ

{
  "status": "Completed"
}

ব্যালেন্স (balance)

আপনার ব্যালেন্স (USD, 6 দশমিক)।

প্যারামিটারবিবরণ
keyআপনার API key
actionbalance

রেসপন্সের উদাহরণ

{
  "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 keykey নেই, ভুল, অথবা নতুন key দিয়ে বদলানো হয়েছে
Too many requestsপ্রতি মিনিটে 300টির বেশি রিকোয়েস্ট। একটু পরে আবার চেষ্টা করুন
Incorrect actionaction এর মান উপরের লিস্টে নেই
Add funds firstএমন অ্যাকাউন্ট থেকে অর্ডার যার প্রথম টপ আপ এখনো যোগ হয়নি
Incorrect service IDএই ID তে অর্ডারযোগ্য কোনো সার্ভিস নেই
Incorrect linkলিংক খালি বা ওয়েব ঠিকানা নয়
Quantity out of rangeপরিমাণ সর্বনিম্নের কম বা সর্বোচ্চের বেশি
Incorrect commentsCustom 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 দিয়ে অগ্রগতি দেখুন।