> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scanova.io/llms.txt
> Use this file to discover all available pages before exploring further.

# إنشاء مفتاح API

> أنشئ من لوحة تحكم Scanova مفتاح API خاصًا بموقع واحد لأحداث الخادم في تتبع التحويلات. يظهر المفتاح مرة واحدة فقط، فاحفظه في مكان آمن.

لكل موقع تتبع مفاتيح API خاصة به. والمفتاح مرتبط بموقع واحد — لا يمكن استخدامه إلا لإرسال أحداث `site_id` ذلك الموقع.

## الخطوات

1. سجّل الدخول إلى لوحة تحكم Scanova
2. انتقل إلى **التحليلات ← تتبع التحويلات**
3. انقر على موقع التتبع لديك لفتح تفاصيله
4. اختر **إعداد التتبع** في موقعك، ثم تبويب **تتبع عبر API**
5. انقر على **Generate API Key**
6. أدخل اسمًا واضحًا (مثل `Production Backend` أو `Checkout Service`)
7. انقر على **Generate**
8. **انسخ المفتاح فورًا** — فهو يظهر مرة واحدة فقط

<Warning>
  يظهر مفتاح API الأصلي مرة واحدة فقط. وإذا أغلقت النافذة دون نسخه، فسيلزمك إبطاله وإنشاء مفتاح جديد.
</Warning>

## احفظ المفتاح بأمان

احفظ المفتاح في متغير بيئة على الخادم لديك. ولا تكتبه مباشرة في الكود المصدري أبدًا.

```bash theme={null}
# .env
SCANOVA_API_KEY=your_key_here
```

```javascript theme={null}
// Node.js
const apiKey = process.env.SCANOVA_API_KEY;
```

```python theme={null}
# Python
import os
api_key = os.environ['SCANOVA_API_KEY']
```

## حدود المفاتيح وإدارتها

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

## كيف تستخدم المفتاح

أرسله كترويسة مع كل طلب حدث خادم:

```http theme={null}
POST /server-events HTTP/1.1
Host: track.scanova.io
Content-Type: application/json
X-API-Key: YOUR_API_KEY
```

يجب أن يطابق المفتاح قيمة `site_id` التي ترسلها في جسم الطلب. وعند عدم التطابق يعود الرد `403`.

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

[أرسل أول حدث خادم ←](/ar/conversion-tracking/server/send-events)