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

البدء السريع

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

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

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

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

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

الخطوة 2: إجراء أول request لك

افتح سطر الأوامر وشغل التالي (استبدل 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 request إلى 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 (سواء HTML، أو JSON، أو نص خام)
  • total_time: مدة الـ request بالثواني

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

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

Endpoint السرعة متى تستخدمه
POST /api/auto/ متغيرة (سريعة على الخوادم النشطة) عندما لا تعرف المحرك الذي يحتاجه الموقع. قم بتمرير URL ودع FourA يختار المسار الأقل تكلفة الذي يعمل بنجاح.
POST /api/single/ الأسرع (200ms-2s) الصفحات الثابتة، والـ APIs، والمواقع المجهزة من جهة الخادم
POST /api/browser/ متوسطة (2s-10s) الصفحات المعتمدة بكثافة على JavaScript، وتطبيقات الصفحة الواحدة (SPAs)، والمحتوى الديناميكي
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
    }
  }'

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

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