مستندات API

احراز هویت و قواعد کلی

• کلید API را در پارامتر key بفرستید؛ هر کاربر کلید خود را در پنل کاربر ← تنظیمات ← کارت «API ریسلر» می‌بیند و می‌تواند بازتولید کند.
• همه درخواست‌ها با متد POST ارسال می‌شوند و پاسخ همیشه JSON است؛ حتی خطاها با کد وضعیت ۲۰۰ برگردانده می‌شوند.
• حساب کاربری باید فعال باشد، در غیر این صورت پاسخ {"error":"Your account is not active"} است.
• اگر API از تنظیمات مدیریت خاموش شود، پاسخ {"error":"API is disabled by administrator"} برمی‌گردد.

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

action=balance مشاهده موجودی

مشاهده موجودی کیف پول و واحد پول حساب

پارامترها

نمونه پاسخ

{
  "balance": "100.84292",
  "currency": "Toman"
}

action=services لیست سرویس‌ها

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

پارامترها

نمونه پاسخ

[
  {
    "service": 1,
    "name": "Instagram Followers - Real",
    "type": "Default",
    "category": "Instagram",
    "rate": "0.90",
    "min": "100",
    "max": "10000"
  },
  {
    "service": 2,
    "name": "Instagram Likes - Quick",
    "type": "Default",
    "category": "Instagram",
    "rate": "0.12",
    "min": "50",
    "max": "50000"
  }
]

action=add ثبت سفارش جدید

ثبت سفارش جدید؛ هزینه سفارش به‌صورت خودکار از کیف پول کسر می‌شود

پارامترها

نمونه پاسخ

{
  "order": 23501
}

action=status وضعیت سفارش

پیگیری وضعیت، هزینه، شروع شمارنده و باقیمانده سفارش

پارامترها

نمونه پاسخ

{
  "charge": "0.27819",
  "start_count": "3572",
  "status": "Partial",
  "remains": "157",
  "currency": "Toman"
}

action=cancel درخواست لغو سفارش

ثبت درخواست لغو سفارش که پس از بررسی مدیر اعمال می‌شود. دلیل اختیاری است و در پنل مدیریت نمایش داده می‌شود.

پارامترها

نمونه پاسخ

{
  "order": 23501,
  "cancel": "Pending"
}

action=refill درخواست شارژ مجدد

ثبت درخواست شارژ مجدد برای سفارش‌های تکمیل‌شده یا جزئی که به سرویس‌دهنده ارسال شده‌اند.

پارامترها

نمونه پاسخ

{
  "order": 23501,
  "refill": "Pending"
}

action=ai_balance موجودی توکن هوش مصنوعی

مشاهده موجودی توکن، نام نمایشی مدل و نرخ توکن (تعداد توکن به‌ازای مبلغ مبنا).

پارامترها

نمونه پاسخ

{
  "tokens": "250000",
  "model": "gpt-4o-mini",
  "model_label": "Neuro AI",
  "rate_amount": "10000",
  "rate_tokens": "83333",
  "currency": "Toman"
}

action=ai_chat گفت‌وگو با مدل هوش مصنوعی

ارسال پیام به مدل متصل پنل؛ توکن مصرفی خودکار از موجودی کسر و در گزارش مصرف ثبت می‌شود.

پارامترها

نمونه پاسخ

{
  "reply": "Hello! How can I help you today?",
  "usage": {
    "prompt_tokens": 32,
    "completion_tokens": 48,
    "total_tokens": 80
  },
  "tokens": "249920"
}

action=ai_packages فهرست بسته‌های توکن

دریافت بسته‌های فعال توکن به‌همراه تعداد توکن و مبلغ شارژ هر بسته.

پارامترها

نمونه پاسخ

[
  {
    "package": 1,
    "name": "Basic",
    "tokens": "100000",
    "price": "12000.00",
    "currency": "Toman"
  },
  {
    "package": 2,
    "name": "Pro",
    "tokens": "500000",
    "price": "55000.00",
    "currency": "Toman"
  }
]

action=ai_buy_package خرید بسته توکن با کیف پول

خرید بسته توکن با موجودی کیف پول؛ توکن خریداری‌شده بلافاصله به موجودی اضافه می‌شود.

پارامترها

نمونه پاسخ

{
  "package": 1,
  "name": "Basic",
  "tokens": "100000",
  "balance": "100000"
}

action=ai_usage گزارش مصرف توکن

آمار مصرف توکن: موجودی، تعداد درخواست‌ها، جمع ورودی/خروجی/کل و آخرین درخواست‌ها.

پارامترها

نمونه پاسخ

{
  "tokens": "249920",
  "requests": "12",
  "prompt": "820",
  "completion": "1180",
  "total": "2000",
  "avg": "167",
  "items": [
    {
      "prompt_tokens": "32",
      "completion_tokens": "48",
      "total_tokens": "80",
      "model": "Neuro AI",
      "created_at": 1763892000,
      "date": "2026-09-22 14:05"
    }
  ]
}

action=vnum_services فهرست خدمات شماره مجازی

دریافت خدمات فعال شماره مجازی (کشور، اپراتور، نوع سرویس) با قیمت نهایی فروش پس از اعمال درصد سود پنل.

