Skip to main content
تغطي هذه الصفحة واجهة لوحة التحكم الخاصة بمفاتيح Management API. للاطلاع على الصيغة التقنية الأساسية، راجع صفحات المرجع التقني: إنشاء رمز API، وإزالة رمز API، ونقاط نهاية الاستخدام.

​
أين تجدها

توجد مفاتيح API في /api/keys، ضمن Developer → API في الشريط الجانبي. هذه هي نفس الصفحة سواء كان لديك صفر مفاتيح أو عدة مفاتيح — الحساب الفارغ يرى شرحًا توضيحيًا بدلًا من جدول فارغ:
صفحة 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

صفحة API Keys، تم التحقق منها مباشرة على حساب لا يملك مفاتيح بعد — لاحظ ملاحظة حصة الخطة مباشرة أسفل رأسية الصفحة

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

​
إنشاء مفتاح

اختر Generate API Key (في الرأسية، أو زر لوحة الحالة الفارغة نفسها) لفتح لوحة الإنشاء:
لوحة Create API Key مع حقل نصي Name (0/100 حرفًا) وقائمة منسدلة Expiration مضبوطة على 'in 1 Month'، مع زرَّي Cancel وCreate

لوحة Create API Key، تم التحقق منها مباشرة

اختيار Create يعرض فورًا قيمة المفتاح الخام في مربع حوار يظهر لمرة واحدة:
يقول مربع حوار المفتاح المُنشأ حرفيًا: “Copy your API key now. You won’t be able to see it again.” انسخه فورًا — لم ينشر مشروع التوثيق هذا لقطة شاشة لهذا المربع، إذ إنه يعرض بالضرورة سرًا حقيقيًا وحيًا وقابلًا للنسخ.
إذا اخترت Never كموعد انتهاء صلاحية، يعرض مربع الحوار تحذيرًا كهرمانيًا إضافيًا مفاده أن المفتاح الذي لا ينتهي أبدًا ينبغي التعامل معه بعناية إضافية، لأنه لن يتجدد تلقائيًا من تلقاء نفسه.

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

يسرد الجدول كل مفتاح في الحساب: Name، وقيمة API Key مُخفاة مع أيقونة نسخ إلى الحافظة، وCreated On، وCreated By، وExpires On (أو “Never”). يظهر تاريخ المفتاح منتهي الصلاحية باللون الأحمر.
تسمح خطة هذا الحساب بمفتاح 1 واحد فقط في كل مرة — الملاحظة الموجودة مباشرة أسفل رأسية الصفحة (“You can create upto {limit} API keys”) تعكس حصة خطتك المحددة، وليست حدًا على مستوى المنصة بأكملها. إذا كنت على خطة غير محدودة، فلن تظهر هذه الملاحظة إطلاقًا.

​
إلغاء مفتاح

اختر أيقونة سلة المهملات في نهاية صف أي مفتاح لفتح لوحة تأكيد تعرض اسم المفتاح وقيمته المُخفاة وشارة Active/Expired وتاريخ الإنشاء. التأكيد يُلغي المفتاح فورًا وبشكل دائم — بما يطابق تمامًا سلوك نقطة نهاية الإزالة: لا توجد حالة “إيقاف مؤقت”، وأي طلب قيد التنفيذ باستخدام ذلك المفتاح يبدأ بالفشل فورًا.

​
ذات صلة

  • إنشاء رمز API — الصيغة التقنية للطلب/الاستجابة وراء لوحة Generate API Key أعلاه.
  • إزالة رمز API — الصيغة التقنية وراء إجراء الإلغاء أعلاه.
  • لوحة استخدام API — أين (وحاليًا، أين لا) يمكنك رؤية مقدار استخدام مفتاح ما.