مستندات API پنل‌بان (PanelBon)

پلتفرم پنل‌بان دارای API استاندارد و یکپارچه برای اتصال انواع وب‌سایت‌ها، افزونه‌ها (کندو پنل، اسمارت‌پنل و پرفکت‌پنل) و برنامه‌نویسان است.

💡

کدام نسخه را انتخاب کنم؟
اگر از اسکریپت‌های کندو پنل (Kando)، اسمارت‌پنل (SmartPanel) یا افزونه‌های وردپرس استفاده می‌کنید، از نسخه v1 استفاده کنید. اگر برنامه‌نویس هستید یا کنترل پیشرفته‌تری می‌خواهید، نسخه v2 نیز در دسترس است.

آدرس پایه (Endpoint URL)

POST https://www.panelbon.com/app/api/v1

احراز هویت (Authentication)

در تمام درخواست‌ها، ارسال کلید اختصاصی در فیلد key الزامی است. کلید خود را می‌توانید از طریق ربات تلگرام یا مینی‌اپ در بخش توکن API دریافت کنید.

🔌 راهنمای اتصال کندو پنل و اسمارت‌پنل (Kando / SmartPanel)

اگر صاحب وب‌سایت خدمات مجازی با اسکریپت کندو پنل یا اسمارت‌پنل هستید، طبق ۳ مرحله زیر پنل‌بان را به عنوان ارائه‌دهنده (Provider) ست کنید:

۱ دریافت کلید API اختصاصی

وارد ربات رسمی پنل‌بان شوید، دکمه 🔑 توکن API را بزنید و کلید خود را کپی کنید.

۲ افزودن پنل‌بان در بخش ارائه‌دهندگان (Providers)

در مدیریت کندو پنل / اسمارت‌پنل به بخش Providers / ارائه‌دهنده‌ها بروید و دکمه جدید را بزنید:

نام ارائه‌دهنده:	پنل‌بان (PanelBon)
API URL:	`https://www.panelbon.com/app/api/v1`
API Key:	کلید کپی شده در مرحله اول

۳ همگام‌سازی و ایمپورت سرویس‌ها

روی دکمه همگام‌سازی سرویس‌ها (Sync Services) کلیک کنید. تمامی سرویس‌های فعال پنل‌بان با نرخ‌ها و تخفیف‌های ویژه به سیستم شما اضافه خواهند شد.

۱. دریافت لیست سرویس‌ها (Services)

دریافت شناسه سرویس‌ها، عنوان، دسته‌بندی، نوع، حداقل/حداکثر و نرخ دلاری به ازای هر ۱۰۰۰ عدد.

پارامترهای ارسالی

پارامتر	نوع	توضیحات
`key`اجباری	string	کلید API شما
`action`اجباری	string	مقدار ثابت: `services`

Response JSON

[
  {
    "service": "5",
    "name": "Instagram Followers [Instant]",
    "category": "Instagram Followers",
    "rate": "0.90",
    "min": "100",
    "max": "50000",
    "type": "default",
    "desc": "usernames",
    "dripfeed": 1
  }
]

۲. ثبت سفارش جدید (Add Order)

ثبت سفارش بر اساس نوع سرویس (معمولی، کامنت دلخواه، نظرسنجی و...).

پارامترهای ارسالی

پارامتر	نوع	توضیحات
`key`اجباری	string	کلید API شما
`action`اجباری	string	مقدار ثابت: `add`
`service`اجباری	int	شناسه سرویس (از لیست services)
`link`اجباری	string	لینک پست یا آیدی مقصد
`quantity`اجباری	int	تعداد (در سرویس‌های عادی)
`comments`اختیاری	string	متن کامنت‌ها (جداشده با )
`answer_number`اختیاری	int	شماره گزینه نظرسنجی

Response (Success)

{
  "status": "success",
  "order": "CR-1002"
}

۳. پیگیری وضعیت سفارش (Status)

استعلام وضعیت سفارش به صورت تکی یا چندتایی (جدا شده با کاما).

پارامترها

پارامتر	نوع	توضیحات
`key`اجباری	string	کلید API شما
`action`اجباری	string	مقدار: `status`
`order`تکی	string	شناسه سفارش تکی
`orders`گروهی	string	شناسه‌ها با کاما (مثلاً: `CR-1,CR-2`)

Response (Single / Multi)

{
  "order": "CR-1002",
  "status": "processing",
  "charge": "0.9000",
  "start_count": "1200",
  "remains": "0"
}

۴. جبران ریزش و لغو سفارش (Refill & Cancel)

جبران ریزش (Refill)

ارسال درخواست برای سفارش‌هایی که گارانتی جبران ریزش دارند:

key=YOUR_KEY&action=refill&order=CR-1002

پاسخ: {"refill": "1"}

لغو سفارش (Cancel)

لغو گروهی سفارش‌ها تا حداکثر ۱۰۰ شناسه:

key=YOUR_KEY&action=cancel&orders=CR-1,CR-2

۵. استعلام موجودی (Balance)

`key`اجباری	کلید API شما
`action`اجباری	مقدار: `balance`

Response JSON

{
  "status": "success",
  "balance": "125.40",
  "currency": "USD"
}

نمونه کدهای اتصال (Code Examples)

import requests

API_KEY = "YOUR_API_KEY"
API_URL = "https://www.panelbon.com/app/api/v1"

# 1. استعلام موجودی
res_balance = requests.post(API_URL, data={"key": API_KEY, "action": "balance"}).json()
print("موجودی شما:", res_balance)

# 2. ثبت سفارش
payload = {
    "key": API_KEY,
    "action": "add",
    "service": 5,
    "link": "https://instagram.com/username",
    "quantity": 1000
}
res_order = requests.post(API_URL, data=payload).json()
print("نتیجه سفارش:", res_order)

<?php
$apiKey = "YOUR_API_KEY";
$apiUrl = "https://www.panelbon.com/app/api/v1";

// ثبت سفارش در پنل‌بان
$ch = curl_init($apiUrl);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query([
    'key'      => $apiKey,
    'action'   => 'add',
    'service'  => 5,
    'link'     => 'https://instagram.com/username',
    'quantity' => 1000
]));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);

print_r($response);
?>

const axios = require('axios');

const API_KEY = 'YOUR_API_KEY';
const API_URL = 'https://www.panelbon.com/app/api/v1';

async function createOrder() {
  const params = new URLSearchParams({
    key: API_KEY,
    action: 'add',
    service: '5',
    link: 'https://instagram.com/username',
    quantity: '1000'
  });
  
  const { data } = await axios.post(API_URL, params);
  console.log('Order Result:', data);
}

createOrder();