إنشاء مهمة

يرشدك هذا الدليل لإنشاء مفتاح API وإرسال أول request باستخدام لوحة تحكم FourA.

الخطوة 1: فتح لوحة التحكم

انتقل إلى لوحة التحكم وسجل الدخول بحساب FourA الخاص بك.

الخطوة 2: إنشاء مفتاح API

اذهب إلى صفحة مفاتيح API وانقر على إنشاء مفتاح.

امنح المفتاح اسما وصفيا (مثل "production-scraper" أو "dev-testing"). يظهر مربع حوار التأكيد المفتاح العادي مع زر النسخ.

إذا فاتك ذلك، انقر على أيقونة العين في صف المفتاح لاحقا لإظهاره مرة أخرى. لا يمكن استرجاع المفاتيح القديمة التي تم إنشاؤها قبل إتاحة ميزة الإظهار، قم بإعادة إنشائها مرة واحدة للتبديل. المسار الكامل: إدارة مفاتيح API.

يبدو مفتاحك بهذا الشكل: pk_live_a1b2c3d4e5f6...

الخطوة 3: اختيار endpoint

تمتلك FourA أربعة endpoints لسيناريوهات مختلفة:

Auto (`POST /api/auto/`)

الخيار الافتراضي الذكي. مرر URL بالإضافة إلى قاعدة validate وستختار FourA أرخص مسار يعمل: request مباشر، أو proxy متناوب، أو متصفح كامل. الأفضل عندما تستهدف موقعا جديدا ولا تعرف بعد ما يحتاجه.

Single (`POST /api/single/`)

يرسل HTTP request سريع. الأفضل لصفحات HTML الثابتة و API endpoints. وقت الاستجابة: عادة أقل من 2 ثانية.

Browser (`POST /api/browser/`)

يشغل مثيل متصفح Chrome لعرض JavaScript. الأفضل لتطبيقات SPA، والمحتوى المؤجل التحميل، والصفحات التي تتطلب تنفيذ JS. وقت الاستجابة: 2 إلى 10 ثوان.

Proxy (`POST /api/proxy/`)

يوجه الـ request من خلال proxies متناوبة مع إعادة المحاولة التلقائية. الأفضل للمواقع التي تحتوي على آليات اكتشاف الروبوتات أو المحتوى المقيد جغرافيا.

الخطوة 4: إرسال أول request

افتح الطرفية (terminal) وقم بتشغيل:

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

الخطوة 5: قراءة الـ response

{
  "status": 200,
  "headers": [
    {
      "result": { "version": "HTTP/2", "code": 200, "reason": "" },
      "content-type": "text/html; charset=UTF-8",
      "content-length": "1256"
    }
  ],
  "data": "<html>...</html>",
  "total_time": 0.45
}

حقل headers هو مصفوفة كائنات، واحد لكل خطوة إعادة توجيه. يحتوي كل إدخال على result مع سطر الحالة بالإضافة إلى كل response header أرجعه الهدف.

الحقول الرئيسية:

status: رمز حالة HTTP من الموقع المستهدف
data: جسم الاستجابة (HTML، أو JSON، أو نص خام)
total_time: مدة الـ request بالثواني

الخطوة 6: تجربة Browser Request

إذا كانت الصفحة المستهدفة تستخدم JavaScript لعرض المحتوى، استخدم متصفح endpoint بدلا من ذلك:

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/products", "timeout_ms": 15000}'

يستخدم الـ response الخاص بالمتصفح body بدلا من data:

{
  "status": 200,
  "headers": {"content-type": "text/html"},
  "body": "<html>...</html>"
}

المشاكل الشائعة

المشكلة	الحل
لست متأكدا من المحرك الذي يجب استخدامه	ابدأ بـ auto endpoint. سيختار المسار الصحيح ويتذكر ما نجح.
محتوى فارغ	قم بالتبديل من single إلى browser endpoint: من المحتمل أن الصفحة تحتاج إلى عرض JS
وجود Captcha في الـ response	انتقل إلى proxy endpoint لتدوير IP التلقائي
انتهاء المهلة	قم بزيادة `timeout_ms` أو تحقق من صحة URL
فقدت مفتاحك	انقر على أيقونة العين في صف المفتاح في مفاتيح API لإظهاره، أو أعد إنشائه إذا كان المفتاح قديما

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

نظرة عامة على لوحة التحكم: جولة كاملة في لوحة التحكم
Playground: اختبر الطلبات في لوحة التحكم قبل كتابة التعليمات البرمجية
Smart Fetch (Auto): تعمق في auto endpoint
اختيار الـ Endpoint المناسب: مقارنة مفصلة
المشاكل الشائعة: حل المشاكل بسرعة

آخر تحديث: 8 يوليو 2026