توزيع واجهات برمجة التطبيقات المخصصة واستدعاءها من مهام سير العمل في Azure Logic Apps
وينطبق ذلك على: Azure Logic Apps (الاستهلاك)
بعد إنشاء واجهات برمجة التطبيقات الخاصة بك لاستخدامها في مهام سير عمل تطبيق المنطق، تحتاج إلى توزيع برمجة التطبيقات هذه قبل أن تتمكن من الاتصال بها. يمكنك توزيع واجهات برمجة التطبيقات الخاصة بك كتطبيعات ويب، ولكن ضع في اعتبارك توزيع واجهات برمجة التطبيقات الخاصة بك كتطبيعات واجهة برمجة التطبيقات، ما يجعل مهمتك أسهل عند إنشاء واجهات برمجة التطبيقات واستضافتها واستهلاكها في السحابة وفي أماكن العمل. ليس عليك تغيير أي تعليمة برمجية في واجهات برمجة التطبيقات الخاصة بك - ما عليك سوى توزيع التعليمات البرمجية الخاصة بك إلى تطبيق واجهة برمجة التطبيقات. يمكنك استضافة واجهات برمجة التطبيقات الخاصة بك على Azure App Service، وهو عرض نظام أساسي كخدمة (PaaS) يوفر استضافة واجهة برمجة تطبيقات سهلة وقابلة للتطوير بدرجة كبيرة.
على الرغم من أنه يمكنك استدعاء أي واجهة برمجة تطبيقات من سير عمل تطبيق المنطق للحصول على أفضل تجربة، أضف بيانات تعريف Swagger التي تصف عمليات واجهة برمجة التطبيقات ومعلماتها. يساعد مستند Swagger هذا واجهة برمجة التطبيقات على التكامل بمنتهى السهولة والعمل بشكل أفضل مع مهام سر عمل تطبيق المنطق.
توزيع واجهة برمجة التطبيقات الخاصة بك كتطبيق ويب أو تطبيق واجهة برمجة التطبيقات
قبل أن تتمكن من استدعاء واجهة برمجة التطبيقات المخصصة من سير عمل تطبيق المنطق، وزّع واجهة برمجة التطبيقات بصفتها تطبيق ويب أو تطبيق واجهة برمجة التطبيقات إلى Azure App Service. لجعل مستند Swagger قابلًا للقراءة من خلال سير العمل، عيّن خصائص تعريف واجهة برمجة التطبيقات وشغّل مشاركة الموارد عبر المنشأ (CORS) لتطبيق الويب أو تطبيق واجهة برمجة التطبيقات.
في مدخل Azure، حدد تطبيق الويب أو تطبيق واجهة برمجة التطبيقات.
في قائمة التطبيق التي تظهر، ضمن "واجهة برمجة التطبيقات"، حدد "تعريف واجهة برمجة التطبيقات". قم بتعيين موقع تعريف واجهة برمجة التطبيقات إلى عنوان URL لملف swagger.json الخاص بك.
عادة ما يظهر عنوان URL بهذا التنسيق:
https://{name}.azurewebsites.net/swagger/docs/v1)
ضمن "واجهة برمجة التطبيقات"، حدد "CORS". تعيين نهج CORS للأصول المسموح بها إلى '*' (السماح بالكل).
يسمح هذا الإعداد بالطلبات من مُصمم سير العمل.
لمزيد من المعلومات، راجع استضافة RESTful API مع CORS في Azure App Service.
استدعاء واجهة برمجة التطبيقات المخصصة من مهام سير عمل تطبيق المنطق
بعد إعداد خصائص تعريف واجهة برمجة التطبيقات وCORS، يجب أن تكون مشغلات وإجراءات واجهة برمجة التطبيقات المخصصة متوفرة لك لتضمينها في سير عمل تطبيق المنطق.
لعرض مواقع الويب التي تحتوي على عناوين URL لـ OpenAPI، يمكنك تصفح مواقع الويب المشترك بها في مصمم سير العمل.
لعرض الإجراءات والمدخلات المتوفرة عن طريق الإشارة إلى مستند Swagger، استخدم إجراء HTTP + Swagger.
لاستدعاء أي واجهة برمجة تطبيقات، بما في ذلك واجهات برمجة التطبيقات التي لا تحتوي على مستند Swagger أو تعرضه، يمكنك دائمًا إنشاء طلب باستخدام إجراء HTTP.