فحوصات الموقع

عندما يُجري الهدف فحص bot في الطريق إلى الصفحة المطلوبة، يُخطرك FourA بذلك. كل request يواجه فحصًا يعود بحقل يحدد اسم النظام، وما إذا تم تجاوز الفحص، و(عند التجاوز بنجاح) بيانات clearance التي يمكنك إعادة إرسالها ليتخطاها الاستدعاء التالي.

هذه الصفحة هي المرجع لتلك الحقول. لمعرفة الاستراتيجية، راجع المواقع المحمية.

مكان وجود الحقل

Endpoint الحقل يظهر عندما
POST /api/single/ defense (object) يتم التعرف على فحص bot في الـ response
POST /api/proxy/ defense (object) الأمر نفسه، تُبلِغ عنه المحاولة التي استجابت
POST /api/browser/ defenseSolved (boolean) و defenses (object) دائمًا، في الصفحة التي تم تحميلها. يكون defenseSolved بقيمة false ويكون defenses فارغًا عند عدم التعرف على أي شيء.
POST /api/auto/ meta.solved (boolean) في كل إجابة بمجرد بدء ladder. تكون القيمة true عند تجاوز فحص في مرحلة ما ضمن ladder. الـ body الذي يفشل في التحقق أو المضيف الذي يتعذر حله يتم الرد عليهما قبل ladder، دون meta.

غياب الحقل يعني أنه لم يتم التعرف على أي شيء. لا تعتبر غياب defense بمثابة فشل.

في Single و Proxy، يتطلب إرسال التقارير تفعيل unblocker، وهو مفعّل افتراضيًا. مع unblocker: false، تكون قد طلبت الصفحة تمامًا كما وردت، لذا يُعيد Single التحدي دون تعديل ويعرضه Browser دون حله.

defense في Single و Proxy

{
  "status": 200,
  "data": "<!doctype html>...",
  "total_time": 3.61,
  "defense": {
    "vendor": "sgcaptcha",
    "solved": true,
    "present": ["sgcaptcha"],
    "ms": 3412,
    "hashes": 1048576,
    "complexity": 20,
    "cookie": "_I_=<clearance>"
  }
}
الحقل النوع الوصف
vendor string النظام الذي يخصه هذا السجل: النظام الذي تم تجاوزه، أو النظام الرئيسي الذي تمت مواجهته. راجع قائمة المزودين أدناه.
solved boolean تعني true أنه تم تجاوز الفحص وأن data هي الصفحة الحقيقية. تعني false أن data قد تكون صفحة التحدي.
present string[] كل نظام تم التعرف عليه في هذه الـ response. يمكن أن يحتوي على أسماء أكثر من vendor، ويمكن أن يتضمن أسماء لا يتجاوزها أحد بعد.
ms number عدد الأجزاء من الثانية المستغرقة في تجاوز الفحص. تظهر فقط عند التجاوز الناجح.
hashes number مقدار الجهد الحسابي الذي طلبه التحدي. تظهر فقط عند التجاوز الناجح.
complexity number مستوى الصعوبة الذي أعلنه التحدي. تظهر فقط عند التجاوز الناجح، وفقط عندما يبلغ التحدي عن ذلك.
answers number عدد الإجابات المقبولة المقدمة، وذلك للتحديات التي تطلب إجابات متعددة بدلا من إجابة واحدة. تظهر فقط عند التجاوز الناجح.
retry string تكون موجودة عندما تأتي الـ body من إعادة محاولة بدلا من تجاوز ناجح: refusal-cookies أو amazon-continue أو reddit-js-check أو verify-challenge. انظر أدناه.
cookie string الـ jar المطلوب إعادة تشغيله: التصريح الذي تم الحصول عليه عبر التجاوز، أو الجلسة الناتجة عن الرفض.

الحالة solved: false هي التي تستحق التفريع البرمجي بناء عليها. لا تقدم FourA أبدا صفحة تحد كـ content، لذا فإن هذا الـ flag هو إشارتك إلى أن الـ body تتطلب تصعيدا بدلا من إجراء parsing.

retry: "refusal-cookies"

بعض المواقع لا تشغل لغزا. بل ترفض الـ request الأول، وتعين cookies مع الرفض، ثم تقدم الصفحة الحقيقية لأي طرف يعيد إرسال هذه الـ cookies. وتعد صفحات المنتجات في eBay هي الحالة المرجعية لذلك.

عند حدوث ذلك، تقوم FourA بإعادة إرسالها نيابة عنك وتسليمك الصفحة. وعندئذ تحمل الـ response القيمة retry: "refusal-cookies":

{
  "status": 200,
  "data": "<!doctype html>...",
  "defense": {
    "vendor": "akamai",
    "solved": false,
    "present": ["akamai"],
    "retry": "refusal-cookies",
    "cookie": "bm_sv=...; dp1=..."
  }
}

