مستندات API – IP‑Validator

سرویس https://ipvalidator.ir/api/ با پارامتر ip آدرس آی‌پی را بررسی کرده و اطلاعاتی در مورد وضعیت پروکسی، VPN، تور و نوع میزبان برمی‌گرداند.

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

استفاده از پارامتر ip در رشتهٔ query. اگر پارامتر داده نشود، IP خود درخواست‌کننده بررسی می‌شود.

GET https://ipvalidator.ir/api/?apikey=[API-key]&ip=[IP-address]

پارامترها

نام	نوع	توضیح	مثال
ip	string	کلید اختصاصی شما. پس از ثبت‌نام در پنل کاربری قابل دریافت است.	apikey=
apikey	string	آی‌پی مورد بررسی. خالی -> آی‌پی کلاینت.	ip=8.8.8.8

2. نمونهٔ پاسخ JSON

{
  "your_ip":"127.0.0.1",
  "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).
message	string	پیام کوتاه.
source	string	آدرس مرجع.
version	string	نسخه API.
Admin Message:	string	پیام‌های مدیریتی.

3. نمونهٔ استفاده در مرورگر

یک لینک ساده برای تست آدرس IP 8.8.8.8:

تست آی‌پی 8.8.8.8

4. نمونهٔ اسکریپت جاوااسکریپت

async function checkIP(ip){
  const url = new URL('https://ipvalidator.ir/api/');
  url.searchParams.set('ip', ip);
  const resp = await fetch(url);
  const data = await resp.json();
  console.log(data);
  document.getElementById('result').textContent = JSON.stringify(data, null, 2);
}
checkIP('8.8.8.8');

نتیجهٔ درخواست

...پرسش در حال اجرا...