دليل استخدام أدوات المطورين في منصة نمو
يتيح قسم أدوات المطورين في منصة نمو إدارة إعدادات التكامل البرمجي وربط الأنظمة والتطبيقات الخارجية، من خلال واجهة برمجة التطبيقات (API) وتقنية Webhook. يستعرض هذا الدليل الأدوات المتاحة وطريقة استخدامها من لوحة التحكم.
سجّل الدخول إلى لوحة تحكم منصة نمو، ثم انتقل إلى قسم أدوات المطورين. ستجد تبويبَي نمو API وWebhook، بالإضافة إلى زر دليل المطورين أعلى الصفحة.
أولًا: نمو API
يحتوي تبويب نمو API على بيانات الوصول والاتصال البرمجي الخاصة بحساب الجمعية، والتي يحتاجها المطور عند إعداد الربط بين المنصة والأنظمة الخارجية.
رمز الوصول (Token)
رمز الوصول هو المفتاح المستخدم للمصادقة عند استدعاء واجهة برمجة التطبيقات (API). يظهر الرمز مخفيًا بشكل افتراضي لحماية بيانات الحساب.
أدوات إدارة رمز الوصول
تتوفر بجانب رمز الوصول الأدوات التالية:
إظهار الرمز: للاطلاع على قيمة رمز الوصول.
نسخ: لنسخ الرمز واستخدامه ضمن إعدادات التكامل.
إعادة إنشاء الرمز: لإنشاء رمز وصول جديد عند الحاجة، مثل الاشتباه بتسريب الرمز الحالي.
رابط الاتصال (URL)
يعرض هذا الحقل رابط الاتصال الخاص بواجهة المنصة. ويمكن الضغط على زر نسخ للحصول على الرابط واستخدامه عند إعداد الاتصال مع النظام الخارجي.
يجب عدم مشاركة رمز الوصول أو بيانات الاتصال مع جهات غير موثوقة، لأنها بيانات حساسة قد تمنح صلاحيات للوصول إلى حساب الجمعية. وفي حال الاشتباه بتسريب الرمز، يُنصح بإعادة إنشائه ومراجعة التكاملات المرتبطة به.
ثانيًا: Webhook
تُستخدم تقنية Webhook لإرسال إشعارات إلى الأنظمة الخارجية عند وقوع أحداث محددة، وفق الإعدادات التي يتم إنشاؤها داخل المنصة.
الدخول إلى قائمة Webhooks
من قسم أدوات المطورين، اختر تبويب Webhook للاطلاع على قائمة الإعدادات البرمجية المضافة إلى حساب الجمعية.
البيانات الموجودة في القائمة
تعرض قائمة Webhooks المعلومات التالية لكل إعداد:
الاسم: اسم إعداد Webhook.
الحدث (Trigger): الحدث المرتبط بالإعداد.
الإجراءات: الأدوات المتاحة لإدارة الإعداد.
إضافة Webhook جديد
لبدء إضافة إعداد جديد، اضغط على زر إضافة Webhook الموجود أعلى القائمة، ثم أكمل البيانات المطلوبة بحسب الخيارات المتاحة في نموذج الإضافة.
عدم وجود إعدادات سابقة
إذا لم تتم إضافة أي إعداد سابقًا، تظهر رسالة:
يمكنك استخدام زر إضافة Webhook للبدء بإنشاء أول إعداد.
ثالثًا: دليل المطورين والربط التقني
للاطلاع على الشروحات والتعليمات التقنية المتعلقة بأدوات المطورين في منصة نمو، يمكن الضغط على زر دليل المطورين الموجود أعلى القسم.
يُعد دليل المطورين المرجع الأساسي للتفاصيل التقنية اللازمة لربط الأنظمة والتطبيقات الخارجية، بما في ذلك طريقة استخدام واجهة برمجة التطبيقات (API)، وإعداد التكاملات، والتعامل مع Webhooks، وغيرها من المعلومات البرمجية المطلوبة لإتمام عمليات الربط.
تركز هذه المقالة على التعريف بالأدوات والخيارات المتاحة داخل لوحة التحكم، بينما يحتوي دليل المطورين على التفاصيل البرمجية وخطوات الربط والتكامل التقني.