اختيار Endpoint المناسب

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

دليل القرار السريع

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

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

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

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

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

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

مقارنة الـ Endpoints

Single (`POST /api/single/`)

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

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", "unblocker": true}'

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

Browser (`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"
  }'

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

Proxy (`POST /api/proxy/`)

يجمع بين HTTP requests والتدوير التلقائي للـ 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",
      "unblocker": true
    }
  }'

وقت الاستجابة النموذجي: من 1s إلى 5s الأفضل لـ: مراقبة أسعار التجارة الإلكترونية، وتجميع بيانات السفر، والمواقع التي تستخدم كشف البوتات (bot detection)

متى يجب الجمع بين الأساليب

تستفيد بعض سير العمل (workflows) من استخدام endpoints متعددة:

البدء بـ single: اختبر ما إذا كانت الصفحة ترجع بيانات مفيدة دون استخدام متصفح.
الرجوع إلى browser: إذا كانت الـ response فارغة أو تفتقر إلى المحتوى، انتقل إلى عرض المتصفح (browser rendering).
إضافة proxy: إذا تم حظرك (403/CAPTCHA)، قم بتغليف الـ request الخاص بك في proxy endpoint للتدوير التلقائي لعنوان IP.

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

نصائح الأداء

استخدم single endpoint بشكل افتراضي وقم بالترقية فقط عند الحاجة
اضبط checkText في browser requests لتجنب الانتظار لمحتوى غير ضروري
اضبط maxTries في proxy requests للتحكم في سلوك إعادة المحاولة (الافتراضي هو 5، والحد الأقصى هو 90)
حافظ على قيم timeout_ms معقولة: من 10 إلى 15 ثانية لمعظم الصفحات

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

API Endpoints: مرجع المعلمات الكامل
Scrape a Dynamic Website: دليل خطوة بخطوة لـ browser request
Quick Start: الـ request الأول الخاص بك في 30 ثانية

آخر تحديث: 30 يونيو 2026