پارامترها

نمونه پاسخ

[
  {
    "service": 14,
    "name": "Telegram - Russia - Any",
    "country": "Russia",
    "operator": "Any",
    "type": "Telegram",
    "price": "24000.00",
    "currency": "Toman"
  },
  {
    "service": 15,
    "name": "WhatsApp - USA - Verizon",
    "country": "USA",
    "operator": "Verizon",
    "type": "WhatsApp",
    "price": "48000.00",
    "currency": "Toman"
  }
]

action=vnum_buy خرید شماره مجازی

خرید شماره مجازی برای کاربر؛ مبلغ از کیف پول کسر و شماره در بازه اعتبار مشخص‌شده فعال می‌شود.

پارامترها

نمونه پاسخ

{
  "order": 812,
  "order_no": "VN-A7K9P2",
  "service": 14,
  "number": "+79876543210",
  "status": "Pending",
  "code": "",
  "charge": "24000.00",
  "expires_at": 1763892000,
  "remaining_seconds": 1200,
  "currency": "Toman"
}

action=vnum_status وضعیت شماره و کد تأیید

مشاهده وضعیت شماره، کد تأیید پیامک و زمان باقی‌مانده اعتبار (همراه با به‌روزرسانی از سرویس‌دهنده).

پارامترها

نمونه پاسخ

{
  "order": 812,
  "order_no": "VN-A7K9P2",
  "service": 14,
  "number": "+79876543210",
  "status": "Received",
  "code": "4571",
  "sms": "Your Telegram code is 4571",
  "charge": "24000.00",
  "created_at": 1763890800,
  "expires_at": 1763892000,
  "remaining_seconds": 640,
  "currency": "Toman"
}

action=vnum_orders فهرست سفارش‌های شماره مجازی

فهرست آخرین سفارش‌های شماره مجازی کاربر.

پارامترها

نمونه پاسخ

[
  {
    "order": 812,
    "order_no": "VN-A7K9P2",
    "service": 14,
    "number": "+79876543210",
    "status": "Received",
    "code": "4571",
    "charge": "24000.00",
    "created_at": 1763890800,
    "expires_at": 1763892000,
    "remaining_seconds": 640,
    "currency": "Toman"
  },
  {
    "order": 795,
    "order_no": "VN-M2X4R8",
    "service": 15,
    "number": "+13456789012",
    "status": "Expired",
    "code": "",
    "charge": "48000.00",
    "created_at": 1763804400,
    "expires_at": 1763805600,
    "remaining_seconds": 0,
    "currency": "Toman"
  }
]

action=vnum_cancel لغو شماره و بازگشت وجه

لغو شماره در حالت «در انتظار پیامک» و بازگشت مبلغ به کیف پول کاربر.

پارامترها

نمونه پاسخ

{
  "canceled": 1,
  "order": 812,
  "balance": "101000.00",
  "currency": "Toman"
}

نکته‌های مهم

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

Pending · Processing · In progress · Completed · Partial · Canceled · Refunded

وضعیت‌های خروجی شماره مجازی

Pending (در انتظار پیامک) · Received (کد آماده) · Canceled · Expired (پایان اعتبار)

نکات توکن هوش مصنوعی

موجودی توکن در action=ai_balance نمایش داده می‌شود، در action=ai_chat مصرف می‌شود و در action=ai_usage گزارش می‌گردد. اگر سرویس توکن یا اتصال مدل در تنظیمات کامل نباشد، همین اکشن‌ها خطای مربوطه را برمی‌گردانند.

نکات شماره مجازی

قیمت هر خدمت از API سایت مبدا خوانده و با درصد سود پنل محاسبه می‌شود. پس از خرید، شماره تا پایان بازه اعتبار فعال است: در این بازه با action=vnum_status کد تأیید را بگیرید و تا پیش از دریافت پیامک می‌توانید با action=vnum_cancel شماره را لغو کنید تا مبلغ به کیف پول برگردد. اکشن vnum_order نام جایگزین vnum_buy است.

خطاها

در صورت خطا، پاسخ به‌صورت {"error":"پیام خطا"} و با کد HTTP ۲۰۰ بازگردانده می‌شود تا با اسکریپت‌های متداول ریسلر سازگار باشد.

نمونه کد

PHP (cURL)

<?php
$ch = curl_init('https://novin-data.ir/api.php');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => http_build_query([
        'key'      => 'YOUR_API_KEY',
        'action'   => 'add',
        'service'  => 12,
        'link'     => 'https://instagram.com/p/xxxxx',
        'quantity' => 1000,
    ]),
    CURLOPT_RETURNTRANSFER => true,
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response; // {"order":23501}

Python (requests)

import requests

resp = requests.post('https://novin-data.ir/api.php', data={
    'key': 'YOUR_API_KEY',
    'action': 'vnum_status',
    'order': 812,
})
print(resp.json())

JavaScript (fetch)

const res = await fetch('https://novin-data.ir/api.php', {
  method: 'POST',
  headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
  body: new URLSearchParams({
    key: 'YOUR_API_KEY',
    action: 'ai_chat',
    message: 'Write a short Instagram caption about coffee',
  }),
});
const data = await res.json();
console.log(data.reply, data.tokens);