استيراد SOAP API إلى APIM وتحويلها إلى REST

مقالة
05/21/2024

ينطبق على: جميع مستويات إدارة واجهة برمجة التطبيقات

يوضح هذا المقال كيفية استيراد SOAP API كمواصفات WSDL ثم تحويله إلى REST API. توضح المقالة أيضاً كيفية اختبار واجهة برمجة التطبيقات في APIM.

في هذه المقالة، ستتعرف على كيفية:

استيراد API SOAP وتحويلها إلى REST
حدد التطبيق في مدخل Microsoft Azure

إشعار

يخضع استيراد WSDL إلى APIM لقيود معينة. ملفات WSDL ذات التوجيهات wsdl:import وxsd:import وxsd:include غير مدعومة. للحصول على أداة مفتوحة المصدر لحل هذه التبعيات ودمجها في ملف WSDL، راجع GitHub repo.

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

إتمام التشغيل السريع التالي: إنشاء مثيل في Azure APIM

الانتقال إلى مثيل إدارة واجهة برمجة التطبيقات لديك

في مدخل Microsoft Azure، ابحث عن خدمات APIM وحددها.
في صفحة خدمات إدارة واجهة برمجة التطبيقات، حدد مثيل إدارة واجهة برمجة التطبيقات.

استيراد ونشر واجهة برمجة تطبيقات خلفية

من القائمة اليسرى، ضمن قسم APIs، حدد APIs>+ Add API.
ضمن Create from definition، حدد WSDL.
في مواصفات WSDL، أدخل عنوان URL إلى SOAP API، أو حدد Select a file لتحديد ملف WSDL محلي.
في Import method، حدد SOAP to REST. عند تحديد هذا الخيار، تحاول APIM إجراء تحويل تلقائي بين XML وJavaScript Object Notation. في هذه الحالة، يجب على المستهلكين استدعاء API باعتباره RESTful API، والذي يقوم بإرجاع JSON. تقوم APIM بتحويل كل طلب إلى مكالمة SOAP.
يتم ملء الحقول التالية تلقائياً بالمعلومات من SOAP API: اسم العرض، الاسم، الوصف. تتم تعبئة العمليات تلقائيا باسم العرض وعنوان URL والوصف، وتتلقى اسما تم إنشاؤه بواسطة النظام.
أدخل إعدادات API الأخرى. يمكنك تعيين القيم أثناء الإنشاء أو تهيئتها لاحقاً بالانتقال إلى علامة التبويب Settings.

لمزيد من المعلومات بشأن إعدادات API، راجع استيراد ونشر أول API تعليمي.
حدد إنشاء.

اختبار API الجديد في مدخل Microsoft Azure

يمكن استدعاء العمليات مباشرة من مدخل Microsoft Azure الذي يوفر طريقة ملائمة لعرض واختبار عمليات واجهة برمجة التطبيقات.

تحديد واجهة برمجة التطبيقات التي أنشأتها في الخطوة السابقة.
حدد علامة التبويب الاختبار.
حدد عملية.

تعرض الصفحة حقول معلمات الاستعلام وحقول الرؤوس. أحد الرؤوس هو Ocp-Apim-Subscription-Key، لمفتاح الاشتراك للمنتج المرتبط بواجهة برمجة التطبيقات هذه. إذا قمت بإنشاء مثيل APIM، فأنت مسؤول بالفعل، لذلك يتم ملء المفتاح تلقائياً.
اضغط Send.

عند نجاح الاختبار، تستجيب الواجهة الخلفية بـ 200 OK وبعض البيانات.

إلحاق واجهات برمجة تطبيقات أخرى

يمكنك إنشاء واجهة برمجة تطبيقات من واجهات برمجة التطبيقات التي تعرضها الخدمات المختلفة، وتشمل:

مواصفات OpenAPI
واجهة برمجة تطبيقات SOAP
واجهة برمجة تطبيقات GraphQL
Web App مستضاف في Azure App Service
تطبيق الوظائف Azure
Azure Logic Apps
Azure Service Fabric

إلحاق واجهة برمجة تطبيقات أخرى بتلك الحالية باتباع الخطوات التالية.

إشعار

عند استيراد واجهة برمجة تطبيقات أخرى، يتم إلحاق العمليات بواجهة برمجة التطبيقات الحالية.

انتقل إلى مثيل Azure API Management في مدخل Azure.
حدّد واجهات برمجة التطبيقات في الصفحة نظرة عامة أو من القائمة الموجودة إلى اليمين.
انقر فوق ... بجوار واجهة برمجة التطبيقات التي تريد إلحاق واجهة برمجة تطبيقات أخرى بها.
حدّد استيراد من القائمة المنسدلة.
حدّد خدمة لاستيراد واجهة برمجة تطبيقات منها.