⚙️ مفاتيح API
أنشئ وأدر مفاتيح API التي تسمح للأنظمة الخارجية (منصات التجارة الإلكترونية، التطبيقات الخارجية) بالوصول إلى كتالوج منتجاتك وبياناتك في LKG for Billing.
انتقل إلى الإدارة ← مفاتيح API (ضمن الإعدادات).
تتطلب إدارة مفاتيح API تفعيل الوصول الخارجي عبر API في الإعدادات.
نظرة عامة
مفاتيح API هي بيانات اعتماد تُخوِّل للتطبيقات الخارجية استدعاء نقاط نهاية API الخاصة بعملك. يمكن تحديد نطاق كل مفتاح للوضع التجريبي أو المباشر، وتحديد معدل استخدامه، وتقييده على أصول محددة.
أعمدة الجدول
| العمود | الوصف |
|---|---|
| الاسم | الاسم المعروض للمفتاح |
| الوضع | تجريبي أو مباشر |
| المفتاح | مفتاح مُخفى — يعرض آخر 4 أحرف فقط (مثال: ••••••••abcd) |
| حد المعدل | الحد الأقصى لطلبات API في الدقيقة |
| الأصول المسموح بها | النطاقات المسموح لها باستخدام هذا المفتاح |
| الحالة | نشط أو غير نشط |
| تاريخ الانتهاء | تاريخ انتهاء صلاحية المفتاح (إن وُجد) |
| الإجراءات | نسخ، إعادة إنشاء، تبديل التفعيل، إبطال |
إنشاء مفتاح API
- انقر على + مفتاح API جديد
- املأ:
| الحقل | مطلوب | الوصف |
|---|---|---|
| الاسم | نعم | تسمية وصفية (مثال: "تكامل Shopify") |
| الوضع | نعم | تجريبي (بيئة اختبار) أو مباشر (إنتاج) |
| حد المعدل | لا | الحد الأقصى للطلبات في الدقيقة (اتركه فارغًا لعدم وجود حد) |
| الأصول المسموح بها | لا | نطاقات مفصولة بفواصل مسموح لها باستخدام هذا المفتاح (مثال: shop.example.com) |
| الوصف | لا | ملاحظات حول استخدام هذا المفتاح |
- انقر على حفظ
- يُعرض المفتاح الكامل مرة واحدة فقط — انسخه فورًا
يُعرض مفتاح API الكامل مرة واحدة فقط عند الإنشاء. إذا فقدته، يجب عليك إعادة إنشاء المفتاح (مما يبطل المفتاح القديم فورًا).
نسخ مفتاح
انقر على أيقونة نسخ في أحد الصفوف لنسخ المفتاح المُخفى. للحصول على المفتاح الكامل مرة أخرى، استخدم إعادة إنشاء.
إعادة إنشاء مفتاح
- انقر على إعادة إنشاء في صف المفتاح
- أكّد — يُبطل المفتاح القديم فورًا
- يُعرض المفتاح الكامل الجديد مرة واحدة — انسخه فورًا
تبديل التفعيل / إلغاء التفعيل
انقر على مفتاح تبديل نشط لتفعيل أو تعطيل مفتاح دون حذفه. تُرفض المفاتيح غير النشطة من قِبل API.
إبطال مفتاح
انقر على إبطال لحذف مفتاح بشكل دائم. لا يمكن التراجع عن هذا الإجراء. أي تكامل يستخدم المفتاح المُبطَل سيفقد الوصول فورًا.
أفضل ممارسات الأمان
- استخدم مفاتيح منفصلة لبيئتي الاختبار والإنتاج
- قيّد الأصول المسموح بها على النطاقات التي تحتاج إلى الوصول فقط
- حدد حدود المعدل لمنع سوء الاستخدام
- بدّل المفاتيح دوريًا باستخدام إعادة إنشاء
- أبطل المفاتيح التي لم تعد قيد الاستخدام