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

# مفاتيح API

> إنشاء مفاتيح محدودة النطاق للوصول البرمجي، وإبطالها بأمان.

للبناء مباشرة على الـ API. وإن كنت تحتاج *استقبال* الأحداث فقط، فاستخدم
[Webhooks](/ar/help/integrations/webhooks) بدلًا منها — فهي أقل عملًا وأقل ما يجب تأمينه.

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

**مفاتيح API ← إنشاء مفتاح.** أعطه اسمًا، واختر النطاقات، واختياريًا تاريخ انتهاء.

<Warning>
  يُعرض المفتاح **مرة واحدة** عند الإنشاء. انسخه حينها. وإن فقدته، أبطله وأنشئ آخر — فلا سبيل
  لعرضه مجددًا.
</Warning>

## النطاقات

امنح ما يحتاجه التكامل فقط:

| النطاق                | يسمح بـ                  |
| --------------------- | ------------------------ |
| `conversations:read`  | قراءة المحادثات          |
| `conversations:write` | إنشاء المحادثات وتعديلها |
| `messages:read`       | قراءة الرسائل            |
| `messages:write`      | إرسال الرسائل            |
| `channels:read`       | عرض القنوات              |
| `channels:write`      | تعديل القنوات            |

والتكامل للقراءة فقط ينبغي أن يحمل نطاقات `:read` وحدها. فتسرّب مفتاح قراءة حادثة، وتسرّب مفتاح
كتابة حادثة أكبر بكثير.

## التسمية

سمِّ المفتاح بحسب **مكان استخدامه** لا بما يفعله — «n8n للإنتاج»، «مزامنة المستودع»، «اختبارات
التجريب». فحين تحتاج إبطال مفتاح على عجل، هذه هي المعلومة التي تحتاجها، و«مفتاح API رقم 3» لا
يخبرك بشيء عمّا سينكسر.

## الإبطال

الإبطال فوري ونهائي. وتعرض القائمة الحالة والنطاقات والبادئة وتاريخ الإنشاء و**آخر استخدام** —
والعمود الأخير هو كيف تجد المفاتيح التي لم يعد أحد يحتاجها.

والمفتاح الذي لم يُستخدم قط، أو لم يُستخدم منذ شهور، آمن للإبطال دائمًا تقريبًا. افعل ذلك: فبيانات
الاعتماد غير المستخدمة مخاطرة خالصة.

## الانتهاء

ضبط تاريخ انتهاء يعني أن المفتاح المنسي يتوقف عن العمل من تلقاء نفسه بدل أن يعيش للأبد. ويستحق
الاستخدام لأي شيء مؤقت — تكامل مقاول، أو ترحيل لمرة واحدة، أو إثبات مفهوم.

## توثيق المطورين

نقاط النهاية والمصادقة والحمولات موجودة في [أدلة المطورين](/introduction).