كشف واجهات برمجة التطبيقات (APIs) من Apache APISIX إلى Power Platform

Apache APISIX بوابة API تمكن المطورين المحترفين من نشر خدماتهم الخلفية كواجهات برمجة تطبيقات (APIs)، ومراقبة استخدامها، وتسهيل تعريض هذه الواجهات لمنصة Power Platform (Power Apps و Power Automate) كوصلات مخصصة لاكتشافها ودمج نقاط نهاية بوابة API في التطبيقات المخصصة دون الحاجة إلى كتابة التعليمات البرمجية من الصفر.

في هذه المقالة، سنوضح لك كيفية إنشاء وصلة مخصصة لبوابة API المفتوحة المصدر Apache APISIX في منصة Power Platform كبديل لـ Azure API Management في حال كنت تقوم ببناء مكونات إضافية لنظام موجود يحتوي على واجهات برمجة تطبيقات قابلة للاستخدام، وتم استضافة بنية النظام الخاصة بك على خوادم محلية أو على مزودي خدمات سحابية أخرى بدلاً من Azure.

أهداف التعلم

ستتعلم ما يلي خلال المقالة:

فوائد دمج Power Apps مع Apache APISIX.
ما هي الوصلة المخصصة؟
إعداد وصلة مخصصة جديدة لبوابة API Apache APISIX في منصة Power Platform.
إنشاء تطبيق جوال Canvas في PowerApps يستخدم الوصلة المخصصة الجديدة.

فوائد دمج Power Apps مع Apache APISIX

يوفر دمج Power Apps مع Apache APISIX العديد من الفوائد للمؤسسات. يمكن لتطبيقات Power Apps الوصول إلى واجهات برمجة التطبيقات الخاصة بك عبر بوابة API، ويمكنك تكوين إعدادات إضافية على APISIX.

فيما يلي بعض هذه الفوائد:

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

ما هي الوصلة المخصصة؟

الوصلة المخصصة في Power Apps هي أداة تسمح للمستخدمين بإنشاء اتصال بين تطبيقهم ومصدر بيانات خارجي أو واجهة برمجة تطبيقات غير مدعومة بشكل أصلي من قبل Power Apps، وفي حالتنا هذه، هي Apache APISIX. توفر الوصلات المخصصة طريقة للمستخدمين للوصول إلى البيانات والخدمات من الأنظمة الخارجية داخل تطبيقهم دون الحاجة إلى كتابة تعليمات برمجية معقدة أو إجراء تكوينات معقدة.

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

إعداد وصلة مخصصة جديدة

لنلقِ نظرة على مثال لتكوين وصلة مخصصة لـ Apache APISIX.

في حالة العرض التوضيحي، سنستفيد من المشروع النموذجي المبنى على ASP.NET Core WEB API مع نقطة نهاية واحدة GET (استرداد قائمة جميع المنتجات) ومشروع Docker لـ Apache APISIX. يمكنك العثور في ملف README على جميع التعليمات حول كيفية تشغيل التطبيق النموذجي.

المتطلبات الأساسية

يجب أن تكون على دراية بالمفاهيم الأساسية لواجهات برمجة التطبيقات.
معرفة أساسية ببعض المفاهيم الأساسية لـ APISIX مثل Route، و Upstream، و Plugin.
تثبيت Docker على جهازك لتشغيل APISIX.
تثبيت APISIX وواجهة برمجة التطبيقات الخلفية للمنتجات باستخدام docker compose.
تكوين الإعدادات الضرورية مثل نقطة نهاية API، و upstream، وقواعد التوجيه. يمكنك اتباع هذا البرنامج التعليمي لإعداد بوابة API APISIX. تأكد من إنشاء Route و upstream ويجب أن تقوم APISIX بتوجيه الطلب إلى واجهة برمجة التطبيقات المستهدفة /api/products.
يتطلب هذا التمرين الوصول إلى وصلات Power Apps المميزة. سجل للحصول على خطة المطور المجانية.

الخطوة 1: بدء معالج الوصلة المخصصة

للبدء، سجل الدخول إلى بوابة Power Apps وانتقل إلى قسم "Connectors". انقر على زر "New custom connector"، ثم اختر "Create new from blank" وقدم اسمًا للوصلة الجديدة.

صورة الوصلة المخصصة الجديدة 1

الخطوة 2: تقديم التفاصيل الأساسية للوصلة

في علامة التبويب "General"، أدخل التفاصيل التالية للوصلة:

اسم الوصلة: أعطِ وصلك اسمًا، مثل "APISIX API Gateway".
الوصف: قدم وصفًا موجزًا للوصلة.
المخطط: تأكد من اختيار المخطط الصحيح، في هذه الحالة، يجب أن نستخدم HTTP، حيث لم نقم بتكوين واجهة برمجة التطبيقات لاستخدام HTTPS.
ضع علامة اختيار على الخيار "Connect via on-premises data gateway". ستحتاج إلى تثبيت بوابة البيانات المحلية على جهاز داخل شبكتك. لأن الوصلة المخصصة لا يمكن أن يكون لديها localhost كاسم مضيف دون استخدام بوابة البيانات المحلية.
عنوان URL الأساسي: أدخل عنوان URL الأساسي لبوابة API Apache APISIX. على سبيل المثال، http://localhost:9080.

