پرش به محتوای اصلی
زیروپنل زیروپنل 0PANEL

وب‌سرویس یکپارچه REST API و پنل همکاران

یک کلید API، یک کیف پول واحد و ۹ اکوسیستم متصل به درگاه‌های مرجع جهانی؛ با پشتیبانی از Idempotency-Key ضدتکرار، وب‌هوک امضاشده و تخفیف پلکانی همکاران VIP.

دریافت کلید API از پنل درخواست تعرفه همکاری عمده

سطوح همکاری و تخفیف پلکانی (VIP Tiers)

سطح ۱ · شروع سریع

توسعه‌دهنده (Starter)

0%
بدون حداقل خرید ماهانه · فعال بلافاصله پس از ثبت‌نام
  • دسترسی کامل به API تمام ۹ اکوسیستم
  • سقف ۶۰ درخواست در دقیقه
  • وب‌هوک آنی + لاگ ۵۰ درخواست اخیر
سطح ۲ · محبوب فروشگاه‌ها

همکار حرفه‌ای (Pro Reseller)

-4% تا -8%
فروش ماهانه بالای ۳۰ میلیون تومان (ارتقای خودکار)
  • تخفیف خودکار روی کل کاتالوگ API
  • سقف ۲۴۰ درخواست در دقیقه + لیست سفید IP
  • هشدار پیامکی/تلگرامی کمبود موجودی
سطح ۳ · سازمانی

همکار عمده (Enterprise)

توافقی VIP
فروش ماهانه بالای ۲۰۰ میلیون تومان
  • کف نرخ تامین‌کننده + تسویه مستقیم USDT
  • خط اختصاصی پردازش بدون صف (Priority Lane)
  • پشتیبان فنی اختصاصی در تلگرام

مرجع مسیرهای اصلی REST API

متد مسیر (Endpoint) توضیح عملکرد نرخ مجاز
GET /api/v1/balance استعلام لحظه‌ای موجودی کیف پول به تومان و سطح تخفیف VIP 120/min
GET /api/v1/services?eco=all دریافت لیست زنده سرویس‌ها، قیمت لحظه‌ای نوبیتکس و حداقل/حداکثر 60/min
POST /api/v1/orders ثبت سفارش اتمی با هدر Idempotency-Key ضدثبت تکراری 120/min
GET /api/v1/orders/{uuid} دریافت وضعیت زنده سفارش، کد OTP، کد Redeem یا QR کد eSIM 240/min
POST /api/v1/orders/{uuid}/cancel لغو شماره مجازی پیش از دریافت کد و عودت فوری ۱۰۰٪ وجه به کیف پول 60/min

نمونه‌کدهای آماده و تایید امنیتی وب‌هوک

curl -X POST https://0panel.com/api/v1/orders \
  -H "Authorization: Bearer zp_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: ord_9a8f4c12e7" \
  -d '{
    "ecosystem": "virtual-number",
    "sku": "VN-TG-DE",
    "webhook_url": "https://yourbot.ir/hooks/zp"
  }'
$ch = curl_init('https://0panel.com/api/v1/orders');
curl_setopt_array($ch, [
    CURLOPT_POST           => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => [
        'Authorization: Bearer zp_live_YOUR_API_KEY',
        'Content-Type: application/json',
        'Idempotency-Key: ' . bin2hex(random_bytes(8)),
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'ecosystem' => 'telegram',
        'sku'       => 'TG-STR-250',
        'target'    => '@customer_id',
    ]),
]);
$result = json_decode((string) curl_exec($ch), true);
import requests, uuid

res = requests.post(
    "https://0panel.com/api/v1/orders",
    headers={
        "Authorization": "Bearer zp_live_YOUR_API_KEY",
        "Idempotency-Key": str(uuid.uuid4()),
    },
    json={
        "ecosystem": "gaming-uid",
        "sku": "PUBG-325",
        "target": "5148293041",
    },
    timeout=12,
)
print(res.json())
const res = await fetch("https://0panel.com/api/v1/orders", {
  method: "POST",
  headers: {
    "Authorization": "Bearer zp_live_YOUR_API_KEY",
    "Content-Type": "application/json",
    "Idempotency-Key": crypto.randomUUID(),
  },
  body: JSON.stringify({
    ecosystem: "ai-api",
    sku: "OR-15USD",
    label: "prod-bot-key",
  }),
});
console.log(await res.json());
Webhook HMAC-SHA256
// Verify X-ZP-Signature on your Webhook receiver (PHP)
$rawBody   = file_get_contents('php://input');
$signature = $_SERVER['HTTP_X_ZP_SIGNATURE'] ?? '';
$expected  = hash_hmac('sha256', $rawBody, $YOUR_WEBHOOK_SECRET);

if (!hash_equals($expected, $signature)) {
    http_response_code(403);
    exit('Invalid signature');
}
$event = json_decode($rawBody, true);
// $event['event'] => 'otp.received' | 'order.completed' | 'order.refunded'