# المصادقة

> URL: https://foura.ai/ar/docs/getting-started/authentication
> Updated: 2026-10-29
> Index: https://foura.ai/llms.txt

يتطلب كل request إلى FourA API إجراء مصادقة. توضح هذه الصفحة كيفية الحصول على مفتاح API الخاص بك واستخدامه وإدارته.

## الحصول على مفتاح API الخاص بك

1. سجّل الدخول إلى [FourA Dashboard](https://foura.ai/dashboard)
2. انتقل إلى صفحة **API Keys**
3. انقر على **Create Key**
4. انسخ المفتاح من نافذة التأكيد

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

المفاتيح التي يتم إنشاؤها اليوم قابلة للإظهار: انقر على أيقونة العين في صف المفتاح لاحقًا لعرض السر الكامل عند الطلب (راجع [إدارة مفاتيح API](https://foura.ai/docs/dashboard/api-keys) للاطلاع على مسار الإظهار والأذونات). المفاتيح القديمة التي تم إنشاؤها قبل إطلاق ميزة الإظهار لا يمكن استعادتها وتظهر أيقونة قفل؛ أعد إنشاءها مرة واحدة للتبديل.

## استخدام مفتاح API الخاص بك

قم بتضمين مفتاح API الخاص بك في header‏ `X-API-Key` لكل request:

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

في Python:

```python
import requests

response = requests.post(
    "https://eu.api.foura.ai/api/single/",
    headers={
        "X-API-Key": "YOUR_API_KEY",
        "Content-Type": "application/json"
    },
    json={"method": "GET", "url": "https://example.com"}
)
```

في Node.js:

```javascript
const response = await fetch('https://eu.api.foura.ai/api/single/', {
  method: 'POST',
  headers: {
    'X-API-Key': 'YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({ method: 'GET', url: 'https://example.com' })
});
```

## أمان API Key

عامل API key الخاص بك ككلمة مرور:

- **لا ترفعه إلى أنظمة التحكم في الإصدار.** استخدم متغيرات البيئة بدلا من ذلك.
- **لا تكشفه في كود جانب العميل.** استخدمه فقط في تطبيقات جانب الخادم.
- **قم بتدويره في حال اختراقه.** أعد إنشاء المفتاح من Dashboard. يتوقف المفتاح السري القديم عن العمل خلال دقيقة واحدة، ويتم تسجيل كل عملية كشف في سجل التدقيق لتسهيل اكتشاف بيانات الاعتماد المسروقة بعد حدوث ذلك.

### استخدام متغيرات البيئة

قم بتخزين المفتاح في متغير بيئة:

```bash
export FOURA_API_KEY="pk_live_a1b2c3d4e5f6..."
```

ثم أشر إليه في الكود الخاص بك:

```python
import os
api_key = os.environ["FOURA_API_KEY"]
```

```javascript
const apiKey = process.env.FOURA_API_KEY;
```

## أخطاء المصادقة الشائعة

تُرجع جميع حالات فشل المصادقة حالة `401 Unauthorized`.

| الخطأ | الرسالة | السبب | الحل |
|-------|---------|-------|-----|
| 401 | Missing API key. Include X-API-Key header. | عدم وجود ترويسة `X-API-Key` في الطلب | أضف ترويسة `X-API-Key` |
| 401 | Invalid API key | مفتاح غير صحيح، أو مسافات بيضاء زائدة، أو مفتاح معطل | تحقق من المفتاح، أو احذف المسافات البيضاء، أو أنشئ مفتاحاً جديداً من Dashboard |

إذا تعذر على FourA التحقق من المفتاح مؤقتاً، على سبيل المثال أثناء تبديل قاعدة البيانات، فإنه يُرجع `503` مع `API key check temporarily unavailable` و `Retry-After: 5`، ولا يُرجع أبداً `401`. أعد المحاولة بعد انقضاء فترة الانتظار تلك: مفتاحك سليم.

تتضمن كل استجابة، سواء كانت ناجحة أم فاشلة، ترويسة `X-Foura-Request-Id`، باستثناء جسم الطلب الذي يتعذر على FourA قراءته كلياً (تنسيق JSON غير صالح، أو جسم يتجاوز 100 كيلوبايت)، حيث يتم رفضه قبل تعيين معرف له. سجّله في سجلاتك ليتمكن الدعم من البحث عن استدعاء محدد لاحقاً.

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

- [البدء السريع](https://foura.ai/docs/getting-started/quick-start): نفّذ طلبك الأول
- [إدارة مفاتيح API](https://foura.ai/docs/dashboard/api-keys): عرض المفاتيح وتعديلها وإعادة إنشائها وحذفها
- [نقاط نهاية API](https://foura.ai/docs/api/endpoints): مرجع نقاط النهاية الكامل
- [معالجة الأخطاء](https://foura.ai/docs/api/errors): التعامل مع أخطاء المصادقة بسلاسة
