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

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

يشرح هذا الدليل آلية عمل auto في الخلفية، ومتى يُنصح باستخدامه، وكيفية قراءة الـ response الخاص به. للاطلاع على مرجع المعلمات، راجع API Endpoints.

الفكرة

تفرض عليك أغلب إعدادات الـ 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 لن يتمكن من التمييز بين صفحة فعلية وصفحة فحص لا يعرفها، أو صفحة جرى تحميلها دون المحتوى المطلوب، وقد يُرجع أيًا منهما كنجاح.

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 للاطلاع على التفاصيل الكاملة):

  • 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.

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

{
  "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 ما أرسلته المكالمة: انظر ما أنفقته المكالمة. عندما يحدد الطلب 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، مع وجود الرفض في متن الاستجابة (انظر عندما تلتقي حدود خطتك بالسلم).

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

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

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 مع سلسلة نصية فرعية لا تظهر إلا في الصفحة الحقيقية:

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

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

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

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

{
  "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: انظر فحوصات الموقع.

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

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

يحسب meta.attemptsByEngine الطلبات التي أرسلها الاستدعاء إلى كل محرك، وهي نفس الطلبات التي تعرضها لوحة محاولات Auto في صفحة Overview الخاصة بك. ويحسب meta.browserRequests الطلبات التي استهلكت حصة من رصيد المتصفح اليومي المتاح لك.

"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.

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

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

{
  "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 الفاشل، دون profilesTried. ويوجد اختلافان: يحسب Proxy كل نقطة خروج تمت تجربتها، حتى حد maxTries الذي حددته، بينما يحسب Auto طلباته الخاصة. يقرأ Auto أيضا الصفحة وحالتها، وبالتالي يُحسب الرفض ضمن defense حتى عند عدم التعرف على أي مزود. والعدد المسجل ضمن contentRejected هو الذي يمكنك إصلاحه بنفسك: عادت الصفحة ولكن قاعدتك لم تتطابق معها.

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

تعد استدعاءات Auto الفرعية طلبات Single وProxy وBrowser عادية تحت مفتاحك، لذا تنطبق عليها حدود خطتك. يقرأ السلم رمز 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 نفسه الذي تستخدمه نقاط النهاية المباشرة:

{
  "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 قد تصل إلى الحد الأقصى للتزامن بعدد استدعاءات أقل مما تتوقع. يشرح تشغيل الطلبات بالتوازي كيفية تحديد حجم الدفعة.

ما لا يقوم به Auto

  • لا يغير القيود القانونية. إذا رفض موقع كل نقاط الخروج التي يمكن لـ FourA الوصول إليها، يُرجع auto هذا الرفض.
  • لا يُخزن المحتوى مؤقتا. كل استدعاء يصل مباشرة إلى الهدف. تعني "الجلسة النشطة" الـ proxy وملفات cookie، وليس الـ response.
  • يظهر كصف واحد في سجل النشاط، تحت معرف الطلب الذي استلمته، مع مجموع أرصدة استدعاءاته الفرعية. عند فتحه، ستجد الاستدعاءات الفرعية من نوع Single / Proxy / Browser التي أجراها auto نيابة عنك مدرجة كمحاولات، ولكل منها نتيجتها الخاصة. تُحسب هذه المحاولات ضمن حدود Single وProxy وBrowser الخاصة بك، ولا تُحسب أبدا ضمن إجمالي عدد الطلبات أو معدل النجاح.
آخر تحديث: 13 نوفمبر 2026