استيراد SOAP API إلى APIM وتحويلها إلى REST
ينطبق على: جميع مستويات إدارة واجهة برمجة التطبيقات
يوضح هذا المقال كيفية استيراد 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.
حدّد واجهات برمجة التطبيقات في الصفحة نظرة عامة أو من القائمة الموجودة إلى اليمين.
انقر فوق ... بجوار واجهة برمجة التطبيقات التي تريد إلحاق واجهة برمجة تطبيقات أخرى بها.
حدّد استيراد من القائمة المنسدلة.
حدّد خدمة لاستيراد واجهة برمجة تطبيقات منها.
المواضيع ذات الصلة
- قيود استيراد API
- استيراد مواصفة OpenAPI
- استيراد واجهة برمجة تطبيقات SOAP
- استيراد واجهة برمجة تطبيقات SOAP وتحويلها إلى REST
- استيراد واجهة برمجة تطبيقات App Service
- استيراد واجهة برمجة تطبيقات تطبيق حاوية
- استيراد واجهة برمجة تطبيقات WebSocket
- استيراد واجهة برمجة تطبيقات GraphQL
- استيراد مخطط GraphQL وإعداد محللات الحقول
- تشغيل واجهة برمجة تطبيقات دالة Azure
- استيراد تطبيق Azure Logic
- استيراد خدمة Service Fabric
- استيراد واجهة برمجة تطبيقات Azure OpenAI
- استيراد واجهة برمجة تطبيقات OData
- استيراد بيانات التعريف لـ SAP OData
- استيراد واجهة برمجة تطبيقات gRPC
- تحرير واجهة برمجة تطبيقات
الخطوات التالية
الملاحظات
https://aka.ms/ContentUserFeedback.
قريبًا: خلال عام 2024، سنتخلص تدريجيًا من GitHub Issues بوصفها آلية إرسال ملاحظات للمحتوى ونستبدلها بنظام ملاحظات جديد. لمزيد من المعلومات، راجعإرسال الملاحظات وعرضها المتعلقة بـ