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

# المصادقة

> أنشئ مفتاح API وأرسله في ترويسة X-Api-Key وحافظ على أمانه.

تُصادَق كل طلبات Integration API باستخدام **مفتاح API** يُرسَل في ترويسة
**`X-Api-Key`**. لا توجد بيانات اعتماد أخرى لإدارتها — لا تدفّق OAuth ولا رموز
بحاجة إلى تجديد.

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

تُنشأ مفاتيح API داخل المنصة، وليس عبر الواجهة.

<Steps>
  <Step title="افتح مفاتيح API">
    في التطبيق، انتقل إلى **الإعدادات ← التكاملات ← مفاتيح API**
    (`/settings/integration/api-keys`). راجع [مفاتيح API](/ar/settings/api-keys)
    للاطّلاع على مرجع الإعدادات الكامل.
  </Step>

  <Step title="سمِّ المفتاح وحدّد نطاقاته">
    امنح المفتاح اسمًا وصفيًا واختر فقط النطاقات التي يحتاجها التكامل (مثل
    `invoices:write`).
  </Step>

  <Step title="انسخ السرّ">
    اختر **Create API Key**. يُعرض السرّ — الذي يبدو بالشكل `fat_…` — **مرة واحدة
    فقط**. انسخه فورًا واحفظه بأمان؛ لن تتمكّن من رؤيته مجددًا.
  </Step>
</Steps>

## إرسال المفتاح

أضِف المفتاح إلى ترويسة `X-Api-Key` في كل طلب:

```bash theme={null}
curl https://integration.fatorly.com/v1/invoices \
  -H "X-Api-Key: fat_your_key_here" \
  -H "Content-Type: application/json"
```

يؤدّي المفتاح المفقود أو غير الصالح إلى **401 Unauthorized**؛ أما المفتاح الصالح
الذي لا يملك الصلاحية التي تتطلّبها نقطة النهاية فيؤدّي إلى **403 Forbidden** —
راجع [الأخطاء](/ar/developers/errors).

## نطاق المفتاح وأمانه

* **شركة واحدة لكل مفتاح.** يقتصر نطاق كل مفتاح على شركة/مستأجر واحد. للتكامل مع
  عدّة شركات، أنشئ مفتاحًا لكل شركة.
* **أقل صلاحية ممكنة.** امنح فقط النطاقات التي يستخدمها التكامل.
* **تعامل معه كأنه كلمة مرور.** احفظ المفاتيح في مدير أسرار، ولا تضعها أبدًا في
  نظام التحكّم بالمصدر أو في كود يعمل على جهة العميل.

<Warning>
  إذا فُقد المفتاح أو تعرّض للاختراق، **ألغِه** من **الإعدادات ← التكاملات ← مفاتيح
  API** وأنشئ مفتاحًا جديدًا. يسري الإلغاء فورًا.
</Warning>

## التالي

* [البدء السريع](/ar/developers/quickstart) — أنشئ أول فاتورة لك.
* [معرّف عدم التكرار](/ar/developers/idempotency) — اجعل عمليات الكتابة آمنة لإعادة المحاولة.