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

> URL: https://foura.ai/ar/docs/getting-started/quick-start
> Updated: 2026-09-27
> Index: https://foura.ai/llms.txt

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

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

- حساب FourA ([سجل من هنا](https://foura.ai))
- مفتاح API الخاص بك (أنشئ مفتاحًا في [Dashboard](https://foura.ai/dashboard))

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

سجل الدخول إلى [Dashboard](https://foura.ai/dashboard) وأنشئ مفتاح API. يبدو بهذا الشكل: `pk_live_a1b2c3d4e5f6...`

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

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

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

```bash
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

```json
{
  "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 (الخيار الافتراضي الذكي):

```bash
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:

```bash
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):

```bash
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
    }
  }'
```

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

- [المصادقة](https://foura.ai/docs/getting-started/authentication): إدارة مفاتيح API والأمان
- [نقاط نهاية API](https://foura.ai/docs/api/endpoints): مرجع المعلمات الكامل لجميع نقاط النهاية الأربع
- [الجلب الذكي (Auto)](https://foura.ai/docs/guides/smart-fetch): كيف تحدد نقطة النهاية auto الإجراء المطلوب
- [حزم SDK والمكتبات](https://foura.ai/docs/getting-started/sdks-and-libraries): أمثلة بلغات Python وNode.js وGo وRuby
- [اختيار نقطة النهاية المناسبة](https://foura.ai/docs/guides/choosing-task-type): متى تختار auto أو single أو browser أو proxy
