آموزش API پنل اس‌ام‌ام سینتل

⚡ خلاصه: با API سینتل، سایت، ربات یا پنلِ نمایندگیِ خودت مستقیم به همهٔ سرویس‌های سوشال — جهانی و ایرانی (روبیکا، ایتا، بله، ممبرِ ایرانی…) — وصل می‌شود: فهرست و قیمت را می‌گیری، سفارش ثبت می‌کنی، وضعیت را دنبال می‌کنی و ریفیل یا لغو می‌خواهی. پروتکل همان SMM API v2 است که پنل‌های نمایندگی از قبل می‌شناسند؛ کلید را از پنلِ کاربری → API برمی‌داری.

API پنل اس‌ام‌ام به چه دردی می‌خورد؟

اگر خودت سرویس می‌فروشی — روی سایت، رباتِ تلگرام یا یک پنلِ نمایندگی — نمی‌خواهی هر سفارش را دستی در سینتل ثبت کنی. با API، مشتریِ تو سفارش می‌دهد و سیستمِ تو همان لحظه آن را به سینتل می‌فرستد؛ مبلغ از کیف پولِ تو کم می‌شود و وضعیت خودکار برمی‌گردد. قیمت‌ها همان قیمتِ سایت‌اند و روی آن سودِ خودت را می‌گذاری.

قدمِ ۱ — گرفتنِ کلید

1. وارد پنلِ کاربری شو و از منو API را باز کن.
2. آدرسِ API و کلیدِ اختصاصی‌ات آنجاست؛ با دکمهٔ کپی برش دار.
3. کیف پولت را شارژ کن؛ هر سفارشِ API از همین موجودی پرداخت می‌شود.

⚠️ کلید مثلِ رمزِ کیف پولت است: فقط روی سرورِ خودت نگهش دار، نه در کدِ سمتِ مرورگر یا اپ. اگر لو رفت، در همان صفحه «ساخت کلید جدید» را بزن تا کلیدِ قبلی باطل شود.

قدمِ ۲ — آدرس و روشِ ارسال

همهٔ درخواست‌ها با HTTP POST (فیلدهای معمولیِ فرم) به این آدرس می‌روند و پاسخ JSON است:

https://sintell.ir/panel/api.php

در هر درخواست دو فیلدِ key (کلیدت) و action (نامِ عملیات) لازم است. مبالغ به تومان (IRT) است.

قدمِ ۳ — متدها

نمونهٔ پاسخِ services (هر سرویس یک ردیف):

{"service":1234,"name":"…","type":"Default","category":"…","rate":"12500",
 "min":"100","max":"4500","refill":false,"cancel":false,"dripfeed":false,"description":"…"}

rate قیمتِ هر ۱۰۰۰ عدد به تومان است. هزینهٔ یک سفارش ≈ rate × quantity ÷ 1000. تعداد باید بینِ min و max همان سرویس باشد.

قدمِ ۴ — نمونهٔ کاملِ PHP

این کلاس را در پروژه‌ات بگذار؛ همهٔ متدها را پوشش می‌دهد و خطای شبکه را هم برمی‌گرداند:

<?php
class SintellApi
{
    private string $url = 'https://sintell.ir/panel/api.php';
    public function __construct(private string $key) {}

    private function call(array $data): array
    {
        $ch = curl_init($this->url);
        curl_setopt_array($ch, [
            CURLOPT_POST           => true,
            CURLOPT_POSTFIELDS     => http_build_query($data + ['key' => $this->key]),
            CURLOPT_RETURNTRANSFER => true,
            CURLOPT_TIMEOUT        => 60,
            CURLOPT_ENCODING       => '',   // gzip
        ]);
        $body = curl_exec($ch);
        $err  = curl_error($ch);
        curl_close($ch);
        if ($body === false) return ['error' => 'Network error: ' . $err];
        $json = json_decode($body, true);
        return is_array($json) ? $json : ['error' => 'Invalid response'];
    }

