بازگشت به صفحه اصلی

مستندات API

نسخه ۲.۰ | نشانی پایه: https://lorapanel.com/api/v2/

احراز هویت

همهٔ درخواست‌ها باید با متد POST و کلید API ارسال شوند. کلید را با نام key در بدنهٔ POST یا در سربرگ Authorization: Bearer بفرستید. کلید API را در نشانی URL قرار ندهید.

کلید API را از مسیر داشبورد ← پروفایل ← کلید API پیدا کنید.

POST

دریافت خدمات

در هر صفحه حداکثر ۵۰۰ خدمت همراه قیمت برمی‌گرداند (با اعمال تخفیف VIP). برای مرور همهٔ خدمات، پارامترهای page و per_page را بفرستید؛ سربرگ‌های پاسخ تعداد کل و وجود صفحهٔ بعدی را مشخص می‌کنند.

{
    "key": "YOUR_API_KEY",
    "action": "services",
    "page": 1,
    "per_page": 100
}

پاسخ: آرایه‌ای از خدمات شامل شناسه، نام، دسته‌بندی، نرخ، حداقل و حداکثر.

POST

ثبت سفارش

{
    "key": "YOUR_API_KEY",
    "action": "add",
    "service": 1,
    "link": "https://instagram.com/username",
    "quantity": 1000
}

پاسخ: شناسه سفارش. {"order": 12345}

For safe retries, send a stable Idempotency-Key header for this order. Reusing it with the same request returns the original order; reusing it with different order data returns HTTP 409. Keys are optional for compatibility with existing clients.

POST

وضعیت سفارش

{
    "key": "YOUR_API_KEY",
    "action": "status",
    "order": 12345
}

پاسخ: جزئیات سفارش شامل وضعیت، مبلغ و تعداد.

POST

فهرست سفارش‌ها

{
    "key": "YOUR_API_KEY",
    "action": "orders",
    "page": 1,
    "limit": 20
}
POST

بررسی موجودی

{
    "key": "YOUR_API_KEY",
    "action": "balance"
}

پاسخ: موجودی حساب و واحد پول. {"balance": 150000, "currency": "TOMAN"}

POST

سفارش تدریجی

سفارش را با فاصلهٔ زمانی در چند نوبت اجرا کنید.

{
    "key": "YOUR_API_KEY",
    "action": "drip-feed",
    "service": 1,
    "link": "https://instagram.com/post/abc123",
    "quantity": 5000,
    "runs": 10,
    "interval": 120
}

فاصله، تعداد دقیقه بین هر نوبت است. پاسخ: {"drip_feed": 42}

POST

سفارش انبوه

برای چند پیوند به‌طور هم‌زمان سفارش ثبت کنید (حداکثر ۵۰۰ پیوند).

{
    "key": "YOUR_API_KEY",
    "action": "mass-order",
    "service": 1,
    "links": "https://link1.com\nhttps://link2.com\nhttps://link3.com",
    "quantity": 1000
}

پیوندها را در خط‌های جداگانه وارد کنید. پاسخ: {"mass_order": 5, "count": 3}

محدودیت نرخ درخواست

  • حداکثر ۱۰۰ درخواست در دقیقه برای هر عملیات
  • در صورت عبور از محدودیت، پاسخ HTTP 429 برگردانده می‌شود
  • همهٔ پاسخ‌ها با قالب JSON هستند

نمونه کدها

PHP

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://lorapanel.com/api/v2/');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, [
    'key' => 'YOUR_API_KEY',
    'action' => 'add',
    'service' => 1,
    'link' => 'https://instagram.com/user',
    'quantity' => 1000
]);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Idempotency-Key: client-order-123']);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$result = json_decode(curl_exec($ch), true);
curl_close($ch);

Python

import requests

response = requests.post('https://lorapanel.com/api/v2/', headers={'Idempotency-Key': 'client-order-123'}, data={
    'key': 'YOUR_API_KEY',
    'action': 'add',
    'service': 1,
    'link': 'https://instagram.com/user',
    'quantity': 1000
})
print(response.json())

Node.js

const response = await fetch('https://lorapanel.com/api/v2/', {
    method: 'POST',
    headers: {'Content-Type': 'application/json', 'Idempotency-Key': 'client-order-123'},
    body: JSON.stringify({
        key: 'YOUR_API_KEY',
        action: 'add',
        service: 1,
        link: 'https://instagram.com/user',
        quantity: 1000
    })
});
const data = await response.json();