التوثيق › البدء › البدء السريع

البدء السريع

انتقل من البداية إلى أول عملية جمع بيانات لك في أقل من دقيقتين.

المتطلبات الأساسية

الخطوة 1: الحصول على مفتاح API الخاص بك

سجل الدخول إلى Dashboard وأنشئ مفتاح API. يبدو بهذا الشكل: pk_live_a1b2c3d4e5f6...

انسخه. ستحتاج إليه لكل request.

الخطوة 2: تنفيذ أول Request لك

افتح Terminal وشغّل هذا الأمر (استبدل YOUR_API_KEY بمفتاحك الفعلي):

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

يرسل هذا طلب HTTP إلى example.com ويعيد كود HTML الخاص بالصفحة.

الخطوة 3: قراءة الـ Response

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

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

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

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

الخطوة 4: تجربة endpoints مختلفة

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

Endpoint السرعة متى يُستخدم
POST /api/auto/ متفاوتة (سريعة على المضيفين النشطين) عندما لا تعرف المحرك الذي يحتاجه الموقع. مرر URL ودع FourA يختار المسار الأقل تكلفة الذي يعمل بنجاح.
POST /api/single/ الأسرع (200ms إلى 2s) الصفحات الثابتة، والـ APIs، والمواقع المُصيّرة من جانب الخادم (server-rendered)
POST /api/browser/ متوسطة (2s إلى 10s) الصفحات التي تعتمد بكثافة على JavaScript، وتطبيقات SPA، والمحتوى الديناميكي
POST /api/proxy/ سريعة (1s إلى 5s) المواقع التي تتحقق من هوية الطالب، والمحتوى الذي يختلف بحسب البلد

جرب auto request (الخيار الافتراضي الذكي):

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

جرّب إرسال browser request:

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

جرّب proxy request (تدوير تلقائي لـ proxy):

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

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

آخر تحديث: 27 سبتمبر 2026
المصادقة →