# إدارة مفاتيح واجهة برمجة التطبيقات

تتيح مفاتيح API للأدوات الخارجية وأتمتة العمليات التفاعل مع مساحة العمل الخاصة بك برمجيًا. يمكن لمسؤولي مساحة العمل إنشاء المفاتيح وعرضها وإبطالها في أي وقت.

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

انتقل إلى **الإعدادات → API → المفاتيح** ثم انقر على **مفتاح API جديد**. امنح المفتاح اسمًا وصفيًا (مثلًا: "تكامل CI/CD" أو "لوحة المعلومات الداخلية") حتى تتمكن من التعرف عليه لاحقًا.

{% hint style="warning" %}
انسخ مفتاحك مباشرة بعد إنشائه — فلن يُعرض مرة أخرى. إذا فقدته، فستحتاج إلى إبطاله وإعادة إنشائه.
{% endhint %}

### أذونات المفتاح

عند إنشاء مفتاح، يمكنك تحديد نطاق أذوناته:

| الإذن     | ما الذي يتيحه                          |
| --------- | -------------------------------------- |
| **قراءة** | جلب المحتوى والإعدادات وبيانات الأعضاء |
| **كتابة** | إنشاء المحتوى وتحديثه                  |
| **مسؤول** | إدارة الإعدادات والأعضاء والفوترة      |

استخدم الحد الأدنى من الأذونات اللازمة لكل تكامل.

### تدوير مفتاح

لتدوير مفتاح، أنشئ مفتاحًا جديدًا، ثم حدّث التكامل لديك لاستخدامه، وبعد ذلك أبطِل المفتاح القديم. لا توجد عملية تدوير آلية — فهذه عملية يدوية.

### إبطال مفتاح

انتقل إلى **الإعدادات → API → المفاتيح**، ابحث عن المفتاح، ثم انقر على **إبطال**. يتم الإبطال فورًا — ستفشل أي طلبات تستخدم ذلك المفتاح على الفور.

### مراقبة الاستخدام

ضمن **الإعدادات → API → الاستخدام**، يمكنك الاطلاع على عدد الطلبات لكل مفتاح خلال الأيام 30 الماضية. وهذا مفيد لاكتشاف الاستخدام غير المتوقع أو تحديد التكاملات الأكثر نشاطًا.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://isbm.savimbo.com/practice-guide/ar/msuwl/idarh-mfatyh-wajhh-brmjh-alttbyqat.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.