صورة الوصلة المخصصة الجديدة 2

الخطوة 3: اختيار نوع المصادقة

بعد ذلك، انتقل إلى علامة التبويب "Security" وقدم تفاصيل المصادقة الضرورية بناءً على نوع المصادقة الذي ستستخدمه الوصلة المخصصة. على سبيل المثال، Basic، أو OAuth2، أو مفتاح API.

الخطوة 4: تعريف نقاط نهاية API

في علامة التبويب "Definition"، يمكنك تعريف نقاط نهاية API التي تريد تعريضها في الوصلة المخصصة. على سبيل المثال، يمكنك تعريف نقطة نهاية لاسترداد قائمة جميع المنتجات من بوابة API.

لتحديد نقطة نهاية، اتبع الخطوات التالية:

الاسم: أدخل اسمًا لنقطة النهاية، مثل "Get Product List".
الملخص: قدم ملخصًا موجزًا لما تفعله نقطة النهاية.
معرف العملية: أدخل معرفًا فريدًا لنقطة النهاية، مثل "GetProducts".
الطريقة: اختر طريقة HTTP التي تستخدمها نقطة النهاية، مثل GET.
URL: أدخل عنوان URL لنقطة نهاية API، مثل /api/products.
الطلب: حدد معلمات الطلب والعناوين التي تتطلبها نقطة النهاية.
الاستجابة: حدد مخطط الاستجابة الذي تعيده نقطة النهاية.

صورة الوصلة المخصصة الجديدة 3

يمكنك تعريف العديد من نقاط النهاية كما تحتاج لوصلتك المخصصة.

الخطوة 5: اختبار الوصلة المخصصة

بمجرد تعريف نقاط النهاية الخاصة بك، يمكنك اختبار الوصلة المخصصة بالنقر على علامة التبويب "Test". هنا، يمكنك إدخال بيانات نموذجية لطلباتك ورؤية الاستجابات التي تعيدها بوابة API.

صورة الوصلة المخصصة الجديدة 4

الخطوة 6: حفظ الوصلة المخصصة

بعد تعريف جميع نقاط النهاية واختبار الوصلة، انقر على زر "Create connector" لحفظ التغييرات.

الوصلة المخصصة لبوابة API Apache APISIX جاهزة الآن للاستخدام في Power Apps. يمكنك استخدامها لبناء تطبيق مخصص في القسم التالي يتفاعل مع نقطة نهاية بوابة API.

صورة الوصلة المخصصة الجديدة 5

إنشاء تطبيق Power جديد

الآن نقوم ببناء تطبيق جوال جديد بصفحة واحدة تسترد قائمة المنتجات من نقطة نهاية بوابة API APISIX باستخدام الوصلة المخصصة التي أنشأناها في القسم السابق.

الخطوة 1: إنشاء تطبيق جديد للمنتجات

للبدء، سجل الدخول إلى بوابة Power Apps وأنشئ تطبيقًا جديدًا عن طريق اختيار "Create an app". اختر خيار "Phone layout" لإنشاء تطبيق جوال وقدم اسمًا لتطبيقك.

الخطوة 2: إضافة مصدر بيانات

في علامة التبويب "Data"، أضف وصلة API Apache APISIX المخصصة كمصدر بيانات. سيسمح ذلك لتطبيقك بالتفاعل مع نقاط نهاية بوابة API المحددة في الوصلة المخصصة.

الخطوة 3: تصميم واجهة المستخدم

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

الخطوة 4: تحديد الإجراءات والمنطق

في علامة التبويب "Action"، حدد الإجراءات التي يجب أن يقوم بها تطبيقك عندما يتفاعل المستخدم مع عناصر التحكم في واجهة المستخدم. على سبيل المثال، يمكنك تحديد إجراء لاسترداد جميع المنتجات من بوابة API الخاصة بك، وعرضها في معرض، وإضافة وظيفة البحث.

صورة تطبيق Power الجديد 1

الخطوة 5: اختبار التطبيق

بمجرد تحديد الإجراءات والمنطق لتطبيقك، يمكنك اختباره بالنقر على زر "Preview". هنا، يمكنك التفاعل مع عناصر التحكم في واجهة المستخدم ورؤية البيانات المستردة من بوابة API.

الخطوة 6: نشر التطبيق

بعد اختبار التطبيق، يمكنك نشره لجعله متاحًا للمستخدمين. يمكنك نشر تطبيقك على منصات مختلفة مثل iOS، وAndroid، وWindows.

الخطوات التالية

في هذه المقالة، تعلمت كيفية وصف API وتحديد وصلة Apache APISIX المخصصة. كما أنشأنا تطبيقًا جوالًا باستخدام Power Apps يستخدم بوابة API مع وصلتها المخصصة. يتم استخدام الوصلة المخصصة بنفس الطريقة التي يتم بها استخدام الوصلات المدارة من قبل Microsoft. وهذا يعني أنه يمكنك الاستفادة من الوصلة في تطبيق Logic، و Power Automate أيضًا. لذا تقدم وجربها، وشاهد كم يمكنك إنجازه باستخدام منصة Power Platform و Apache APISIX.

الموارد ذات الصلة

المحتوى الموصى به

المجتمع

🙋 انضم إلى مجتمع Apache APISIX 🐦 تابعنا على Twitter 📝 ابحث عننا على Slack