إشعار
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تسجيل الدخول أو تغيير الدلائل.
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تغيير الدلائل.
ينطبق على: Azure Logic Apps (الاستهلاك + قياسي)
عندما يكون لديك واجهات برمجة تطبيقات ويب أو واجهات برمجة تطبيقات REST موجودة تريد استدعاؤها من مهام سير العمل في Azure Logic Apps، يجب عليك أولا إكمال بعض خطوات الإعداد قبل أن تتمكن من استدعاء واجهات برمجة التطبيقات هذه. في المقام الأول، يجب نشر واجهات برمجة التطبيقات كتطبيقات ويب أو تطبيقات واجهة برمجة التطبيقات. يمكنك تنفيذ هذه المهمة من خلال استضافة واجهات برمجة التطبيقات الخاصة بك على Azure App Service، وهو نظام أساسي سحابي يوفر استضافة واجهة برمجة تطبيقات سهلة وقابلة للتطوير بدرجة كبيرة.
في App Service، يمكنك نشر واجهات برمجة التطبيقات كتطبيقات ويب ولكن ضع في اعتبارك نشر واجهات برمجة التطبيقات كتطبيقات واجهة برمجة تطبيقات بدلا من ذلك. يجعل هذا الأسلوب عملك أسهل عند إنشاء واجهات برمجة التطبيقات واستضافتها واستهلاكها في السحابة وفي البيئات المحلية. لست مضطرا إلى تغيير أي رمز في واجهات برمجة التطبيقات لنشرها في تطبيق واجهة برمجة التطبيقات.
يمكنك استدعاء أي واجهة برمجة تطبيقات من سير عمل ، ولكن للحصول على أفضل تجربة ، أضف بيانات تعريف Swagger إلى تطبيق الويب أو تطبيق واجهة برمجة التطبيقات. يصف مستند Swagger هذا عمليات ومعلمات واجهة برمجة التطبيقات الخاصة بك، مما يساعد مهام سير عمل التطبيق المنطقي على العمل بشكل أفضل وأسهل مع واجهة برمجة التطبيقات الخاصة بك. يجب عليك أيضا إعداد مشاركة الموارد عبر الأصل (CORS) على تطبيق الويب أو تطبيق واجهة برمجة التطبيقات حتى يتمكن سير العمل من الوصول إلى واجهة برمجة التطبيقات الخاصة بك.
يوضح هذا الدليل كيفية إضافة مستند Swagger، وإعداد CORS لتطبيق الويب أو تطبيق واجهة برمجة التطبيقات، وتوفير خيارات لاستدعاء واجهة برمجة التطبيقات الخاصة بك من سير عمل بعد إكمال النشر والاستضافة لواجهة برمجة التطبيقات في App Service.
لمزيد من المعلومات، راجع:
- خدمة تطبيقات Azure
- إنشاء تطبيق ويب ASP.NET ونشره
- إنشاء واجهة برمجة تطبيقات RESTful للمضيف باستخدام CORS في Azure App Service
المتطلبات الأساسية
حساب Azure مع اشتراك نشط. إذا لم يكن لديك اشتراك، فقم بإنشاء حساب مجاني.
واجهة برمجة تطبيقات ويب أو واجهة برمجة تطبيقات REST تتبع أحد الأنماط المتوافقة مع مهام سير العمل في Azure Logic Apps ويتم نشرها في App Service كتطبيق ويب أو تطبيق واجهة برمجة تطبيقات.
لمزيد من المعلومات، راجع:
أضف وصول Swagger و CORS إلى تطبيق الويب أو تطبيق واجهة برمجة التطبيقات
عند إضافة مستند Swagger إلى تطبيق الويب أو تطبيق واجهة برمجة التطبيقات، يمكن لمصمم سير العمل في Azure Logic Apps العثور بسهولة أكبر على العمليات والمعلمات المتوفرة وإظهارها في واجهة برمجة التطبيقات الخاصة بك. يجب عليك أيضا إعداد مشاركة الموارد عبر الأصل (CORS) على تطبيق الويب أو تطبيق واجهة برمجة التطبيقات حتى يتمكن سير العمل من الوصول إلى واجهة برمجة التطبيقات الخاصة بك.
لجعل مستند Swagger قابلا للقراءة من سير العمل في المصمم، على تطبيق الويب أو تطبيق واجهة برمجة التطبيقات، قم بتعيين خصائص تعريف واجهة برمجة التطبيقات والوصول إلى CORS.
في مدخل Microsoft Azure، ابحث عن تطبيق الويب أو مورد تطبيق واجهة برمجة التطبيقات وافتحه.
في الشريط الجانبي لمورد التطبيق، حدد نظرة عامة.
في علامة التبويب خصائص ، ضمن المجالات، من خاصية المجال الافتراضي ، انسخ اسم موقع الويب واحفظه في مكان ما للخطوة التالية.
على الشريط الجانبي لمورد التطبيق، ضمن واجهة برمجة التطبيقات، حدد تعريف واجهة برمجة التطبيقات. بالنسبة إلى الموقع الجغرافي لتعريف واجهة برمجة التطبيقات، أدخل عنوان URL لملف Swagger JSON، والذي يستخدم عادة التنسيق التالي، ولكنه قد يختلف إذا كان ملف Swagger يستخدم مواصفات واجهة برمجة تطبيقات أحدث:
https://<website-name>/swagger/docs/v1يوضح المثال التالي عنوان URL Swagger بمواصفات واجهة برمجة التطبيقات الأحدث:
عندما تنتهي، حدد حفظ.
على الشريط الجانبي لمورد التطبيق، ضمن واجهة برمجة التطبيقات، حدد CORS.
بالنسبة إلى الأصل المسموح به، قم بتعيين سياسة CORS إلى "*"، مما يعني السماح للجميع.
يسمح هذا الإعداد بالطلبات من مصمم سير العمل في Azure Logic Apps.
على شريط الأدوات، حدد حفظ.
لمزيد من المعلومات، راجع استضافة واجهة برمجة تطبيقات RESTful باستخدام CORS في Azure App Service.
استدعاء واجهة برمجة التطبيقات الخاصة بك من سير عملك
بعد إعداد عنوان URL لتعريف واجهة برمجة التطبيقات وCORS، تظهر عمليات واجهة برمجة التطبيقات في معرض الموصل لتجد سير العمل وتضيفه إليه.
لعرض مواقع الويب التي تحتوي على عناوين URL ل OpenAPI، يمكنك تصفح مواقع الويب الخاصة بالاشتراك في مصمم سير العمل.
لعرض الإجراءات والمدخلات المتاحة من خلال الإشارة إلى مستند Swagger ، استخدم مشغل أو إجراء HTTP + Swagger .
لاستدعاء أي واجهة برمجة تطبيقات، بما في ذلك واجهات برمجة التطبيقات التي لا تحتوي على مستند Swagger أو تعرضه، يمكنك دائما إنشاء طلب باستخدام إجراء HTTP.