فحص 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` أو `none`
`anonymityLevel`	string	إحدى القيم: `transparent` أو `anonymous` أو `none`
`confidence`	string	مستوى موثوقية الكشف: `high` أو `medium` أو `low`
`detectedHeaders`	string[]	أسماء الـ headers التي أشارت إلى وجود proxy (مثل `via`، `forwarded`)
`explanation`	string	ملخص للنتيجة باللغة الطبيعية

`proxyChain`

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

أنواع الـ Proxy

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

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

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

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

القيود

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