إدارة مفاتيح API

تتيح لك صفحة API Keys إنشاء وعرض وإدارة المفاتيح التي تستخدمها تطبيقاتك للاتصال بـ FourA API.

عرض مفاتيحك

تعرض الصفحة كل مفتاح يمكنك الوصول إليه: مفاتيحك الشخصية، وكل مفتاح تملكه مؤسسة تنتمي إليها. العضوية هي ما يمنح حق الوصول، لذا يرى العضو العادي مفاتيح المؤسسة أيضًا.

العمود ما يعرضه
Name اسم العرض والوصف، إذا قمت بتحديده
Owner Personal، أو اسم المؤسسة
Key Prefix الأحرف الأولى من المفتاح، متبوعة بقناع (pk_live_a1b2••••••••)، مع زر Reveal، أو أيقونة قفل على المفاتيح القديمة
Status نشط أو غير نشط
Created تاريخ إنشاء المفتاح
Last Used تاريخ آخر request أجراه المفتاح

ابحث بالاسم أو الوصف، وصَفِّ حسب Active أو Inactive، ورتّب حسب Name أو Owner أو Status أو Created أو Last Used. يتنقل اتجاه الترتيب بين تنازلي، تصاعدي، ثم إيقاف الترتيب.

عامل تصفية المالك

إذا كنت تنتمي إلى مؤسسة واحدة على الأقل، فستظهر قائمة Owner المنسدلة بجوار مربع البحث: Everything، أو Personal، أو إدخال واحد لكل مؤسسة. تعمل هذه القائمة على تضييق النطاق لعرض المفاتيح التابعة لهذا المالك، وتتبع أداة التحكم نفسها في صفحات Overview وMetrics وActivity وProxy اختيارك، بحيث تتطابق الصفحات الخمس دائمًا حول حركة المرور التي تشاهدها.

إنشاء مفتاح

انقر فوق Create Key أعلى القائمة (Create API key في الصفحة الفارغة قبل مفتاحك الأول) واملأ ما يلي:

الحقل مطلوب الوصف
Name نعم تسمية وصفية، على سبيل المثال "production-scraper" أو "staging-test"
Description لا ملاحظات حول استخدامات هذا المفتاح
Owner نعم إذا كنت في مؤسسة شخصي، أو أي مؤسسة تنتمي إليها. تظهر أداة الاختيار فقط عندما تنتمي إلى مؤسسة واحدة على الأقل.

يمكن لأي عضو في مؤسسة إنشاء مفتاح تملكه، بغض النظر عن دوره. هذا هو الهدف من الإعداد: يُحسب الاستخدام على مفتاح المؤسسة ضمن فاتورة مالك المؤسسة، لذلك لا يحتاج المطور إلى مفتاح شخصي يفرض رسومًا عليه بدلًا من الشركة.

يظهر المفتاح الكامل مرة واحدة فور إنشائه داخل نافذة مخصصة للنسخ. يمكنك استعادته لاحقًا باستخدام Reveal. تستخدم المفاتيح البادئة pk_live_ وتبدو مثل pk_live_a1b2c3d4e5f6.... ستتلقى بريدًا إلكترونيًا يؤكد إنشاء المفتاح.

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

إظهار المفتاح

انقر فوق أيقونة العين بجوار البادئة المقنعة للمفتاح لرؤية رمزه السري الكامل مجددًا. تطلب منك لوحة التحكم التأكيد، ثم تفتح نافذة تعرض المفتاح الصريح، وزر نسخ، وعدًا تنازليًا قصيرًا. بعد انتهاء العد التنازلي، تحذف النافذة الرمز السري من الصفحة.

يتم تسجيل كل عملية إظهار في سجل التدقيق، لأنها تكشف عن بيانات اعتماد صالحة للاستخدام.

يمكن لأي شخص تتم مشاركة المفتاح معه إظهاره: مالكه الشخصي، أو أي عضو في المؤسسة المالكة له.

المفاتيح القديمة

تُظهر المفاتيح التي تم إنشاؤها قبل إطلاق ميزة الإظهار أيقونة قفل بدلاً من العين، ولا يمكن إظهارها. تم تخزين تجزئتها (hash) فقط، وبالتالي لا يمكن استرداد السر الأصلي. للتبديل من مفتاح قديم، افتح قائمة الإجراءات واختر Regenerate. سيكون السر الجديد قابلاً للإظهار بدءاً من تلك اللحظة.

