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

# مفاتيح API

> إنشاء وإدارة مفاتيح API للوصول البرمجي

توفر مفاتيح API وصولاً برمجيًا إلى واجهات Gorbit API، مما يمكّنك من إنشاء تطبيقات مخصصة،
والتكامل مع الأنظمة الخارجية، وأتمتة سير العمل.

<Note>
  توجد مفاتيح API كمستخدمين متميزين في Gorbit، مما يتيح لك تتبع النشاط وإدارة الأذونات على مستوى المفتاح.
</Note>

## أنواع مفاتيح API

هناك ثلاثة أنواع من مفاتيح API:

<AccordionGroup>
  <Accordion title="مفاتيح API للمسؤول" icon="shield-check">
    يمكنها الوصول إلى جميع نقاط النهاية، بما في تلك المسبوقة بـ `admin/`.

    **حالات الاستخدام:**

    * إدارة النظام الكاملة
    * عمليات إدارة المستخدمين
    * إدارة البيانات والتحليلات
    * وصول كامل لجميع ميزات Gorbit

    **⚠️ استخدم بحذر:** مفاتيح المسؤول لديها وصول غير مقيد لمثيل Gorbit الخاص بك.
  </Accordion>

  <Accordion title="مفاتيح API الأساسية" icon="key">
    يمكنها الوصول إلى نقاط النهاية غير الإدارية مثل البحث والمحادثة والوكلاء والإجراءات.

    **حالات الاستخدام:**

    * بناء تطبيقات المحادثة
    * تنفيذ وظائف البحث
    * إنشاء وإدارة الوكلاء
    * تشغيل الإجراءات وسير العمل

    **✅ موصى به:** يجب على معظم المستخدمين استخدام مفاتيح API الأساسية لتطوير التطبيقات.
  </Accordion>

  <Accordion title="مفاتيح API المحدودة" icon="lock">
    وصول للوكيل للقراءة فقط. يمكنها نشر رسائل إلى نقاط نهاية المحادثة، لكن لا يمكنها قراءة سجل المحادثة.

    **حالات الاستخدام:**

    * بيئات مقيدة للغاية
    * حالات استخدام محددة تتطلب أذونات قليلة
    * الاختبار بنطاق محدود
  </Accordion>
</AccordionGroup>

<Tip>
  تبحث عن رموز مميزة بنطاق المستخدم؟
  يمكن لأي مستخدم إنشاء [رمز وصول شخصي](/developers/overview#personal-access-tokens)
  من **الإعدادات** > **الحسابات والوصول** لمصادقة طلبات API باسمهم.
</Tip>

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

<Steps>
  <Step title="انتقل إلى مفاتيح API">
    في لوحة الإدارة، انتقل إلى **مفاتيح API**.
  </Step>

  <Step title="إنشاء مفتاح API جديد">
    انقر على **إنشاء مفتاح API جديد** واختر نوع المفتاح المناسب لحالة استخدامك.

    <img className="rounded-image" src="https://mintcdn.com/gorbit/klR7erNMN33AvYm0/assets/admins/user_management/create_api_key.png?fit=max&auto=format&n=klR7erNMN33AvYm0&q=85&s=adec22aa3cf0a508997ac2bdce82dd14" alt="Create API Key interface" width="1820" height="1050" data-path="assets/admins/user_management/create_api_key.png" />
  </Step>

  <Step title="حفظ ونسخ المفتاح">
    بعد الإنشاء، انسخ فورًا وقم بتخزين مفتاح API بشكل آمن.
  </Step>
</Steps>

سترى مفتاح API الجديد الخاص بك مع جميع مفاتيحك الموجودة في صفحة مفاتيح API.

من هذه الصفحة، يمكنك إعادة إنشاء أو إعادة تسمية أو حذف مفاتيح API الخاصة بك.