اقرأها على النحو التالي:

  • solved يظل false. الرد على المصافحة ليس تجاوزا لاختبار التحقق، ولا يغير أبدا تكلفة الاستدعاء. تتم محاسبتك على الطلب الذي أجريته.
  • data هو محتوى حقيقي، وليس صفحة اختبار تحقق. هذه هي الحالة الوحيدة التي لا يعني فيها solved: false أن نص الاستجابة يحتاج إلى تصعيد، ولهذا السبب يوجد هذا الحقل.
  • cookie هي الجلسة التي سلمها الموقع. أعد إرسالها بالطريقة نفسها التي تعيد بها إرسال التصريح وستتخطى الصفحات اللاحقة الرفض.
  • يمكن أن تحدث إعادة المحاولة والتجاوز معا في طلب واحد. إذا تبين أن إجابة إعادة المحاولة كانت اختبار تحقق يمكن لـ FourA تجاوزه، فستحصل على solved: true مع حقول المزود الخاصة و retry: "refusal-cookies" بجانبها.

تكون قيمة vendor هي unknown عندما ينتج عن إعادة المحاولة الحصول على المحتوى دون التعرف على أي نظام أثناء ذلك. وتكون present حينئذ مصفوفة فارغة.

retry: "amazon-continue"

يرد Amazon أحيانا باختبار روبوت ذي زر واحد: صفحة صغيرة تطلب منك النقر لمتابعة التسوق، مع تعبئة الإجابة مسبقا. عند تفعيل unblocker (الوضع الافتراضي)، يضغط Single وProxy على هذا الزر من منفذ الخروج نفسه، داخل timeout_ms الخاص بك، ويطلبان صفحتك مرة أخرى مع ملفات تعريف الارتباط التي جرى تعيينها. وعندما يؤدي ذلك إلى فتح الصفحة، تتضمن الاستجابة retry: "amazon-continue":

{
  "status": 200,
  "data": "<!doctype html>...",
  "defense": {
    "vendor": "akamai",
    "solved": false,
    "present": ["akamai", "amazon"],
    "retry": "amazon-continue",
    "cookie": "ak_bmsc=...; ..."
  }
}

تعامل معها كإعادة محاولة لملفات تعريف الارتباط المرفوضة (refusal-cookies). يبقى solved بقيمة false، وdata هي الصفحة الحقيقية، وتتم محاسبتك على الـ request الذي أرسلته، وcookie هي الحاوية لإعادة استخدامها في الصفحات التالية. ابحث عن amazon في present بدلاً من vendor: غالباً ما تُعيّن صفحة التحقق cookie يتعرف عليه FourA أيضاً، ويُحدد vendor النظام الأول في القائمة.

تتم الإفادة عن النسخة الصورية من التحقق نفسه، حيث يتعين على شخص قراءة الإجابة، وتُترك كما وردت. وينطبق الأمر نفسه على النقرة التي تُعيد صفحة التحقق فقط. في كلتا الحالتين، لا تتم فوترة تلك الصفحة (راجع التكلفة).

retry: "reddit-js-check"

يرد Reddit أحياناً باختبار تحقق خفيف للصفحة: صفحة صغيرة تحتوي على نموذج مخفي وسكربت يملأ هذا النموذج. عند تفعيل unblocker (وهو الوضع الافتراضي)، يُرسل Single وProxy هذا النموذج عبر نقطة الخروج نفسها، ضمن timeout_ms الخاص بك، ويطلبان صفحتك مجدداً باستخدام الـ cookies التي تم تعيينها. وعندما يفتح ذلك الصفحة، يحمل الـ response القيمة retry: "reddit-js-check":

{
  "status": 200,
  "data": "<!doctype html>...",
  "defense": {
    "vendor": "reddit",
    "solved": false,
    "present": ["reddit"],
    "retry": "reddit-js-check",
    "cookie": "edgebucket=...; ..."
  }
}

تعامل معها كإعادة محاولة amazon-continue. يبقى solved هو false، وdata هي الصفحة الحقيقية، وتتم محاسبتك على الـ request الذي أجريته، وcookie هي الحاوية لإعادة استخدامها في الصفحات التالية. عندما يستمر الفحص في الظهور، تترك FourA الصفحة كما وردت، ولا تتم محاسبتك على تلك الصفحة.

retry: "verify-challenge"

تفتح بعض المواقع بصفحة فحص قصيرة خاصة بها: مؤشر تحميل ونمط برمجي (script) ينقلك إلى الصفحة بمجرد اكتمال الفحص. مع تفعيل unblocker (الوضع الافتراضي)، يكمل Single وProxy هذا الفحص عبر نفس نقطة الخروج، داخل timeout_ms الخاص بك، ويطلبان صفحتك مرة أخرى مع الـ cookie التي تم تعيينها. عندما يفتح ذلك الصفحة، يتضمن الـ response ترويسة retry: "verify-challenge":

