إجراء request الأول الخاص بك

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

الخطوة 1: افتح Dashboard

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

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

انتقل إلى صفحة API Keys وانقر على Create Key.

امنح المفتاح اسماً وصفياً (على سبيل المثال، "production-scraper" أو "dev-testing"). يظهر المفتاح الكامل مرة واحدة فقط، لذا انسخه على الفور.

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

الخطوة 3: اختر Endpoint

يحتوي FourA على ثلاثة endpoints لسيناريوهات مختلفة:

Single (`POST /api/single/`)

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

Browser (`POST /api/browser/`)

يُشغّل مثيل متصفح Chrome لتصيير JavaScript. الأفضل لتطبيقات SPAs، والمحتوى الكسول (lazy-loaded)، والصفحات التي تتطلب تنفيذ 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": [["content-type", "text/html"]],
  "data": "<html>...</html>",
  "total_time": 0.45
}

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

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

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

إذا كانت الصفحة المستهدفة تستخدم JavaScript لتصيير المحتوى، فاستخدم browser 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}'

يستخدم browser response الحقل body بدلاً من data:

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

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

المشكلة	الحل
محتوى فارغ	انتقل من single إلى browser endpoint: من المحتمل أن الصفحة تحتاج إلى تصيير JS
Captcha في response	انتقل إلى proxy endpoint لتدوير IP تلقائياً
انتهاء المهلة (Timeout)	قم بزيادة `timeout_ms` أو تحقق من صحة URL

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

نظرة عامة على Dashboard: جولة كاملة في Dashboard
Playground: اختبر requests في Dashboard قبل كتابة الكود
اختيار Endpoint المناسب: مقارنة تفصيلية
المشكلات الشائعة: حل المشكلات بسرعة

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