شرح إنشاء وإدارة مفاتيح API في أزير: دليل التكامل البرمجي الآمن

كيفية إنشاء وإدارة مفتاح التكامل البرمجي فى منصة أزير

🔑 إنشاء وإدارة مفتاح التكامل البرمجي (API Keys) في أزير

📹 ملخص الفيديو
في هذا الشرح ستتعرف على معنى مفتاح الـ API وكيف يساعدك في الوصول البرمجي إلى حسابك بأمان، مسار الوصول إلى صفحة API داخل لوحة التحكم، خطوات إنشاء مفتاح جديد (الاسم والصلاحيات)، وكيفية إدارة المفاتيح وحمايتها.

مرحبًا، في هذا الشرح سنتعرّف على ميزة إنشاء واستخدام مفاتيح الـ API في منصة أزير (Azeer)، وكيف تُمكّنك من ربط حسابك بالأنظمة الخارجية والتطبيقات الداخلية بصورة آمنة ومنظّمة.

باستخدام مفاتيح الـ API يستطيع فريقك التقني تنفيذ عمليات آلية مثل جلب البيانات أو تحديثها، بدون الحاجة إلى تسجيل الدخول يدويًا في كل مرة، مع الحفاظ على التحكم في الصلاحيات ومن يمكنه استخدام هذه المفاتيح.

1. مسار الوصول إلى صفحة API

للوصول إلى صفحة إدارة مفاتيح الـ API:

  1. من القائمة الجانبية في لوحة التحكم، انتقل إلى قسم الإعدادات.
  2. من خيارات الإعدادات اختر القسم الخاص بـ Webhooks & API Keys.

ستظهر لك قسم بعنوان API يحتوي على:

  • زر Create API لإنشاء مفتاح جديد.
  • جدول يضم قائمة المفاتيح الحالية (الاسم، المفتاح المخفي، منشأ بواسطة، وتاريخ الإنشاء).

2. ما هو مفتاح الـ API؟

مفتاح الـ API هو رمز سري يُستخدم لتمكين الأنظمة الخارجية أو السكربتات الداخلية من الوصول إلى حسابك برمجيًا عبر نقاط الربط (API Endpoints) الموثوقة.

حالات الاستخدام الشائعة:
  • ربط حسابك بنظام CRM أو نظام تقارير.
  • مزامنة بيانات الطلبات أو المحادثات مع قاعدة بيانات خارجية.
  • بناء تكاملات مخصّصة تشغّل أتمتة معيّنة.

3. إنشاء مفتاح API جديد خطوة بخطوة


1. الإعداد الأولي

انتقل إلى قسم API في الإعدادات واضغط على زر Create API.

2. إدخال الاسم وتحديد الصلاحيات

  • اسم المفتاح (Name): اختر اسمًا واضحًا يعبر عن الغرض (مثل: `integration_crm`).
  • وضع الوصول (Access Mode):
    • Read: للقراءة فقط (مثل التقارير).
    • Read/Write: للقراءة والكتابة (للتعديل وإنشاء البيانات).

3. الحفظ والنسخ

بعد الضغط على Create، سيظهر المفتاح في الجدول. اضغط على رمز العين لعرضه ونسخه ومشاركته بأمان مع الفريق التقني.

4. إدارة المفاتيح وأفضل الممارسات

يمكنك إدارة المفاتيح من الجدول الرئيسي (عرض، حذف). وللحماية القصوى:

  • لا تشارك المفاتيح في قنوات عامة.
  • استخدم وضع Read كلما أمكن لتقليل المخاطر.
  • خصص مفتاحًا منفصلاً لكل نظام خارجي.
  • احذف المفاتيح القديمة أو التي يشتبه في تسربها فورًا.

✨ الخلاصة

ميزة إنشاء واستخدام مفاتيح الـ API في أزير تمنحك طريقة آمنة ومرنة لربط حسابك بالأنظمة الخارجية وبناء تكاملات قوية. من خلال الإدارة الجيدة للصلاحيات والمفاتيح، تضمن استقرار الأتمتة وحماية بياناتك.

❓ الأسئلة الشائعة

س1: هل يمكن استخدام نفس المفتاح لأكثر من نظام؟
تقنيًا نعم، ولكن الأفضل أمنيًا هو تخصيص مفتاح لكل نظام لسهولة الإدارة والإيقاف.
س2: متى أستخدم Read ومتى أستخدم Read/Write؟
Read لعرض البيانات فقط (تقارير)، وRead/Write للتعديل والإضافة.
س3: ماذا أفعل إذا تسرب المفتاح؟
احذفه فورًا من لوحة التحكم وأنشئ مفتاحًا جديدًا وحدثه في الأنظمة المرتبطة.
س4: هل يكفي مفتاح واحد للشركة كلها؟
لا يُنصح بذلك. تعدد المفاتيح يمنحك قدرة أفضل على تتبع مصدر الطلبات والتحكم في الصلاحيات.


    • Related Articles

    • كيفية إنشاء وإدارة القوالب فى منصة أزير

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

    • كيفية إنشاء وإدارة خطافات الويب فى منصة أزير

      ? إنشاء وإدارة Webhooks لربط نظامك بالأنظمة الخارجية ? ملخص الفيديو في هذا الشرح ستتعرف على معنى Webhooks ودورها في ربط نظام أزير بالأنظمة الخارجية، وكيف يمكنك الوصول إلى صفحة الـ Webhooks، إنشاء خطاف جديد خطوة بخطوة (الاسم، الحدث، السياسة، نقطة ...

    • كيفية تفعيل وإدارة السلات المتروكة فى منصة أزير

      ? تفعيل وإدارة السِّلات المتروكة في منصة أزير ? ملخص الفيديو يوضّح الفيديو كيف تفعِّل ميزة تذكير الطلبات غير المكتملة في متجرك الإلكتروني، من خلال ضبط قسم السِّلات المتروكة أو الطلبات المعلَّقة، اختيار القالب المناسب على واتساب، تحديد التوقيت، ثم ...

    • كيفية إنشاء تدفق الواتساب (WhatsApp Flow) فى منصة أزير

      ? كيفية استخدام تدفّق الواتساب (WhatsApp Flow) في منصة أزير ? ملخص الفيديو يشرح هذا الفيديو كيفية الوصول إلى أداة تدفق الواتساب في منصة أزير، واستعراض المتطلبات الأساسية، وخطوات إنشاء تدفق جديد، بالإضافة إلى كيفية ربطه بقالب رسالة لاستخدامه مع ...

    • كيفية إنشاء وإستخدام الردود السريعة فى منصة أزير

      ? ميزة الرسائل السريعة (Quick Replies) في أزير ? ملخص الفيديو يوضح الفيديو كيفية إعداد الرسائل السريعة، بدءًا من الوصول إلى مكتبة الرسائل، إنشاء رسالة جديدة، تحديد صلاحيات استخدامها، ثم استدعائها أثناء المحادثة لرفع سرعة الردود وتحسين تجربة التواصل ...