{
  "status": 200,
  "data": "<!doctype html>...",
  "defense": {
    "vendor": "verify-challenge",
    "solved": false,
    "present": ["verify-challenge"],
    "retry": "verify-challenge",
    "cookie": "token=..."
  }
}

تعامل معها كإعادة محاولة reddit-js-check. يبقى solved هو false، وdata هي الصفحة الحقيقية، وتتم محاسبتك على الطلب الذي أجريته، وcookie هو الوعاء الذي يُعاد استخدامه في الصفحات اللاحقة. عندما تعود صفحة التحقق دون إجابة، لا تتم محاسبتك عليها.

defenses على Browser

{
  "status": 200,
  "body": "<!doctype html>...",
  "userAgent": "Mozilla/5.0...",
  "defenseSolved": true,
  "defenses": {
    "present": ["cloudflare"],
    "cleared": ["cloudflare"]
  }
}
الحقل النوع الوصف
defenseSolved boolean true عند مواجهة نظام أثناء التحميل والاحتفاظ بتصريحه (clearance) في الصفحة النهائية. هذه هي الراية (flag) التي تحدد ما إذا كان الاستدعاء يكلف 5 أو 10 أرصدة.
defenses.present string[] كل نظام تم التعرف عليه في أي مرحلة أثناء تحميل الصفحة، وليس فقط في الاستجابة النهائية. الفحص هو حدث وقع بالفعل، وبحلول وقت وصول الصفحة الحقيقية تكون استجابة التحدي قد انتهت منذ فترة طويلة.
defenses.cleared string[] الأنظمة التي تحتفظ الصفحة النهائية بتصريحها (clearance).

الاسم الموجود في present والذي لا يصل مطلقًا إلى cleared يمثل نظامًا تعرف عليه FourA دون الحصول على تصريح له: إما نظام لا يمكنه إكماله بعد، أو أحد الأنظمة القليلة التي يتعامل معها Browser بطريقة أخرى (راجع ما يتم تجاوزه اليوم). هذه الحالات لا ترفع تكلفة الاستدعاء أبدًا.

الموردون

قيمة vendor النظام
cloudflare تحديات Cloudflare وإدارة البوتات
sgcaptcha فحص الموقع الخاص بـ SiteGround
datadome DataDome
perimeterx PerimeterX
akamai Akamai Bot Manager
incapsula Imperva Incapsula
awswaf تحدي AWS WAF
ebay-splashui التحدي الخاص بـ eBay
reddit صفحات الفحص والرفض الخاصة بـ Reddit
verify-challenge صفحة فحص خاصة بموقع تقوم بتحويلك بمجرد اكتمال الفحص
amazon فحص الروبوت الخاص بـ Amazon
hcaptcha hCaptcha
recaptcha reCAPTCHA
unknown لم يتم التعرف على أي نظام. يظهر فقط بجانب retry، حيث يوجد السجل للإبلاغ عن إعادة المحاولة بدلاً من مورد محدد.

ما يتم تجاوزه اليوم

Endpoint ما يتم تجاوزه
Single, Proxy sgcaptcha، وebay-splashui. كلاهما حسابي وليس مرئيًا، لذا لا يتم استخدام متصفح.
Browser cloudflare، وsgcaptcha

تتم معالجة بعض الحالات الإضافية دون تصريح (clearance). يضغط Single وProxy على زر فحص الروبوت ذي الزر الواحد من Amazon ويبلغان عنه كـ retry: "amazon-continue"، ويرسلان فحص صفحة Reddit الخفيفة ويبلغان عنه كـ retry: "reddit-js-check"، ويكملان صفحة الفحص الخاصة بالموقع ويبلغان عنها كـ retry: "verify-challenge". ينتظر Browser ما يصل إلى 10 ثوانٍ حتى تقوم صفحة الفحص نفسها بتحويله. يضغط Browser على زر Amazon، وينتظر بينما تقوم صفحة مستشعر Akamai، أو صفحة تحدي AWS WAF، أو فحص جهاز DataDome، أو صفحة التحدي الخاصة بـ eBay بتحميل الصفحة التالية تلقائيًا، ثم يعيد تلك الصفحة. إذا لم تصل تلك الصفحة مطلقًا، يعيد Browser الصفحة التي كان يحتفظ بها داخل timeout_ms الخاص بك. في Browser، تظهر هذه الأسماء في defenses.present، ولا تظهر مطلقًا في cleared، وتكون تكلفة الاستدعاء 5 أرصدة.