    public function balance(): array                    { return $this->call(['action' => 'balance']); }
    public function services(string $lang = 'fa'): array { return $this->call(['action' => 'services', 'lang' => $lang]); }
    public function order(int $service, string $link, int $quantity, array $extra = []): array
    {
        return $this->call(['action' => 'add', 'service' => $service, 'link' => $link, 'quantity' => $quantity] + $extra);
    }
    public function status(int $order): array            { return $this->call(['action' => 'status', 'order' => $order]); }
    public function multiStatus(array $orders): array    { return $this->call(['action' => 'status', 'orders' => implode(',', $orders)]); }
    public function refill(int $order): array            { return $this->call(['action' => 'refill', 'order' => $order]); }
    public function cancel(array $orders): array         { return $this->call(['action' => 'cancel', 'orders' => implode(',', $orders)]); }
}

$api = new SintellApi('YOUR_API_KEY');
print_r($api->balance());

$serviceId = 1234;   // a Telegram post-view service ID from services()
$res = $api->order($serviceId, 'https://t.me/sintell/100', 1000);
if (isset($res['error'])) {
    echo 'Order failed: ' . $res['error'];   // nothing was charged
} else {
    print_r($api->status($res['order']));
}

نمونه با cURL (خطِ فرمان)

curl -X POST https://sintell.ir/panel/api.php \
  -d key=YOUR_API_KEY -d action=add \
  -d service=1234 -d link=https://t.me/sintell/100 -d quantity=1000

curl -X POST https://sintell.ir/panel/api.php \
  -d key=YOUR_API_KEY -d action=status -d orders=1402,1403

وضعیت‌های سفارش

• Pending — ثبت شده و در صفِ شروع است (سرویس‌های ایرانی تا بررسیِ کوتاهِ دستی همین را نشان می‌دهند).
• Processing / In progress — در حالِ انجام؛ remains باقی‌مانده را می‌گوید.
• Completed — کامل تحویل شد.
• Partial — بخشی تحویل شد؛ مبلغِ بخشِ انجام‌نشده به کیف پول برگشته و charge مبلغِ واقعیِ پرداختی است.
• Canceled — انجام نشد و مبلغ برگشت.

خطاها و نکته‌های مهم

• هر خطا به شکلِ {"error":"…"} برمی‌گردد و هیچ مبلغی کم نمی‌شود. متن می‌گوید چه چیزی را درست کنی: لینکِ نامعتبر، تعدادِ خارج از بازه، موجودیِ ناکافی و…
• تکرار را خودت کنترل کن: هر add یک سفارشِ تازه است (شاید برای دو مشتری یک لینک را بفرستی). اگر درخواستی timeout شد، اول با status سفارش‌های اخیرت را ببین، بعد دوباره بفرست.
• سقفِ درخواست: ۱۲۰ درخواست در دقیقه برای هر کلید. فهرستِ سرویس‌ها را کش کن؛ هر چند دقیقه یک بار عوض می‌شود.
• لینک باید عمومی و متناسب با سرویس باشد: پروفایل/کانال برای فالوور و ممبر، لینکِ پست برای لایک، بازدید و ری‌اکشن.
• ری‌اکشن: ایموجی جزوِ خودِ سرویس است؛ برای هر ایموجی سرویسِ همان ایموجی را سفارش بده.
• ارسالِ تدریجی (runs/interval) از طریقِ API در دسترس نیست.

API برای نماینده‌ها

اگر پنلِ نمایندگیِ آماده (مثلِ پنل‌های PerfectPanel) داری، سینتل را به‌عنوانِ «تأمین‌کننده» با همین آدرس و کلید اضافه کن؛ نوعِ API را Standard / v2 بگذار. اگر رباتِ نمایندگی می‌خواهی و نه کد، نمایندگیِ سینتل همه‌چیز را آماده تحویل می‌دهد — راهنمایش را در نمایندگی و کسب درآمد بخوان.