إنشاء مهمة

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

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

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

الخطوة 2: أنشئ مفتاح API

انتقل إلى صفحة API Keys وانقر على Create API key. بمجرد حصولك على مفتاح، سيظهر الزر أعلى القائمة بالنص Create Key.

قم بتسمية المفتاح باسم وصفي (مثل "production-scraper" أو "dev-testing"). يعرض مربع الحوار API Key Created المفتاح بنصه الصريح مع زر نسخ، وأسفل Test your first request يظهر أمر curl جاهز للتشغيل مع خيار Copy command. على الهاتف أو الجهاز اللوحي، ينقلك خيار Try it in the Playground إلى هناك مباشرة.

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

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

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

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

تلقائي (POST /api/auto/)

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

فردي (POST /api/single/)

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

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

يشغل مثيل متصفح Chrome لتصيير JavaScript. الأفضل لتطبيقات SPA، والمحتوى الذي يتم تحميله تدريجيًا (lazy-loaded)، والصفحات التي تتطلب تنفيذ JS. وقت الاستجابة: من 2 إلى 10 ثوانٍ.

Proxy (POST /api/proxy/)

يمرر الـ request عبر شبكة rotating 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 عبارة عن صفيف من الكائنات، كائن واحد لكل قفزة إعادة توجيه (redirect hop). يحتوي كل إدخال على result يتضمن سطر الحالة بالإضافة إلى كل 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>"
}

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

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

• Dashboard Overview: جولة شاملة في لوحة التحكم
• Playground: اختبار الـ requests في لوحة التحكم قبل كتابة التعليمات البرمجية
• Smart Fetch (Auto): تفاصيل متعمقة حول auto endpoint
• Choosing the Right Endpoint: مقارنة تفصيلية
• Common Issues: حل المشكلات بسرعة