كيف تولد مفتاح API لـ ventic؟

يعد مفتاح API ضرورياً لمصادقة الطلبات للدمج مع منصة ventic. هذه المفاتيح فريدة لمؤسستك وتوفر وصولاً آمناً لكتالوج المنتجات وخدمات التجارة الخاصة بك.

إليك كيفية إدارة مفتاح API الخاص بك:

1. الوصول إلى لوحة المطورين

قم بتسجيل الدخول إلى حساب ventic الخاص بك وانتقل إلى قسم Settings > Developers. ستجد هناك علامة تبويب تسمى "API Keys".

2. إنشاء مفتاح جديد

لتوليد مفتاح جديد:

1. انقر على زر “Create API Key”.
2. اسمح للمفتاح باسم وصفي (مثلاً، "Production - Main Store" أو "Testing - Ahmad").
3. اختر نطاق الأذونات (Scopes). نوصي بمنح المفاتيح الأذونات اللازمة فقط (مبدأ الحد الأدنى من الامتيازات).
4. انقر على “Generate”.

3. حفظ المفتاح بأمان

بعد الإنشاء، سيظهر لك المفتاح مرة واحدة فقط.

• هام: انسخ المفتاح واحفظه في مكان آمن (مثل مدير كلمة المرور أو مخزن مفاتيح آمن في نظامك).
• ملاحظة: لأسباب أمنية، لن تعرض ventic المفتاح بالكامل مرة أخرى بعد إغلاق النافذة.

4. استخدام المفتاح في الطلبات

يجب أن تتضمن جميع الطلبات المرسلة إلى واجهة API لـ ventic مفتاح API في ترويسة HTTP X-API-Key.

مثال على الاستخدام مع cURL:

curl -X GET "https://api.ventic.ai/v1/products" \
     -H "X-API-Key: your_api_key_here" \
     -H "Accept: application/json"

5. تدوير المفتاح وإلغاؤه

إذا كنت تشك في تسريب مفتاحك، فيجب عليك إلغاؤه فوراً.

• في لوحة التحكم، اختر المفتاح الذي تريد إزالته وانقر على “Revoke” (إلغاء).
• بعد الإلغاء، سيتم رفض أي طلب يستخدم ذلك المفتاح.
• قم بتوليد مفتاح جديد وتحديث ملف تكوين نظامك.

توصيات أمنية

• لا تنشر أبداً مفاتيح API في الكود المصدري (مثلاً على GitHub). استخدم متغيرات البيئة (environment variables).
• استخدم مفاتيح منفصلة لبيئات الاختبار (Testing) والإنتاج (Production).
• راجع بانتظام قائمة المفاتيح النشطة وأزل تلك التي لم تعد مستخدمة.

إذا كنت بحاجة إلى مساعدة في الدمج، فاتصل بفريقنا التقني على support@ventic.ai.