الصلاحيات المتاحة لكل دور

يمكنك إجراء كل شيء على المفتاح الشخصي. أما بالنسبة لمفتاح المؤسسة، فتُطبق ثلاثة مستويات:

Action Member Admin Owner
استخدام المفتاح وإظهاره نعم نعم نعم
إعادة تسميته وتعديل الوصف نعم نعم نعم
تفعيله أو تعطيله لا نعم نعم
إعادة إنشاء السر لا نعم نعم
حذفه لا نعم نعم
نقله خارج المؤسسة لا لا نعم

يبقى خيارا Disable وEdit في الصف ولكنهما يظهران بلون رمادي مع ملاحظة توضح السبب. لا يظهر Regenerate وTransfer وDelete في القائمة إذا كان دورك لا يتيح استخدامها. ترفض واجهة برمجة التطبيقات (API) الإجراءات ذاتها، وبالتالي لا يمكن لأي تكامل تجاوز الواجهة.

يعتمد هذا التقسيم على تأثير كل إجراء على الأشخاص الذين يشاركون المفتاح. إعادة التسمية إجراء غير ضار. في حين أن إعادة إنشاء السر أو التعطيل يوقفان تكامل كل زميل فور حدوثهما. نقل المفتاح إلى الخارج يزيله من الشركة ويضع استخدامه على خطة الطرف المستلم، لذا فإن هذا الإجراء مخصص للمالك فقط.

تعديل مفتاح

انقر على Edit لتحديث الاسم والوصف. لا يتم تغيير الملكية من خلال نافذة الحوار هذه: استخدم Transfer.

يؤدي النقر على View Metrics في قائمة الإجراءات إلى فتح صفحة Overview بعد تصفيتها وفقاً لذلك المفتاح.

التفعيل وإلغاء التفعيل

استخدم Disable أو Enable في الصف. يؤدي إلغاء تفعيل المفتاح إلى حظر كل request يمر عبر API ويستخدم هذا المفتاح، ويمكنك إعادة تفعيله في أي وقت. يدخل التغيير حيز التنفيذ خلال دقيقة واحدة.

إعادة إنشاء مفتاح

إذا ساورك شك في تعرض أحد المفاتيح للاختراق، فافتح قائمة الإجراءات واختر Regenerate. يؤدي هذا إلى إنشاء سر جديد لنفس معرف المفتاح (key ID). يتوقف السر القديم عن العمل خلال دقيقة واحدة. تظل بقية الإعدادات والاسم والمالك دون أي تغيير.

يظل السر الجديد قابلاً للإظهار بعد إغلاق نافذة الحوار، لذا ليس عليك نسخه بشكل دقيق من المحاولة الأولى.

نقل مفتاح

ينقل خيار Transfer في قائمة الإجراءات المفتاح بين الملكية الشخصية وملكية المؤسسة دون إعادة إنشاء السر. يتم الاحتفاظ بمعرف المفتاح (key ID)، ومقاييسه، وسجل نشاطه. يتغير المالك فقط، ومعه الجهة التي ستتم فوترة الاستخدام عليها.

النقل الصلاحية
مفتاح شخصي إلى مؤسسة أي شخص ينتمي إلى تلك المؤسسة
مفتاح مؤسسة إلى الخارج، لحسابك الشخصي مالك المؤسسة
بين مؤسستين مالك المؤسسة التي يغادرها المفتاح

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

حذف مفتاح

افتح قائمة الإجراءات واختر Delete. حذف مفتاح استخدمته من قبل يؤدي إلى تعطيله: يتوقف المفتاح عن المصادقة ويظل في القائمة بالحالة Inactive، وبذلك يحتفظ سجل Activity وMetrics باسمه. أما المفاتيح التي لم تُستخدم أبدًا، فتُحذف نهائيًا.

ستتلقى بريدًا إلكترونيًا عند حذف مفتاح.

مفاتيح المؤسسة والفوترة

يُحسب الاستخدام على المفتاح المملوك للمؤسسة ضمن خطة مالك المؤسسة، بغض النظر عمن أرسل الـ request. وتحسب صفحة Usage & Limits الخاصة بالمالك هذه المفاتيح إلى جانب مفاتيحه الشخصية وتفصل بينهما.

آخر تحديث: 5 نوفمبر 2026