بازگشت به سایت
نسخه ۳.۳ • مستندات رسمی

مستندات API اعتبارسنجی آی‌پی

سرویس IP Validator با بررسی آدرس آی‌پی، اطلاعات دقیقی در مورد وضعیت پروکسی، VPN، شبکه تور و نوع میزبان را در قالب JSON برمی‌گرداند.

۱. ساختار درخواست

برای استفاده از سرویس، یک درخواست GET به آدرس زیر ارسال کنید. پارامتر apikey اختیاری است اما برای ردیابی درخواست‌ها و استفاده از طرح‌های پولی ضروری می‌باشد.

GET https://ipvalidator.ir/api/?apikey=[API-key]&ip=[IP-address]
نام پارامتر نوع الزامی توضیحات مثال
apikey string خیر * کلید اختصاصی شما. پس از ثبت‌نام در پنل کاربری قابل دریافت است. 9b95433b...
ip string خیر آی‌پی مورد بررسی. در صورت خالی بودن، آی‌پی درخواست‌دهنده (Client IP) بررسی می‌شود. 8.8.8.8

* ارسال apikey برای طرح‌های رایگان محدودیت دارد، اما برای طرح‌های حرفه‌ای و سازمانی الزامی است.

۲. ساختار پاسخ (JSON)
application/json
{
  "your_ip": "8.8.8.8",
  "status": "no",
  "status_tor": "no",
  "hosted": "nothing",
  "message": "You are not using a proxy.",
  "source": "https://ipvalidator.ir/api/readme.html",
  "version": "3.3",
  "admin_message": "for now: https://ipvalidator.ir/api"
}
فیلد نوع توضیحات
your_ip string آی‌پی بررسی‌شده.
status string yes → استفاده از پروکسی/VPN | no → پاک.
status_tor string yes → آی‌پی متعلق به شبکه تور است | no → خیر.
hosted string نوع میزبان: vps, proxy, vpn, یا nothing (ISP معمولی).
message string پیام توضیحی کوتاه به زبان انگلیسی.
version string نسخه فعلی API.
۳. نمونه کدهای پیاده‌سازی

JavaScript (Fetch)

JavaScript
async function checkIP(ip) {
  const url = new URL('https://ipvalidator.ir/api/');
  url.searchParams.set('apikey', 'YOUR_API_KEY');
  url.searchParams.set('ip', ip);
  
  try {
    const resp = await fetch(url);
    const data = await resp.json();
    console.log(data);
  } catch (error) {
    console.error('Error:', error);
  }
}

checkIP('8.8.8.8');

PHP (cURL)

PHP
<?php
$apiKey = 'YOUR_API_KEY';
$ip = '8.8.8.8';
$url = "https://ipvalidator.ir/api/?apikey={$apiKey}&ip={$ip}";

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);

$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);
print_r($data);
?>

Python (Requests)

Python
import requests

url = "https://ipvalidator.ir/api/"
params = {
    "apikey": "YOUR_API_KEY",
    "ip": "8.8.8.8"
}

response = requests.get(url, params=params)
data = response.json()

print(data)
۴. تست زنده API

آی‌پی مورد نظر خود را وارد کنید تا پاسخ واقعی سرور را به‌صورت زنده مشاهده کنید.

// نتیجه درخواست اینجا نمایش داده می‌شود...