> ## 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 وإدارتها

> أين تُنشئ وتُلغي مفاتيح Management API في لوحة تحكم Scanova — النظير الخاص بالواجهة لنقاط النهاية التقنية الخاصة بالرموز.

تغطي هذه الصفحة واجهة لوحة التحكم الخاصة بمفاتيح Management API. للاطلاع على الصيغة التقنية الأساسية، راجع صفحات المرجع التقني: [إنشاء رمز API](/ar/api-reference/management-api/tokens/create)، و[إزالة رمز API](/ar/api-reference/management-api/tokens/remove)، و[نقاط نهاية الاستخدام](/ar/api-reference/management-api/tokens/usage-stats).

## أين تجدها

توجد مفاتيح API في `/api/keys`، ضمن **Developer → API** في الشريط الجانبي. هذه هي نفس الصفحة سواء كان لديك صفر مفاتيح أو عدة مفاتيح — الحساب الفارغ يرى شرحًا توضيحيًا بدلًا من جدول فارغ:

<Frame caption="صفحة API Keys، تم التحقق منها مباشرة على حساب لا يملك مفاتيح بعد — لاحظ ملاحظة حصة الخطة مباشرة أسفل رأسية الصفحة">
  <img src="https://mintcdn.com/scanova-api/2FTGGTqcp1qRUtvm/images/v2/api-keys/creating-and-managing-keys/api-keys-list.png?fit=max&auto=format&n=2FTGGTqcp1qRUtvm&q=85&s=9fb5f76a17aaa3de565abbca72696f93" alt="صفحة API Keys تعرض رأسية 'API Keys' مع زر Generate API Key، وملاحظة تقول 'You can create upto 1 API keys'، ولوحة حالة فارغة بعنوان 'Run Scanova from your own systems' مع ثلاث بطاقات فوائد (Full programmatic control، Integrate with your own systems، Automate at scale) وزر Generate API Key" width="1440" height="900" data-path="images/v2/api-keys/creating-and-managing-keys/api-keys-list.png" />
</Frame>

<Note>
  الوصول إلى هذه الصفحة مقيد بأمرين: صلاحية (عرض أو إدارة) وحصة خطة (‏`MANAGEMENT_API`). إذا كانت خطتك لا تمنح هذه الحصة، فلن ترى هذه الصفحة إطلاقًا — تواصل مع الدعم إذا كنت تتوقع الحصول على وصول Management API في خطتك.
</Note>

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

اختر **Generate API Key** (في الرأسية، أو زر لوحة الحالة الفارغة نفسها) لفتح لوحة الإنشاء:

<Frame caption="لوحة Create API Key، تم التحقق منها مباشرة">
  <img src="https://mintcdn.com/scanova-api/2FTGGTqcp1qRUtvm/images/v2/api-keys/creating-and-managing-keys/create-api-key-drawer.png?fit=max&auto=format&n=2FTGGTqcp1qRUtvm&q=85&s=f3214c74b89b84a08a5c87df87c983c1" alt="لوحة Create API Key مع حقل نصي Name (0/100 حرفًا) وقائمة منسدلة Expiration مضبوطة على 'in 1 Month'، مع زرَّي Cancel وCreate" width="1440" height="900" data-path="images/v2/api-keys/creating-and-managing-keys/create-api-key-drawer.png" />
</Frame>

| الحقل          | ملاحظات                                                                                                                                                                                                                                                                                |
| -------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Name**       | مطلوب، حتى 100 حرف. يظهر في قائمة المفاتيح حتى تتمكن من تمييز المفاتيح لاحقًا — اختر اسمًا يُعرّف بالتكامل، مثل "Zapier — production".                                                                                                                                                 |
| **Expiration** | أحد الخيارات **in 1 Month** أو **in 3 Months** أو **in 1 Year** أو **Never**. يقابل هذا مباشرة حقل `expiry` في [نقطة نهاية الإنشاء](/ar/api-reference/management-api/tokens/create) (‏30 / 90 / 365 / -1 يومًا) — لا توجد طريقة لتغييره بعد الإنشاء؛ أنشئ مفتاحًا جديدًا بدلًا من ذلك. |

اختيار **Create** يعرض فورًا قيمة المفتاح الخام في مربع حوار يظهر لمرة واحدة:

<Note>
  يقول مربع حوار المفتاح المُنشأ حرفيًا: *"Copy your API key now. You won't be able to see it again."* انسخه فورًا — لم ينشر مشروع التوثيق هذا لقطة شاشة لهذا المربع، إذ إنه يعرض بالضرورة سرًا حقيقيًا وحيًا وقابلًا للنسخ.
</Note>

إذا اخترت **Never** كموعد انتهاء صلاحية، يعرض مربع الحوار تحذيرًا كهرمانيًا إضافيًا مفاده أن المفتاح الذي لا ينتهي أبدًا ينبغي التعامل معه بعناية إضافية، لأنه لن يتجدد تلقائيًا من تلقاء نفسه.

## إدارة المفاتيح الحالية

يسرد الجدول كل مفتاح في الحساب: **Name**، وقيمة **API Key** مُخفاة مع أيقونة نسخ إلى الحافظة، و**Created On**، و**Created By**، و**Expires On** (أو "Never"). يظهر تاريخ المفتاح منتهي الصلاحية باللون الأحمر.

<Tip>
  تسمح خطة هذا الحساب بمفتاح **1** واحد فقط في كل مرة — الملاحظة الموجودة مباشرة أسفل رأسية الصفحة ("You can create upto \{limit} API keys") تعكس حصة خطتك المحددة، وليست حدًا على مستوى المنصة بأكملها. إذا كنت على خطة غير محدودة، فلن تظهر هذه الملاحظة إطلاقًا.
</Tip>

## إلغاء مفتاح

اختر أيقونة سلة المهملات في نهاية صف أي مفتاح لفتح لوحة تأكيد تعرض اسم المفتاح وقيمته المُخفاة وشارة Active/Expired وتاريخ الإنشاء. التأكيد يُلغي المفتاح فورًا وبشكل دائم — بما يطابق تمامًا سلوك [نقطة نهاية الإزالة](/ar/api-reference/management-api/tokens/remove): لا توجد حالة "إيقاف مؤقت"، وأي طلب قيد التنفيذ باستخدام ذلك المفتاح يبدأ بالفشل فورًا.

## ذات صلة

* [إنشاء رمز API](/ar/api-reference/management-api/tokens/create) — الصيغة التقنية للطلب/الاستجابة وراء لوحة **Generate API Key** أعلاه.
* [إزالة رمز API](/ar/api-reference/management-api/tokens/remove) — الصيغة التقنية وراء إجراء الإلغاء أعلاه.
* [لوحة استخدام API](/ar/api-keys/usage-dashboard) — أين (وحاليًا، أين لا) يمكنك رؤية مقدار استخدام مفتاح ما.