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

دليل البدء السريع

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

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

الخطوة 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"}'

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

الخطوة 3: قراءة response

{
  "status": 200,
  "headers": [["content-type", "text/html"]],
  "data": "<!doctype html><html>...</html>",
  "total_time": 0.45
}

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

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

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

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

Endpoint السرعة متى يُستخدم
POST /api/single/ الأسرع (200ms-2s) الصفحات الثابتة (Static pages)، وAPIs، والمواقع التي يتم تقديمها عبر الخادم (server-rendered)
POST /api/browser/ متوسط (2s-10s) الصفحات التي تعتمد بكثافة على JavaScript، وتطبيقات الصفحة الواحدة (SPAs)، والمحتوى الديناميكي
POST /api/proxy/ سريع (1s-5s) المواقع التي تحتوي على كشف البوتات (bot detection)، والمحتوى المقيد جغرافياً

جرب 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
    }
  }'

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

آخر تحديث: 1 يوليو 2026
المصادقة →