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

> URL: https://foura.ai/ar/docs/api/site-checks
> Updated: 2026-11-11
> Index: https://foura.ai/llms.txt

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

هذه الصفحة هي المرجع لتلك الحقول. لمعرفة الاستراتيجية، راجع [المواقع المحمية](https://foura.ai/docs/guides/protected-sites).

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

| 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

```json
{
  "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"`:

```json
{
  "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"`:

```json
{
  "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` النظام الأول في القائمة.

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

### `retry: "reddit-js-check"`

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

```json
{
  "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"`:

```json
{
  "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

```json
{
  "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 بطريقة أخرى (راجع [ما يتم تجاوزه اليوم](#what-gets-cleared-today)). هذه الحالات لا ترفع تكلفة الاستدعاء أبدًا.

## الموردون

| قيمة `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 الذي حصل عليه، لذا أعد تشغيله عبر نفس الزوج ولن يتم تشغيل الفحص مرة أخرى.

```python
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](https://foura.ai/docs/how-to/reuse-a-proxy).
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.

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

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

## ذات صلة

- [المواقع المحمية](https://foura.ai/docs/guides/protected-sites): المحرك المناسب لكل مستوى حماية
- [نقاط نهاية API](https://foura.ai/docs/api/endpoints): مرجع الـ request والـ response لجميع نقاط النهاية الأربع
- [إعادة استخدام Proxy عبر طلبات متعددة](https://foura.ai/docs/how-to/reuse-a-proxy): تثبيت نقطة الخروج المرتبطة بتصريح المرور
- [الجلب الذكي (تلقائي)](https://foura.ai/docs/guides/smart-fetch): كيف يتكامل `meta.solved` مع مسار التدرج
- [ترويسات Response](https://foura.ai/docs/api/response-headers): أين تظهر تكلفة الرصيد لكل استدعاء
