فحص Endpoint

endpoint تشخيصي عام يعيد IP العميل الخاص بك وتفاصيل كشف proxy. استخدمه للتحقق مما إذا كانت حركة المرور الصادرة تمر عبر proxy قبل البدء في إرسال requests عبر FourA.

Request

GET /inspect

هذا الـ endpoint عام. لا يتطلب API key، ولا X-API-Key header.

curl https://eu.api.foura.ai/inspect

Response

{
  "clientIp": "203.0.113.42",
  "proxyDetection": {
    "isProxy": false,
    "proxyType": "none",
    "anonymityLevel": "none",
    "confidence": "medium",
    "detectedHeaders": [],
    "explanation": "Direct connection (no client-side proxy detected). Note: Elite proxies cannot be ruled out without additional data."
  },
  "proxyChain": {
    "originalClientIp": "203.0.113.42",
    "proxyCount": 0,
    "hasPrivateIps": false
  },
  "timestamp": "2026-04-29T08:07:04.683Z"
}

الحقول الرئيسية

الحقل	النوع	الوصف
`clientIp`	string	IP العميل الأصلي (العنوان في أقصى اليسار في سلسلة التوجيه)
`proxyDetection`	object	تحليل كشف الـ proxy ومستوى المجهولية
`proxyChain`	object	تفصيل سلسلة IP من جهة العميل
`timestamp`	string	طابع زمني بتنسيق ISO 8601 لوقت فحص الـ request

`proxyDetection`

الحقل	النوع	الوصف
`isProxy`	boolean	تكون True إذا تم كشف headers لـ proxy من جهة العميل
`proxyType`	string	أحد القيم التالية: `transparent` أو `anonymous` أو `distorting` أو `elite` أو `none`
`anonymityLevel`	string	أحد القيم التالية: `transparent` أو `anonymous` أو `elite` أو `none`
`confidence`	string	مستوى الثقة في الكشف: `high` أو `medium` أو `low`
`detectedHeaders`	string[]	أسماء الـ headers التي أشارت إلى وجود proxy (مثل `via` و `forwarded`)
`explanation`	string	ملخص باللغة الإنجليزية البسيطة للنتيجة

`proxyChain`

الحقل	النوع	الوصف
`originalClientIp`	string	نفس قيمة `clientIp` في المستوى الأعلى
`proxyChain`	string[]	قائمة بعناوين IP الخاصة بالـ proxies بينك وبين FourA، إن وجدت
`proxyCount`	number	عدد الـ proxies المكتشفة في السلسلة (0 = مباشر)
`via`	string[]	محتويات الـ `Via` header، إن وجدت
`hasPrivateIps`	boolean	تكون True إذا ظهرت أي عناوين IP خاصة/داخلية في السلسلة

أنواع الـ Proxy

النوع	ماذا يعني
`transparent`	يمرر الـ IP الحقيقي الخاص بك ويعرّف نفسه كـ proxy
`anonymous`	يخفي الـ IP الحقيقي الخاص بك ولكنه يعرّف نفسه كـ proxy
`distorting`	يرسل IP عميل مزيف إلى الوجهة
`elite`	لا يحتوي على proxy headers، ويبدو كاتصال مباشر
`none`	لم يتم كشف أي proxy من جهة العميل

متى تستخدم هذا

التأكد من أن حركة المرور الصادرة لا تمر عبر proxy خاص بالشركة أو VPN لم تكن تتوقعه.
تصحيح الأخطاء (Debug) لمعرفة سبب ظهور الـ IP الحقيقي الخاص بك في سجلات الموقع المستهدف حتى عندما كنت تعتقد أنك مجهول الهوية.
التحقق من أن الـ proxy السكني (residential) أو الدوار (rotating) يحجب أصلك قبل إرسال requests مدفوعة عبر FourA.

يفحص هذا الـ endpoint اتصالك بـ FourA. وهو لا يختبر شبكة الـ proxy الخاصة بـ FourA نفسها. للتحقق من الـ IP الذي يأتي منه الـ request الموجه عبر FourA، استخدم Proxy endpoint واقرأ الـ response.

الحدود

لا يتطلب مصادقة (authentication).
يخضع لـ rate limit عام وسخي. إذا قمت باستدعائه أكثر من بضع مرات في الثانية من نفس الـ IP، فتوقع تحديد السرعة (throttling).
يعكس الـ response الـ headers وعناوين IP فقط. لا يمكنه كشف الـ elite proxy الشفاف تماماً الذي يزيل جميع الـ proxy headers.