# الجلب الذكي (تلقائي)

> URL: https://foura.ai/ar/docs/guides/smart-fetch
> Updated: 2026-11-13
> Index: https://foura.ai/llms.txt

أنت تزوّد FourA بـ URL وقاعدة `validate` تحدد ما يجب أن تحتويه الصفحة الفعلية. يتولى FourA الباقي: يتدرج في سلم تصاعدي يراعي التكلفة، ويتوقف عند أول خطوة تُرجع response تقبله قواعدك، كما يتذكر ما نجح لكل host لضمان انخفاض تكلفة الاستدعاء التالي على الموقع نفسه.

يشرح هذا الدليل آلية عمل auto في الخلفية، ومتى يُنصح باستخدامه، وكيفية قراءة الـ response الخاص به. للاطلاع على مرجع المعلمات، راجع [API Endpoints](https://foura.ai/docs/api/endpoints#smart-fetch-auto).

## الفكرة

تفرض عليك أغلب إعدادات الـ scraping اختيار المحرك مسبقًا. يُعد Single الأسرع، بينما يضيف Proxy ميزة التدوير، ويتولى Browser التعامل مع JavaScript. إذا أخطأت التقدير، فستخسر رصيدك أو تتعرض للحظر.

يعكس Auto هذه الآلية تمامًا. أنت تحدد شروط النجاح (`validate`)، وليس الطريقة. يصعد FourA درجات السلم حتى تنجح إحداها:

1. **فحص منخفض التكلفة** (single، مباشرة من شبكة FourA الخاصة)
2. **Browser**، مباشرة من شبكة FourA الخاصة، مع تفعيل JavaScript و solver في حال فرض الموقع تحديات
3. **Single عبر rotated proxy**
4. **Browser عبر proxy** لأكثر الأهداف صعوبة

يتوقف Auto فور إرجاع إحدى الدرجات لـ response تقبله قاعدة `validate` الخاصة بك.

توجد خطوة واحدة خارج هذا الترتيب. عندما يصل مخرج الاتصال إلى الموقع لكن الموقع يرفض الـ URL العميق الذي طلبته، يجلب auto صفحة الدخول الرئيسية للموقع عبر نفس المخرج، ويحتفظ بملفات الـ cookie التي تمنحها صفحة الدخول، ثم يطلب الـ URL الخاص بك مرة أخرى باستخدامها. هذه هي خطوة `warmup`. يتم تشغيلها فقط على URL أعمق من جذر الموقع، وفقط بعد فشل المحاولة المباشرة، ولا يمكنها إلا تحسين النتيجة دون إفسادها.

القيمة الافتراضية لـ `forceProxy` هي `true`، لذا يتم تجاوز الدرجتين 1 و 2 ولا يرى الهدف أبدًا عنوان FourA الخاص. تنتهي معظم الاستدعاءات حينها عند الدرجة 3، أو عبر إعادة استخدام session نشطة سابقة. قم بتعيين `forceProxy: false` عندما تعلم أن الهدف يتعامل مع عنوان نقي ومباشر بشكل أفضل من العنوان المُدوّر، وستُتاح الدرجتان 1 و 2 مجددًا.

## ما ترسله

الحد الأدنى هو URL بالإضافة إلى سلسلة نصية فرعية لـ `validate`. يتعرف Auto على صفحات التحدي الشائعة تلقائيًا، ولكن بدون `validate.data.accept` لن يتمكن من التمييز بين صفحة فعلية وصفحة فحص لا يعرفها، أو صفحة جرى تحميلها دون المحتوى المطلوب، وقد يُرجع أيًا منهما كنجاح.

```bash
curl -X POST https://eu.api.foura.ai/api/auto/ \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/product/42",
    "validate": {"data": {"accept": ["Add to cart"]}}
  }'
```

إعدادات اختيارية (راجع [مرجع endpoint](https://foura.ai/docs/api/endpoints#smart-fetch-auto) للاطلاع على التفاصيل الكاملة):

- `returnSession` (القيمة الافتراضية `true`): إرجاع `{ proxy, cookies, userAgent }` الفائز حتى تتمكن من إعادة تشغيله.
- `forceProxy` (القيمة الافتراضية `true`): تخطي درجات direct-egress. عيّن `false` فقط إذا كنت تعلم أن الموقع يتعامل بشكل أفضل مع IP نظيف مقارنة بمخارج التدوير.
- `timeout_ms` (القيمة الافتراضية `120000`): إجمالي الوقت المتاح للطلب بالكامل. يقوم السلم بتوزيعه عبر الدرجات.
- `ignoreProxies`: معرفات proxy لتجنبها في كل محاولة فرعية.
- `followRedirects` (القيمة الافتراضية `5`): الحد الأقصى لعمليات إعادة التوجيه على الدرجات منخفضة التكلفة.
- `headers`: ترويسات لإرسالها إلى الموقع، كأزواج `[name, value]`. يتم إرسالها في طلبات Single وProxy، بما في ذلك البحث عن مخرج يعمل، ولا ترسلها درجات browser. يصل `Cookie` الخاص بك إلى الموقع دون تغيير، وتُضاف ملفات cookie الخاصة بالجلسة الدافئة بجانبه فقط تحت أسماء لم ترسلها. عندما تحتوي جلسة دافئة على `userAgent`، فإنها تستبدل `User-Agent` الخاص بك. يتم استبعاد الترويسات المشروطة مثل `If-None-Match` و`If-Modified-Since` من البحث عن المخرج ما لم يدرج `validate.status.accept` الخاص بك `304`.
- `exitClass`: يتيح `premium` لـ Auto الترقية إلى مخرج premium بمجرد تعذر وصول المجموعة القياسية إلى الصفحة؛ يشير `standard` إلى أنه لا يقوم بالترقية مطلقًا. يتطلب خطة تتضمن مخارج premium. راجع [exitClass على Smart Fetch](https://foura.ai/docs/api/endpoints#exitclass-on-smart-fetch).

## ما ستحصل عليه في المقابل

```json
{
  "status": 200,
  "data": "<!doctype html>...",
  "headers": [{"content-type": "text/html"}],
  "meta": {
    "rung": "cache",
    "solved": false,
    "attempts": 1,
    "credits": 2,
    "attemptsByEngine": {"single": 1, "proxy": 0, "browser": 0},
    "browserRequests": 0
  },
  "session": {
    "proxy": "A1B2C3",
    "cookies": [{"name": "session", "value": "abc", "domain": "example.com"}],
    "userAgent": "Mozilla/5.0..."
  }
}
```

ثلاثة عناصر يجب قراءتها:

- **`status` و`data`**: استجابة الهدف. `data` هو نص أياً كانت الدرجة التي خدمت الصفحة، لذا تصل صفحة JSON كنص JSON وتقوم بتحليله بنفسك. `status` هو كود حالة HTTP للهدف، وليس حالة النقل لمكالمتك إلى FourA. بالنسبة لدرجات single وproxy، يكون `headers` عبارة عن مصفوفة لكل قفزة (per-hop). بالنسبة لدرجات المتصفح، يكون `headers` كائناً مسطحاً.
- **`meta`**: أثر ما قام به السلم (ladder)، وهو موجود في كل استجابة بمجرد بدء السلم. يحدد `meta.rung` اسم الخطوة التي قدمت الاستجابة، ويحسب `meta.attempts` محاولات المكالمات الفرعية، ويحدد `meta.solved` ما إذا كانت صفحة التحدي قد اكتملت، و`meta.credits` هو إجمالي التكلفة للمكالمة (نفس الرقم في ترويسة `X-FourA-Credits`). يوضح `meta.attemptsByEngine` و`meta.browserRequests` ما أرسلته المكالمة: انظر [ما أنفقته المكالمة](#what-a-call-spent). عندما يحدد الطلب `exitClass`، يوضح `meta.exitClass` فئة الخروج التي قامت بالتسليم.
- **`session`**: ثلاثية `{ proxy, cookies, userAgent }` التي اخترقت الهدف. استخدمها لإعادة التشغيل مقابل نفس المضيف عبر `/api/single/` أو `/api/browser/`. يمكن أن يكون الحقل مفقوداً: الجلسة التي تم كسبها عبر جلب proxy عادي تحتوي على `proxy` ولكن بدون `userAgent`، وتحتوي قائمة `cookies` الخاصة بها فقط على ملفات تعريف الارتباط التي عينتها صفحة التحقق الخاصة بالموقع قبل أن يخدم الموقع الصفحة، لذلك غالباً ما تكون فارغة. الإجابة الواردة من الفحص المباشر الرخيص تحمل `session` فقط عندما تقوم صفحة التحقق هذه بتعيين ملفات تعريف الارتباط، وعندها تحتفظ بـ `cookies` فقط. الحالة التي تسردها `validate.status.accept` والتي أعادها مخرج (مثل `404` لصفحة محذوفة) لا تحتوي على `session` على الإطلاق.

يرد Auto بـ HTTP 200 كلما تم تشغيل السلم، حتى عندما تفشل كل درجة. اقرأ `status` و`error` في متن الاستجابة لمعرفة ما حدث، وليس كود حالة النقل. أي كود غير 200 من `/api/auto/` يعني أن المكالمة لم تصل أبداً إلى السلم: 401 لمفتاح غير صالح، 400 لمتن ليس بتنسيق JSON صالح، أو هدف على شبكة خاصة، أو هدف على مضيف API الخاص بـ FourA، أو URL يحتوي على مسافة غير مشفرة بداخله، و403 مع `X-FourA-Limit: plan_limit_premium` لـ `exitClass: premium` في خطة بدون مخارج متميزة، و502 أو 503 أو 504 عندما لا تتمكن الخدمة من قبول المكالمة أو نفد الوقت. لا يستهلك Auto أي مساحة في البوابة، لذا فإن الحدود المشتركة للمنصة لا ترفض المكالمة نفسها: عندما يرفض أحدها مكالمة أجراها السلم، تكون الإجابة HTTP 200 مع `status: 429` أو `503` و`retryAfter` في متن الاستجابة. الحقل الذي يفشل في التحقق من صحته يعود أيضاً كـ HTTP 200، مع `status: 400`. حد الخطة الذي يتم الوصول إليه داخل السلم يعود أيضاً كـ HTTP 200، مع وجود الرفض في متن الاستجابة (انظر [عندما تلتقي حدود خطتك بالسلم](#when-your-plans-limits-meet-the-ladder)).

## إعادة التشغيل باستخدام الجلسة

بعد أن يعيد auto جلسة، يمكنك الانتقال مباشرة إلى Single أو Browser للصفحات اللاحقة على نفس المضيف. لا صعود جديد في السلم، ولا فحص جديد.

```python
import requests

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

# 1) First call: let auto figure it out.
r = requests.post(f"{API}/api/auto/", headers=H, json={
    "url": "https://example.com/product/42",
    "validate": {"data": {"accept": ["Add to cart"]}},
}).json()

session = r.get("session") or {}
proxy = session.get("proxy")
user_agent = session.get("userAgent")

# 2) Follow-up pages: replay through single with the same proxy, UA and cookies.
for sku in ("43", "44", "45"):
    body = {"method": "GET", "url": f"https://example.com/product/{sku}"}
    if proxy:
        body["proxy"] = proxy
    headers = []
    if user_agent:
        headers.append(["User-Agent", user_agent])
    if session.get("cookies"):
        headers.append(["Cookie", "; ".join(f"{c['name']}={c['value']}" for c in session["cookies"])])
    if headers:
        body["headers"] = headers
    r = requests.post(f"{API}/api/single/", headers=H, json=body).json()
    print(sku, r["status"])
```

تعتمد متانة الجلسة كليا على الموقع الهدف. بعض المواقع تربط التصريح بملفات cookie لساعات، بينما يقوم البعض الآخر بتدويره كل بضع دقائق. إذا بدأ إعادة التشغيل في مواجهة تحديات مجددا، استدع `/api/auto/` مرة أخرى للتحديث.

## حالات استخدام Auto

| استخدام auto | استخدام single أو proxy أو browser يدويا |
|----------|----------------------------------------|
| تستهدف موقعا جديدا ولا تعرف متطلباته | تعرف مسبقا المحرك المناسب |
| تريد استدعاء واحدا يتولى التبديل بين proxy وbrowser تلقائيا | تريد تحكما كاملا في محاولات الإعادة والمهلات لكل استدعاء |
| لا تمانع استهلاك بضع ثوان في الفحص خلال الاستدعاء الأول | زمن وصول الاستدعاء الأول أهم من الاكتشاف |
| تريد جلسة مكتسبة لإعادة استخدامها بتكلفة منخفضة | تقوم بتحسين حلقة تكرار ضيقة على هدف معروف ومجرب |

ليس Auto الخيار الأقل تكلفة دائما. إذا كنت تعلم أن الهدف يعمل مع `single` + `unblocker`، فإن استدعاء Single مباشرة يستهلك 2 رصيد مع زمن وصول متوقع. استخدام Auto على الهدف نفسه سيكلف ما يستهلكه التدرج، وهو ما قد يزيد إذا تطلب الموقع تصعيدا.

## يحدد Validate لـ Auto معنى "النجاح"

المعلمة الأكثر أهمية هي `validate`. بدونها، يرفض auto صفحات التحدي التي يتعرف عليها فقط، مما يجعل أي صفحة فحص غير مألوفة أو هيكلا فارغا يتم إرساله برمز HTTP 200 يمر كأنه محتوى سليم.

استخدم `validate.data.accept` مع سلسلة نصية فرعية لا تظهر إلا في الصفحة الحقيقية:

```json
{
  "validate": {
    "data": {
      "accept": ["sku-42-add-to-cart", "Customer reviews"]
    }
  }
}
```

بالنسبة لـ JSON APIs، اقبل اسم حقل تتوقعه:

```json
{
  "validate": {
    "data": { "accept": ["\"products\":["] },
    "status": { "accept": [200] }
  }
}
```

بالنسبة للمواقع التي تُرجع استجابات غير 200 بشكل مشروع (مثل قيود جغرافية ترغب في تجاهلها، أو `404` أو `410` لصفحة محذوفة)، اسمح بها عبر `validate.status.accept`:

```json
{
  "validate": {
    "status": { "accept": [200, 451] }
  }
}
```

يُرجع Auto أي حالة تحددها في `validate.status.accept` بمجرد أن تعيدها نقطة خروج وتجتاز باقي شروط قاعدتك. هناك أربع حالات تُستثنى من ذلك: `202` و`403` و`429` و`503`. يتعامل Auto مع هذه الحالات على أنها فحص من الموقع لمعرفة هوية المرسل، وبالتالي فإن نقطة الخروج التي تُرجع إحداها لا تنهي البحث، ويواصل السلم الصعود.

من دون `validate`، يعتمد auto افتراضيًا على "HTTP 200 = نجاح" لكل صفحة لا يتعرف عليها كصفحة تحدٍ، ولذلك لن يتمكن من رصد صفحة فحص غير مألوفة يعيدها الموقع برمز 200.

## قراءة `meta.rung` لفهم ما حدث

يُعد `meta.rung` إشارة التصحيح الأكثر إفادة. القيم:

- `probe`، حُلّت عبر request مباشر منخفض التكلفة. المسار الأقل تكلفة.
- `proxy`، تطلبت تدوير proxy للنجاح.
- `browser`، تطلبت معالجة كاملة عبر المتصفح، مع احتمال حل تحدٍ.
- `cache`، أعادت استخدام جلسة نشطة من استدعاء auto سابق. المسار الأقل تكلفة في الاستدعاءات المتكررة.
- `warmup`، قدم الموقع صفحة الدخول لكنه حجب الرابط العميق، لذلك جلب auto صفحة الدخول أولاً، واحتفظ بملفات cookie التي أصدرتها، ثم كرر الطلب باستخدامها. الجلسة التي يخزنها من هذه الدرجة غير مرتبطة بنقطة خروج واحدة، لذا تستقر الاستدعاءات اللاحقة على الدرجات الأقل تكلفة.
- `fail`، لم تُنتج أي درجة استجابة تقبلها قواعدك.

يعني `meta.solved: true` أنه تمت مواجهة صفحة تحدٍ وإكمالها أثناء الاستدعاء. ويمثل `meta.attempts` عدد محاولات الاستدعاءات الفرعية قبل النجاح. لمعرفة التفاصيل الكامنة وراء ذلك، راجع حقل `defense` الذي ترجعه درجات single وproxy: انظر [فحوصات الموقع](https://foura.ai/docs/api/site-checks).

إذا استمر موقع ما في الانتهاء عند `browser` بينما كنت تتوقع `probe`، فانظر فيما إذا كانت قاعدة `validate` أكثر صرامة (أو أقل صرامة) ستسمح لدرجة أقل تكلفة بالاجتياز. تذكر أن `forceProxy` مضبوط افتراضيًا على `true`، لذلك يتم تخطي فحص الخروج المباشر ما لم تقم بإيقاف تشغيله.

## ما استهلكه الاستدعاء

يحسب `meta.attemptsByEngine` الطلبات التي أرسلها الاستدعاء إلى كل محرك، وهي نفس الطلبات التي تعرضها لوحة محاولات Auto في صفحة [Overview](https://foura.ai/docs/dashboard/overview) الخاصة بك. ويحسب `meta.browserRequests` الطلبات التي استهلكت حصة من رصيد المتصفح اليومي المتاح لك.

```json
"meta": {
  "rung": "browser",
  "solved": true,
  "attempts": 7,
  "credits": 47,
  "attemptsByEngine": {"single": 1, "proxy": 4, "browser": 3},
  "browserRequests": 2
}
```

| الحقل | النوع | الوصف |
|-------|------|-------------|
| `meta.attemptsByEngine` | object | الطلبات المرسلة إلى `single` و`proxy` و`browser`. يُحتسب طلب المتصفح الذي رفضته خطتك هنا، لأنه قد تم إرساله بالفعل. |
| `meta.browserRequests` | number | طلبات المتصفح التي استهلكت حصة من رصيدك اليومي المسموح به. طلب المتصفح الذي رفضته خطتك لا يستهلك أي رصيد. |

`meta.attempts` يحسب خطوات التدرج، لذا لا يساوي دائمًا مجموع `meta.attemptsByEngine`. يمكن لخطوة واحدة أن ترسل طلب Single ثم طلب Proxy، والخطوة التي تم إغلاق متصفحها بالفعل لهذا اليوم لا ترسل أي شيء.

يتم تمرير عددك التراكمي لليوم في ترويسات `X-FourA-Browser-Used-Today` و`X-FourA-Browser-Limit-Per-Day`: راجع [Response Headers](https://foura.ai/docs/api/response-headers).

## الأخطاء والحالات الخاصة

عند فشل auto، يحمل الـ response القيمة `status` (عادةً حالة آخر خطوة متدرجة فشلت) وسلسلة نصية `error`:

```json
{
  "status": 502,
  "error": "could not find a working exit for the target",
  "attempts": 7,
  "attemptReport": {
    "total": 7,
    "noResponse": 5,
    "defense": 2,
    "contentRejected": 0,
    "statusRejected": 0,
    "other": 0,
    "vendors": ["datadome"],
    "summary": "7 attempt(s): 5 got no answer from the site; 2 refused by the site (datadome)"
  },
  "meta": {
    "rung": "fail",
    "solved": false,
    "attempts": 7,
    "credits": 47,
    "attemptsByEngine": {"single": 0, "proxy": 4, "browser": 3},
    "browserRequests": 3
  }
}
```

`status` هو استجابة الموقع في المحاولة الأخيرة التي رفضها Auto، مثل `403`. عندما لا تحصل أي محاولة على استجابة من الموقع على الإطلاق، فعادة ما يكون ذلك `502` أو `504`، ويوضح `error` ما إذا كان لم يتم العثور على مخرج يعمل أو إذا نفدت ميزانية `timeout_ms`. يعني `status: 0` فقط أن اسم مضيف الهدف لم يُحل، وهذه الاستجابة لا تحتوي على `meta` لأن السلم لم يبدأ أصلًا.

يتوقف Auto مبكرًا أيضًا عندما يستمر متصفحه في مواجهة فحص لا يمكنه إكماله. بعد أن يرفض مخرجان المتصفح بتلك الطريقة ويُسفر البحث عن مخرج يجتاز جلبه العادي قاعدة `validate` الخاصة بك عن نتيجة فارغة، أو بعد ثلاثة مخارج من هذا النوع، ينتهي الاستدعاء. يحتوي `status` على آخر استجابة للموقع ويبدأ `error` بـ `the browser was refused by`، متبوعًا باسم نظام الفحص.

يتوقف Auto أيضًا عندما يذكر الموقع نفسه أن الصفحة غير موجودة. عندما يُرجع مخرجان نفس `404` أو `410` ولا تقبل قواعدك ذلك، ينتهي الاستدعاء برمز `status` هذا، ويبدأ `error` بـ `the site answered`. إذا كانت الصفحة المحذوفة استجابة مقبولة بالنسبة لك، فقم بإدراج `404` أو `410` في `validate.status.accept`: حيث يُرجعها Auto بعد ذلك كمسلّمة بمجرد أن يجلبها أي مخرج.

بعد انتهاء أربعة استدعاءات Auto متتالية باستخدام مفتاح API الخاص بك دون الحصول على الصفحة بسبب استمرار الموقع في الرفض، يتوقف Auto عن محاولة الوصول إلى هذا الموقع لمفتاحك لمدة 120 ثانية. وأي استدعاء له خلال هذا الوقت يستجيب على الفور بـ `status: 503`، و`error: "target temporarily unservable, retry later"`، و`retryAfter` بالثواني، ولا يكلف شيئًا. يُحسب ذلك لكل مفتاح API: لا تتأثر المفاتيح الأخرى التي تستدعي نفس الموقع، كما أن أي استدعاء ينجح في جلب الصفحة يعيد تعيين هذا العدد. الاستدعاء الذي يستخدم `exitClass: premium` لا يتم إيقافه بهذا الإجراء.

تحقق من `attemptReport` و`meta.attemptsByEngine` و`meta.credits` لمعرفة أين استُهلكت الميزانية. إذا كان `meta.attempts` مرتفعًا وكان `meta.rung` هو `fail` بعد مرحلة المتصفح، فقد يحتاج الهدف إلى `timeout_ms` أطول، أو قاعدة `validate` أكثر صرامة، أو ببساطة لا يمكن الوصول إليه عبر البروكسيات الدوّارة في الوقت الحالي.

### سبب فشل استدعاء Auto

تحمل كل استجابة فاشلة من سلم تم تنفيذه `attemptReport`. وهو يحسب طلبات المحرك التي عادت بدون الصفحة، كل طلب مرة واحدة، وفقًا لما واجهه.

| الحقل | النوع | الوصف |
|-------|------|-------------|
| `total` | integer | عدد الطلبات التي عادت دون الصفحة. على الأكثر مجموع `meta.attemptsByEngine`، لأن طلب المتصفح الذي رفضته خطتك لم يحاول الاتصال بالهدف إطلاقا. |
| `noResponse` | integer | لم يتم تلقي أي رد من الموقع |
| `defense` | integer | رفض الموقع الطلب: تم التعرف على فحص bot، أو كانت الصفحة عبارة عن اختبار تحقق، أو استجاب الموقع بالرموز 401، 403، 429 أو 503 |
| `contentRejected` | integer | تم جلب الصفحة ولكن قاعدة `validate` الخاصة بك وحدها هي التي رفضتها |
| `statusRejected` | integer | استجاب الموقع برمز حالة لا يقبله طلبك، مثل 404 لصفحة محذوفة |
| `other` | integer | فشل لسبب آخر، مثل خطأ في الخادم |
| `vendors` | string[] | مزودو فحص bot الذين تم التعرف عليهم عند حالات الرفض التي واجهها الاستدعاء |
| `summary` | string | جملة واحدة تم إنشاؤها من الأعداد، وهي آمنة للتسجيل في السجلات. تذكر رمز حالة HTTP الذي استجاب به الموقع عندما لا يتم التعرف على أي مزود، وتوضح متى استنفد رصيدك اليومي من المتصفح، بحيث تعذر فتح أي متصفح. |

تتطابق الحقول مع تقرير استدعاء [Proxy](https://foura.ai/docs/troubleshooting/proxy-attempt-report) الفاشل، دون `profilesTried`. ويوجد اختلافان: يحسب Proxy كل نقطة خروج تمت تجربتها، حتى حد `maxTries` الذي حددته، بينما يحسب Auto طلباته الخاصة. يقرأ Auto أيضا الصفحة وحالتها، وبالتالي يُحسب الرفض ضمن `defense` حتى عند عدم التعرف على أي مزود. والعدد المسجل ضمن `contentRejected` هو الذي يمكنك إصلاحه بنفسك: عادت الصفحة ولكن قاعدتك لم تتطابق معها.

### عندما تتلاقى حدود خطتك مع السلم

تعد استدعاءات Auto الفرعية طلبات Single وProxy وBrowser عادية تحت مفتاحك، لذا تنطبق عليها [حدود خطتك](https://foura.ai/docs/api/rate-limits). يقرأ السلم رمز `X-FourA-Limit` عند حدوث رفض ويتعامل مع النوعين بشكل مختلف.

**الدرجة المغلقة تترك بقية السلم قابلا للاستخدام.** يغلق كل من `plan_limit_browser_daily` (استنفاد طلبات Browser اليومية الخاصة بك) و`plan_limit_concurrency` (تجاوز هذا الـ endpoint لعدد الطلبات قيد التشغيل المسموح به في الخطة) درجة واحدة. يواصل Auto تشغيل الدرجات الأخرى، بحيث تستمر في الحصول على الصفحة متى ما وفرت نقطة خروج دورية أو جلسة نشطة المحتوى المطلوب، ولا تُحمَّل نقاط الخروج المجربة مسؤولية الرفض الناجم عن خطتك نفسها. لا يتم حظر أي شيء ولا يتم التخلص من أي جلسة.

**الحساب المستنفد يوقف السلم بالكامل.** لا يمكن للدرجات الأخرى معالجة `plan_limit_credits` و`plan_limit_bandwidth` و`plan_limit_rate` و`plan_limit_feature` و`plan_limit_premium`، لذلك يعود Auto على الفور بدلا من إنفاق المزيد من أرصدتك لإثبات ذلك. يعود الرفض في الـ body مع حالة الاستدعاء الفرعي وحقل `reason` نفسه الذي تستخدمه نقاط النهاية المباشرة:

```json
{
  "status": 429,
  "error": "Credit limit reached: 300,000 of 300,000 credits used this billing period. Upgrade your plan or wait for the reset.",
  "reason": "plan_limit_credits",
  "documentation": "https://foura.ai/prices",
  "used": 300000,
  "hard_stop": 300000,
  "retry_after_seconds": 86400,
  "resets_at": "2026-10-01T00:00:00.000Z",
  "meta": { "rung": "fail", "solved": false, "attempts": 1, "credits": 0 }
}
```

يصل نص الرفض الكامل من الاستدعاء الفرعي، بالإضافة إلى `status` و`attemptReport` و`meta`. اقرأ `status` من نص الاستجابة وليس من حالة النقل: يظل وضع auto يُرجع رمز HTTP 200 هنا، لأن خطوات السلم قد نُفذت. كما يصل رفض `plan_limit_feature` أو `plan_limit_premium` بالطريقة نفسها مصحوبا بـ `status: 403`. لا يستهلك الاستدعاء الفرعي المرفوض أي رصيد، لذا يحسب `meta.credits` فقط الدرجات التي وصلت فعليا إلى الهدف.

يمكن لاستدعاء auto واحد حجز عدة منافذ أثناء تدرجه في السلم، لذا فإن دفعة متوازية من استدعاءات auto قد تصل إلى الحد الأقصى للتزامن بعدد استدعاءات أقل مما تتوقع. يشرح [تشغيل الطلبات بالتوازي](https://foura.ai/docs/how-to/run-requests-in-parallel) كيفية تحديد حجم الدفعة.

## ما لا يقوم به Auto

- لا يغير القيود القانونية. إذا رفض موقع كل نقاط الخروج التي يمكن لـ FourA الوصول إليها، يُرجع auto هذا الرفض.
- لا يُخزن المحتوى مؤقتا. كل استدعاء يصل مباشرة إلى الهدف. تعني "الجلسة النشطة" الـ proxy وملفات cookie، وليس الـ response.
- يظهر كصف واحد في [سجل النشاط](https://foura.ai/docs/dashboard/activity-log)، تحت معرف الطلب الذي استلمته، مع مجموع أرصدة استدعاءاته الفرعية. عند فتحه، ستجد الاستدعاءات الفرعية من نوع Single / Proxy / Browser التي أجراها auto نيابة عنك مدرجة كمحاولات، ولكل منها نتيجتها الخاصة. تُحسب هذه المحاولات ضمن حدود Single وProxy وBrowser الخاصة بك، ولا تُحسب أبدا ضمن إجمالي عدد الطلبات أو معدل النجاح.

## مواضيع ذات صلة

- [نقاط نهاية API](https://foura.ai/docs/api/endpoints#smart-fetch-auto): مرجع المعلمات الكامل
- [اختيار نقطة النهاية المناسبة](https://foura.ai/docs/guides/choosing-task-type): متى تختار auto مقابل single أو proxy أو browser
- [نتائج الطلبات](https://foura.ai/docs/api/outcomes): تحديد النتائج الخاضعة للاحتساب
- [المواقع المحمية](https://foura.ai/docs/guides/protected-sites): ما يفعله FourA في المواقع التي تتحقق من هوية الطالب
- [فحوصات الموقع](https://foura.ai/docs/api/site-checks): حقل `defense` المستند إليه في `meta.solved`
- [وصفات MCP](https://foura.ai/docs/mcp/recipes): الأنماط نفسها كاستدعاءات أدوات MCP
- [حدود المعدل](https://foura.ai/docs/api/rate-limits): حدود الخطة التي تُقاس وفقها استدعاءات auto الفرعية
