PanelBon • API Docs

Quick start

برای استفاده از API ابتدا باید کلید API خود را از ربات دریافت کنید:

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

          🎁 تخفیف اختصاصی:
          اگر برای کلید API شما تخفیف تعریف شده باشد، به‌صورت خودکار در تمام سفارشات اعمال می‌شود!
        

Base URL

https://www.panelbon.com/app/api/v2

تمام درخواست‌ها به این آدرس ارسال می‌شوند.

Authentication

کلید API خود را در پارامتر key قرار دهید:

key=YOUR_API_KEY&action=services

          ⚠️ امنیت:
          کلید API خود را در معرض دید عموم قرار ندهید. اگر فکر می‌کنید کلیدتان لو رفته، از ربات کلید جدید دریافت کنید.
        

Get services list

برای دریافت لیست تمام سرویس‌های فعال:

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

درخواست:

POST /api/v2

key=YOUR_API_KEY&action=services

پاسخ (با تخفیف):

[
  {
    "service": 1,
    "name": "Instagram Followers",
    "type": "Default",
    "category": "Instagram",
    "rate": "0.90",  // قیمت با تخفیف
    "original_rate": "1.00",  // قیمت اصلی (اگر تخفیف دارید)
    "discount_percent": 10,  // درصد تخفیف شما
    "min": "10",
    "max": "10000",
    "refill": false,
    "cancel": true
  }
]

          💡
          اگر برای کلیدتان تخفیف تعریف شده باشد، فیلدهای original_rate و discount_percent به response اضافه می‌شود.
        

Create new order

برای ثبت سفارش جدید:

پارامتر	نوع	توضیحات
key	string	کلید API شما
action	string	مقدار ثابت: `add`
service	int	شناسه سرویس از لیست services
link	string	لینک پست/پروفایل/کانال
quantity	int	تعداد مورد نظر

درخواست:

POST /api/v2

key=YOUR_API_KEY&action=add&service=1&link=https://instagram.com/username&quantity=1000

پاسخ (با تخفیف):

{
  "order": "CR-202411-0001",
  "original_price": "1.00",  // قیمت اصلی
  "discount": "0.10",  // مقدار تخفیف
  "final_price": "0.90"  // قیمت نهایی (پرداخت شده)
}

          ✅
          اگر برای کلید API شما تخفیف تعریف شده باشد، به‌صورت خودکار در محاسبه قیمت اعمال شده و از موجودی شما کم می‌شود.
        

Order status

برای بررسی وضعیت یک سفارش:

پارامتر	نوع	توضیحات
key	string	کلید API شما
action	string	مقدار ثابت: `status`
order	string	شماره سفارش دریافتی از add

درخواست:

POST /api/v2

key=YOUR_API_KEY&action=status&order=CR-202411-0001

پاسخ:

{
  "charge": "0.90",  // قیمت پرداختی
  "start_count": "1250",
  "status": "In progress",
  "remains": "450",
  "currency": "USD"
}

وضعیت‌های ممکن:

Pending - در انتظار پردازش
In progress - در حال انجام
Completed - تکمیل شده
Partial - تکمیل جزئی
Canceled - لغو شده

Multiple order status

برای بررسی وضعیت چند سفارش به‌صورت همزمان:

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

درخواست:

POST /api/v2

key=YOUR_API_KEY&action=status&orders=CR-001,CR-002,CR-003

پاسخ:

{
  "CR-001": {
    "charge": "0.90",
    "status": "Completed",
    ...
  },
  "CR-002": {
    "error": "Incorrect order ID"
  }
}

Account balance

برای دریافت موجودی فعلی:

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

درخواست:

POST /api/v2

key=YOUR_API_KEY&action=balance

پاسخ:

{
  "balance": "100.50",
  "currency": "USD"
}

Cancel order

برای لغو یک یا چند سفارش (اگر امکان لغو داشته باشد):

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

درخواست:

POST /api/v2

key=YOUR_API_KEY&action=cancel&orders=CR-001,CR-002

پاسخ:

[
  {
    "order": "CR-001",
    "cancel": 1
  },
  {
    "order": "CR-002",
    "cancel": {
      "error": "Order cannot be canceled"
    }
  }
]

Error handling

در صورت بروز خطا، پاسخ شامل فیلد error خواهد بود:

{
  "error": "Invalid API key"
}

خطاهای رایج:

HTTP	پیام	دلیل
401	Invalid API key	کلید نامعتبر یا غیرفعال
400	Invalid parameters	پارامترهای ورودی اشتباه
400	Insufficient balance	موجودی کافی نیست
404	Incorrect service ID	سرویس پیدا نشد
502	server error	مشکل در ارتباط با سرور ها

          ⚠️
          اگر کلید API شما غیرفعال شود، تمام درخواست‌ها با خطای 401 مواجه می‌شوند.
        

Code examples

# Python Example
import requests

API_KEY = "YOUR_API_KEY"
BASE_URL = "https://www.panelbon.com/app/api/v2"

# get Services
response = requests.post(BASE_URL, data={
    "key": API_KEY,
    "action": "services"
})
services = response.json()

# make order
response = requests.post(BASE_URL, data={
    "key": API_KEY,
    "action": "add",
    "service": 1,
    "link": "https://instagram.com/username",
    "quantity": 1000
})
result = response.json()
print(f"Order ID: {result['order']}")
print(f"Final Price: ${result['final_price']}")

// PHP Example
$apiKey = "YOUR_API_KEY";
$baseUrl = "https://www.panelbon.com/app/api/v2";

// get Services
$ch = curl_init($baseUrl);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query([
    'key' => $apiKey,
    'action' => 'services'
]));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
$services = json_decode($response, true);
curl_close($ch);

// make order
$ch = curl_init($baseUrl);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query([
    'key' => $apiKey,
    'action' => 'add',
    'service' => 1,
    'link' => 'https://instagram.com/username',
    'quantity' => 1000
]));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
$result = json_decode($response, true);
echo "Order ID: " . $result['order'] . "\n";
echo "Final Price: $" . $result['final_price'];

// JavaScript Example (Node.js)
const axios = require('axios');

const API_KEY = 'YOUR_API_KEY';
const BASE_URL = 'https://www.panelbon.com/app/api/v2';

// get Services
async function getServices() {
  const response = await axios.post(BASE_URL, new URLSearchParams({
    key: API_KEY,
    action: 'services'
  }));
  return response.data;
}

// make order
async function createOrder() {
  const response = await axios.post(BASE_URL, new URLSearchParams({
    key: API_KEY,
    action: 'add',
    service: '1',
    link: 'https://instagram.com/username',
    quantity: '1000'
  }));
  
  console.log(`Order ID: ${response.data.order}`);
  console.log(`Final Price: $${response.data.final_price}`);
  return response.data;
}

createOrder();