كل ما عدا ذلك في القائمة يتم التعرف عليه والإبلاغ عنه فقط، دون أي إجراء إضافي. هذا التقسيم يتغير مع تعلم FourA كيفية تجاوز المزيد منها، لذا اقرأ solved بدلاً من الافتراض بناءً على هذا الجدول.

ملاحظتان حول الحالات الاستثنائية:

  • يُعد كل من hcaptcha و recaptcha أيضاً عناصر نماذج عادية. لا يتم الإبلاغ عنهما إلا عندما يحظرك الـ response فعلياً (403 أو 429 أو 503)، وبالتالي فإن صفحة الدفع التي تحتوي على أداة تحقق داخل نموذج لا تبلغ عن وجود دفاع.
  • التواجد خلف Cloudflare لا يُعد دفاعاً. يظهر cloudflare عندما يكون هناك تحدٍ حقيقي أو عنصر إدارة روبوتات في الـ response، وليس لمجرد أن الموقع يستخدم Cloudflare.

إعادة تشغيل الـ Clearance

defense.cookie هو الهدف الأساسي من هذا الحقل. يرتبط الـ clearance بـ exit الذي حصل عليه وبـ User-Agent الذي حصل عليه، لذا أعد تشغيله عبر نفس الزوج ولن يتم تشغيل الفحص مرة أخرى.

import requests

API = "https://eu.api.foura.ai"
H = {"X-API-Key": "YOUR_API_KEY", "Content-Type": "application/json"}

# 1) First call pays for the clear.
first = requests.post(f"{API}/api/proxy/", headers=H, json={
    "maxTries": 5,
    "request": {"method": "GET", "url": "https://example.com/catalog"},
}).json()

defense = first.get("defense", {})
if defense.get("solved"):
    clearance = defense["cookie"]
    exit_id = first["proxy"]

    # 2) Follow-up pages skip the check: same exit, same clearance.
    for page in range(2, 6):
        r = requests.post(f"{API}/api/single/", headers=H, json={
            "method": "GET",
            "url": f"https://example.com/catalog?page={page}",
            "proxy": exit_id,
            "headers": [["Cookie", clearance]],
        }).json()
        print(page, r["status"])

يحمل الاستدعاء الأول تكلفة التخطي. وتعد كل إعادة تشغيل (replay) مجرد request عادي بالتكلفة العادية.

هناك ثلاثة أمور تبطل إعادة التشغيل (replay):

  1. اختلاف منفذ الخروج (exit). قم بتثبيت proxy ID الذي أرجعه response التخطي. راجع إعادة استخدام Proxy عبر الـ Requests.
  2. اختلاف User-Agent. ترجع Browser responses قيمة userAgent التي استخدمتها. أعد إرسالها مع cookie.
  3. انتهاء الصلاحية. تمتلك عمليات التخطي فترات صلاحية خاصة بها يحددها الهدف. تستمر صلاحية SiteGround لنحو 30 يوما للموقع بأكمله، بينما تكون صلاحية تخطي Cloudflare عادة أقصر بكثير. تعامل مع التخطي كذاكرة تخزين مؤقت (cache): عندما تبدأ عمليات replay في إرجاع تحديات مجددا، نفذ استدعاء جديدا واحدا واستخدم التخطي الجديد.

التكلفة

يغير الفحص الذي تم تخطيه التكلفة على Browser فقط:

Engine Base Cleared defense
Single 1 (2 مع unblocker) بدون تغيير
Proxy 2 (4 مع unblocker) بدون تغيير
Browser 5 10

يحتسب Browser تكلفة 10 فقط عند تفعيل أداة الحل وتخطي النظام بنجاح. أما النظام الذي تم التعرف عليه دون تخطيه فتبلغ تكلفته 5، وهو ما يعادل صفحة لا تحتوي على أي فحص على الإطلاق.

أي صفحة فحص أو صفحة رفض يتعرف عليها FourA ويتم تقديمها مع رمز الاستجابة HTTP 200 (مثل فحص الروبوت في Amazon أو صفحة التحقق في Reddit أو صفحة التحدي في eBay) لا يتم احتساب تكلفتها على أي endpoint. وتذكر Single وProxy وBrowser responses ذلك في X-FourA-Check-Page.

استخدمه مع validate

يوضح لك defense أنه تمت مواجهة فحص. بينما يوضح validate لـ FourA شكل الصفحة الحقيقية، وهو ما يتيح للـ request أن يفشل بدلا من تسليمك صفحة بينية تصادف أنها تحمل الرمز HTTP 200.

{
  "method": "GET",
  "url": "https://example.com/product/42",
  "validate": {
    "data": {"accept": ["Add to cart"], "fail": ["Just a moment"]}
  }
}

في POST /api/auto/، فإن validate هو ما يمنع مسار التدرج من قبول صفحة التحدي واعتبار العملية مكتملة.

آخر تحديث: 11 نوفمبر 2026