اختيار الـ endpoint المناسب

توفر FourA أربعة endpoints للطلبات، كل منها مخصص لسيناريو مختلف. اختيار الـ endpoint المناسب يوفر الوقت، ويقلل التكلفة، ويحسن معدلات النجاح.

دليل اتخاذ القرار السريع

استخدم auto endpoint عندما:

  • تستهدف موقعا جديدا ولا تعرف متطلباته بعد
  • تريد استدعاء واحدا يتولى التبديل بين proxy والتراجع إلى browser تلقائيا
  • تريد جلسة يمكنك إعادة تشغيلها بتكلفة منخفضة في الاستدعاء التالي لنفس المضيف

استخدم single endpoint عندما:

  • تكون الصفحة معالجة من جانب الخادم (لا تتطلب JavaScript)
  • تحتاج إلى أقصى سرعة (عادة أقل من ثانية واحدة)
  • تستهدف APIs أو صفحات HTML ثابتة من مضيف تعرف مسبقا أنه يعمل

استخدم browser endpoint عندما:

  • تعتمد الصفحة على JavaScript لعرض المحتوى
  • يتم تحميل المحتوى بعد التحميل الأولي للصفحة
  • تحتاج إلى DOM المعروض بالكامل

استخدم proxy endpoint عندما:

  • يحظر الموقع المستهدف الطلبات بنشاط
  • تحتاج إلى التبديل بين عدة عناوين IP
  • أرجعت المحاولات السابقة رمز 403 أو صفحات تحقق

مقارنة بين الـ Endpoints

Auto (POST /api/auto/)

هو smart-fetch endpoint. تقوم بتمرير URL وقاعدة validate (يُفضل ذلك)، وتتدرج FourA عبر خطوات تراعي التكلفة: proxy مدور أولا، ثم browser كامل عبر proxy. عند تعيين forceProxy: false، يتم إجراء فحص مباشر منخفض التكلفة وعرض مباشر عبر المتصفح قبل كليهما. الخطوة الأولى التي تُرجع response يطابق validate الخاص بك تكون هي النتيجة المعتمدة. عند تكرار الاستدعاءات لنفس المضيف، تتم إعادة استخدام جلسة نشطة، مما يجعل الاستدعاء الثاني منخفض التكلفة.

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"]}}
  }'

وقت الاستجابة النموذجي: من 200ms (في وضع warm) إلى أكثر من 30s (حل cold على موقع صعب) الأفضل لـ: الأهداف الجديدة، والمواقع ذات الحماية المختلطة، وحالات "أريد الصفحة فقط"

للاطلاع على شرح أكثر تفصيلاً، راجع دليل Smart Fetch.

Single (POST /api/single/)

الخيار الأسرع. يرسل HTTP request بخصائص شبكية واقعية تحاكي المتصفح، دون تشغيل عملية متصفح فعلية.

curl -X POST https://eu.api.foura.ai/api/single/ \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method": "GET", "url": "https://example.com/api/products"}'

وقت الاستجابة النموذجي: من 200ms إلى 2s الأنسب لـ: APIs، مواقع الأخبار، المدونات، صفحات المنتجات الثابتة

المتصفح (POST /api/browser/)

يفتح عنوان URL الخاص بك داخل مثيل متصفح Chrome. يتم تحميل الصفحة بالكامل، وتنفيذ JavaScript، وتحصل على كود HTML النهائي المعروض.

curl -X POST https://eu.api.foura.ai/api/browser/ \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/spa-app",
    "timeout_ms": 15000,
    "checkText": "data-table"
  }'

وقت الاستجابة النموذجي: من 2 ثوانٍ إلى 10 ثوانٍ الأفضل لـ: تطبيقات الصفحة الواحدة (SPAs)، والمواقع التي تعتمد على التحميل الكسول (lazy loading)، والمحتوى المعروض عبر JavaScript

Proxy (POST /api/proxy/)

يجمع بين طلبات HTTP والتدوير التلقائي لـ proxy. إذا فشلت المحاولة الأولى أو تم حظرها، يعيد FourA المحاولة عبر proxies مختلفة.

curl -X POST https://eu.api.foura.ai/api/proxy/ \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "maxTries": 5,
    "request": {
      "method": "GET",
      "url": "https://example.com/pricing"
    }
  }'

وقت الاستجابة النموذجي: من 1 ثانية إلى 5 ثوانٍ الأنسب لـ: مراقبة أسعار التجارة الإلكترونية، تجميع بيانات السفر، والمواقع التي تستخدم أنظمة كشف البوتات

التلقائي مقابل اليدوي

متى يجب أن تترك الخيار التلقائي يحدد المسار، ومتى يجب أن تستدعي Single أو Proxy أو Browser بنفسك؟

اختر التلقائي (auto) اختر اليدوي (manual)
لا تعرف متطلبات الموقع بعد تعرف بدقة المحرك الذي يحتاجه الهدف
تريد استدعاءً واحدًا يعمل مباشرة تعمل على تحسين هيكل الـ request لهدف معروف
لا تمانع في قيام auto بإعادة استخدام جلسة تعلمها مسبقًا تريد تحكمًا كاملًا في إعادة المحاولة لكل طلب، والمهلة، واختيار الـ proxy
تتقبل استهلاك بضع ثوانٍ للفحص الاستكشافي في أول طلب زمن الاستجابة في الطلب الأول أهم لديك من الاستكشاف

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

متى تجمع بين الطرق المختلفة

تستفيد بعض تدفقات العمل من استخدام عدة endpoints:

  1. الاستكشاف عبر auto: مرر قاعدة validate ودع التدرج يكتشف الدرجة التي يحتاجها الموقع.
  2. إعادة التشغيل عبر single: خذ session.proxy وsession.cookies وsession.userAgent التي أرجعها الوضع التلقائي، ثم استدعِ Single معها لطلب الصفحات التالية على نفس المضيف.
  3. الرجوع إلى browser كخيار احتياطي: إذا بدأ single بالفشل، انتقل إلى معالجة العرض عبر المتصفح.
  4. إضافة proxy: إذا تم رفض طلبك (رمز 403 أو صفحة تحقق) بدون auto، غلف الـ request الخاص بك في endpoint الـ proxy للتدوير التلقائي.

هذا النهج التدريجي يحافظ على انخفاض التكلفة مع إبقاء معدلات النجاح مرتفعة.

نصائح لتحسين الأداء

  • مرر سلسلة نصية فرعية عبر validate.data.accept للأهداف المحمية. يتعرف الوضع التلقائي على صفحات التحدي الشائعة تلقائيًا، ولكن قاعدتك فقط هي القادرة على التقاط صفحة فحص لا يعرفها، أو صفحة تم تحميلها بدون المحتوى الذي تحتاجه.
  • استخدم الـ endpoint المعنون single افتراضيًا للمضيفين المعروفين مسبقًا، ولا تقم بالترقية إلا عند الحاجة.
  • عيّن checkText في طلبات المتصفح حتى يتم اعتبار الصفحة التي تم عرضها بدون المحتوى الخاص بك كفشل (checkText:<text> not found) بدلًا من نجاح. لا يجعل checkText منصة FourA تنتظر النص لفترة أطول.
  • عيّن maxTries في طلبات الـ proxy للتحكم في سلوك إعادة المحاولة (القيمة الافتراضية هي 5، والحد الأقصى هو 90).
  • حافظ على قيمة معقولة لـ timeout_ms: من 10 إلى 15 ثانية لمعظم الصفحات، و30 ثانية فأكثر لعمليات التشغيل التلقائي الأولية ضد المواقع المحمية.

الخطوات التالية

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